General information

Postbacks are a mechanism that allows you to transfer data from HOQU to a third-party service. A postback is a URL link with a set of parameters (macros), through which information on your conversions is transmitted from HOQU to you.

How to set up postbacks?

Go to Integration -> Postbacks

To create a new postback, click the Add Postback button.

The page for setting up a new postback will open.

Fill in the basic data section.
Choose which offers and campaigns to send postbacks for. By default, data will be sent to every offer and campaign.

Specify the conversion status with which postbacks will be sent: new, approved or rejected. By default, it is selected for conversions with all statuses.

Select the type of request: GET (data transfer in the form of “name-value” pairs, via a link) or POST (data transfer in the body of the request).

Postback URL: The URL where the request with the conversion data will be sent to.

Next, select the required macros - conversion data that will be sent to the URL you specified. HOQU supports the following macros:

conversion_uuid - the universally unique identifier for the conversion.
click_id - the id of the conversion click.
conversion_id - the ID of the conversion in HOQU.
rate_id - the payout rate identifier in HOQU.
action - the value of the action in the rates section of the offer.
price - the cost of the conversion.
action_alias - the value of the alias of the action in the payouts for the offer.
payment - the advertiser's payment.
status - a conversion status: new (hold), approved (approved), or rejected.
meta - metadata.
timestamp - redirect time.
network_id - the identifier of the network in HOQU.
offer_id - the offer ID in HOQU.
promo_id - the identifier of a promo material in HOQU.
campaign_id - the ID of the campaign in HOQU.
affiliate_id - the affiliate ID in HOQU.
advertiser_id - the advertiser ID in HOQU.
currency - the value of the currency in the conversion.
ip - the user IP address.
country - the user country (A2 ISO code).
user_agent - the value of the UserAgent of the user.
time_zone - the timezone value.
referrer - the referrer URL (if available).
traffic_source - the source of traffic by conversion.
utm_source - the utm tag of the traffic source.
utm_campaign - the campaign utm label.
utm_term - the utm term label.
utm-content - the utm content label.
utm-medium - the utm medium label.
subid1 - subid6 - subaccounts.

Further, if necessary, fill in additional custom fields.

Below, in the Generated link form, the value of the link will be indicated, based on the settings you made.

To create a postback, click the Add button. The new postback will appear on the postback page.

To edit or disable / activate a postback, click on the three dots in front of the desired postback. By default, the newly created postback is disabled.

After activating postbacks, the data for the macros you selected will be transmitted to the specified URL.

Information on the transmitted data can be tracked on the Outgoing Postbacks page.

Was this article helpful?
Thank you!