Skip to content

Affiliate postback setup

An affiliate postback is the URL Integr8 calls on the publisher’s server when a tracked action occurs. You configure one postback per action type (click, conversion, or event) and Integr8 fires it automatically when the condition is met. This guide walks you through creating one and explains the macros and options you can use.

Before you begin

  • Have the publisher’s tracking endpoint URL ready, including the click ID parameter name they expect.
  • Decide the scope: every offer and publisher, a single offer, a single publisher, or a specific combination.
  • Check whether the publisher wants approved conversions only, rejected only, or both.

Create a postback

  1. Go to Postbacks > Postbacks Management and click Create.
  2. Pick the Postback Type: Click, Conversion, or Event.
  3. Enter a Name to identify this postback.
  4. Set the Scope:
    • Toggle Any to apply the postback to all offers and publishers.
    • Or pick a specific offer or publisher from the dropdowns.
  5. Enter the Postback URL, the publisher’s tracking endpoint. Always include the publisher’s click ID: 
    https://publisher-track.com/postback?clickid={external_transaction_id}&status={status}
  6. Map parameters using the macros available in the Add Macros to URL field.
  7. Configure the Firing Status:
    • Any: fires for both approved and rejected conversions.
    • Approved only: fires only on approved conversions. Recommended.
    • Rejected only: fires only on rejected conversions.
  8. Click Save.

Fire only on specific rejection reasons

In the Rejection Reasons section, pick the reasons that should trigger the postback. Other rejection reasons are ignored. Use this to forward chargebacks but not policy violations, for example.

Add a delay

Set a delay if Integr8 should wait for a third-party fraud check (for example, AppsFlyer or an internal validator) before firing. Minimum delay is 2 minutes.

  1. Toggle Enable Delay in the postback settings.
  2. Enter the delay duration and unit: seconds, minutes, or hours.
  3. Click Save.

Macro reference

MacroDescription
{transaction_id}Integr8’s unique click ID
{external_transaction_id}Publisher’s click ID passed via the tracking link
{offer_id}Offer identifier
{publisher_id}Publisher identifier
{sub_id}Sub-publisher ID
{payout}Publisher payout amount
{revenue}Advertiser revenue amount
{currency}Payout currency
{status}Conversion status: approved or rejected
{rejection_reason}Reason code if the conversion is rejected

Next steps