Skip to main content

Advertiser Postback URL – Custom parameters

How to use the custom parameters for Advertiser postback URL

J
Written by Jorge Rubia

The Advertiser Postback URL supports four optional custom parameters that allow the Advertiser to pass additional data alongside each conversion. This data is purely informational — it has no effect on payouts — but it is visible in Stats for both the Network and Affiliates, making it useful for tracking supplementary metrics like revenue amounts or event counts.

Available custom parameters

  • custom_amount_1, custom_amount_2 (optional) — treated as monetary amounts in Stats. Use these to pass financial values such as sale amounts or revenue figures sent by the Advertiser.

  • custom_count_1, custom_count_2 (optional) — treated as counters in Stats. Use these to pass numeric counts such as items purchased or actions completed.

⚠️ Important: Custom parameters are purely informational. They are not linked to Advertiser or Affiliate payouts in any way.


How they appear in Stats

Custom parameters are aggregated across all events. In Network Stats and Affiliate Stats, you will see the sum of each parameter across the selected time period.

Example — the Advertiser sends two events:

Event 1:

https://yourpostbackurl.com/api/v1/events?click_id=2093Zi9LW1SA2prjQ7Mk8BzFWNaqgSuDoYpGMbgAXifis1VmSVa5yju7jHrh5KpgQhACjmeG
&custom_amount_1=1
&custom_amount_2=2
&custom_count_1=3
&custom_count_2=4

Event 2:

https://yourpostbackurl.com/api/v1/events?click_id=2093ST4pznBCNNBsnGBpezmWgxgZBfMVGPtp7czfuxGxJrPJYCLvCHRf9e6Zcybb3FvYACBz
&custom_amount_1=10
&custom_amount_2=20
&custom_count_1=30
&custom_count_2=40

In Stats, you will see the sum of both events: custom_amount_1 = 11, custom_amount_2 = 22, custom_count_1 = 33, custom_count_2 = 44.


Forwarding custom parameters to Affiliates

Custom parameters can also be included in the Affiliate's postback URL, so Affiliates receive this data alongside the standard conversion notification. To set this up, add the corresponding macros to the Affiliate's postback URL configuration.


Related articles

Did this answer your question?