Skip to main content

Advertiser - Postback URL for Advertisers

How to get the postback URL for one advertiser

J
Written by Jorge Rubia

Advertiser Postback URL

For Aftrad to record a conversion, the Advertiser must notify Aftrad when one occurs on their end. This notification is sent via a Postback URL — a URL that the Advertiser calls each time a conversion event takes place, passing back the click_id that Aftrad included in the original click.


How Postback URLs work in Aftrad

Your Aftrad account comes with one default Advertiser Postback URL, but you can create as many as you need. Each Advertiser can then be assigned one or more Postback URLs — giving you full flexibility to organize your tracking across different Advertisers and setups.


Finding and copying your Postback URL

Navigate to Advertisers, click on the Postback URL tab, and click the copy icon to copy it to your clipboard. Share this URL with the Advertiser so they can configure their platform to call it on each conversion.


Postback URL parameters

When the Advertiser calls the Postback URL, they must include certain parameters so Aftrad can correctly attribute the conversion.

Required (one of these must be sent)

  • click_id — the unique click ID that Aftrad passed to the Advertiser in the original click. This is the primary identifier Aftrad uses to attribute the conversion to the correct Offer and Affiliate.

  • aggregate_id — an alternative identifier, used when the Advertiser cannot pass the click_id back individually and needs to report conversions in aggregate.

⚠️ Important: The Advertiser must send either click_id or aggregate_id in every postback. Without one of these, Aftrad cannot attribute the conversion.

Optional parameters

  • event_parameter — the name of the event as defined in the Advertiser's platform (e.g., purchase, install, registration). Must be configured in the Payouts & Events section of the Offer.

  • payout — the amount the Advertiser will pay for this specific conversion. If not sent in the postback, it must be configured in the Payouts & Events section of the Offer.

  • advertiser_id — the ID of the Advertiser. Useful for identifying the source of a postback in cases where the Advertiser sends an incorrect click_id or aggregate_id.

  • custom_amount_1, custom_amount_2 — treated as monetary amounts in Stats. Visible to the Network and Affiliates.

  • custom_count_1, custom_count_2 — treated as counters in Stats. Visible to the Network and Affiliates.

⚠️ Important: Custom parameters are purely informational. They are not linked to Advertiser or Affiliate payouts in any way. For full details and examples, see Advertiser Postback URL – Custom parameters.


Tracker macros reference

Below are ready-to-use Postback URL templates for the most common trackers. Replace yournetwork-advertiser-postback.com with your actual Postback URL.

Affise

https://yournetwork-advertiser-postback.com/api/v1/events?click_id={sub1} &aggregate_id={transactionid} &event_parameter={goal} &payout={sum}

Offer18

https://yournetwork-advertiser-postback.com/api/v1/events?click_id={aff_click_id} &aggregate_id= &event_parameter= &payout={payout}

Swaarm

https://yournetwork-advertiser-postback.com/api/v1/events? click_id=#{click.publisher.clickId} &aggregate_id=#{click.publisher.unique1} &event_parameter=#{eventType.name} &payout=#{payout.theyGetInDollars}

Trackier

https://yournetwork-advertiser-postback.com/api/v1/events?click_id={click_id} &aggregate_id={txn_id} &event_parameter={conversion_id} &payout={payout}

Tune / Hashoffers

https://yournetwork-advertiser-postback.com/api/v1/events?click_id={aff_sub} &aggregate_id={transaction_id} &event_parameter={goal} &payout={amount}

💡 Tip: Don't see your tracker here? The pattern is always the same — map your tracker's macro for the click ID to click_id, and optionally map the transaction ID, event name, and payout amount to the corresponding parameters above.


Related articles

Did this answer your question?