Publisher Postback
- Veronika (Unlicensed)
- Iain McNally (Unlicensed)
- Irina Khanumyan
The postback function is designed to notify publishers about the creation of new conversions and changes to the status of existing ones, so that they can synchronize data between their and ours platforms.
The postback is an HTTP request to the specific URL where could be set different query parameters with appropriate values that reflect conversion attributes.
A publisher can request adding Postback per offer and/or Globally. Once the request is approved they will start receiving HTTP requests on the set URLs.
We send 1 postback per conversion.
Postback Values
Our platform supports many of the possible macros that can be passed back to the publisher to maintain a highly transparent transaction between you and the publisher’s tracking system. The macros used are always contained between curly brackets “{}” and include underscores. Here is the complete list of macros that the platform supports:
Parameters:
Token | Description |
|---|---|
{adv_id} | User ID of the advertiser for which campaign is running (alias to {advertiser_id}) |
{advertiser_id} | User ID of the advertiser for which campaign is running |
{aff_id} | User ID of the publisher (alias to {publisher_id}) |
{aff_name} | Name of Publisher running the Campaign (alias to {publisher_name}) |
{aff_username} | Username of Publisher running the Campaign (alias to {publisher_username}) |
{agent} | User Agent on which the Click event occurred |
{campaign_id} | Offer ID (alias to {offer_id}) |
{campaign_title} | Title of Offer (alias to {offer_title}) |
{click_id} | Click ID generated by tracker |
{click_time} | Timestamp for the Click event |
{conversion_date} | Conversion Date. Format YYYY-MM-DD (+8 timezone) |
{conversion_datetime} | Conversion Date and Time. Format YYYY-MM-DD HH:mm:ss (+8 timezone) |
{conversion_id} | Conversion ID of the record of any Conversion, Sale, Goal etc. |
{conversion_time} | Conversion Time. Format HH:mm:ss (+8 timezone) |
{country_id} | 2 Digit Country ID / Country Code |
{currency} | Conversion currency |
{ip} | Click IP of User |
{offer_id} | Offer ID |
{p1} | Custom parameter, sub ID 1 |
{p2} | Custom parameter, sub ID 2 |
{p3} | Custom parameter, sub ID 3 |
{p4} | Custom parameter, sub ID 4 |
{payout} | Specified payout for publisher, in conversion currency |
{payout_usd} | Specified payout for publisher, in USD |
{publisher_id} | User ID of the publisher (hash) |
{publisher_name} | Name of Publisher running the Campaign |
{publisher_username} | Username of Publisher running the Campaign |
{random} | 7-15 Digit number randomly selected |
{referer} | Referring Domian for the Click Event |
{sale_amount} | Amount of generated sale (on conversion), in conversion currency. Not always available! |
{sale_amount_usd} | Amount of generated sale (on conversion), in USD. Not always available! |
{status} | Conversion status |
{sub1} | Tracking parameter which was appended to conversion by advertiser |
{sub2} | Tracking parameter which was appended to conversion by advertiser |
{sub3} | Tracking parameter which was appended to conversion by advertiser |
{sub4} | Tracking parameter which was appended to conversion by advertiser |
{txn_id} | Unique Transaction ID |
How to Test Postback
Under the “Account” menu, there is a “Postback” sub-menu that will open the Global Postback page
In the postback URL field, you can enter the URL that you would like to test.
There are several available tokens that you can add to your postback URL.
There are several available tokens that you can add to your postback URL and they are listed under the postback URL field.
Once you have done adding the postback URL, click on the “Test” button at the bottom of the section to send the postback URL to the desired site. Once the request has been sent, you can check it.