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 you want to send postbacks for. By default, data will be sent to every offer and campaign.

Specify the conversion status on 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” pair, 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 for the offer.
price - the cost of the conversion.
action_alias - the value of the alias of the action in the payouts for the offer.
network_earn - the amount of network earnings.
status - a conversion status: new (hold), approved (approved) or rejected.
affiliate_earn - the amount of affiliate earnings.
meta - metadata.
merchant_payment - advertiser payout.
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's 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 of the 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?
Cancel
Thank you!