Key Parameters for Setting Up Advertiser Postback

Overview

Advertiser postback allows the advertiser’s server to send conversion data directly to Trackier via a postback URL, ensuring accurate and server-side attribution.

To correctly track conversions, certain parameters (macros) must be passed in the postback URL. These parameters help Trackier identify the click, conversion details, and payout information.

Note: Postback (Server-to-Server): A postback is a method where conversion data is sent directly from the advertiser’s server to Trackier’s server without relying on the user’s browser, ensuring accurate and reliable tracking.

What is a Parameter?

A parameter is a dynamic value added to a URL that passes specific information from one system to another. In postbacks, parameters carry details such as click ID, revenue, or conversion status, enabling accurate tracking and attribution.

Parameters For Advertiser Postback URL

Here you will find the list of parameters that Trackier supports for advertiser S2S integration. For each parameter, place the appropriate advertiser macro to get the required information.

Parameter Reference

Below is a structured list of parameters used in advertiser postbacks along with their descriptions:

Parameter	Description
click_id	Ask the advertiser to pass their click ID macro mapped to this parameter for accurate attribution.
txn_id	Unique ID generated by the advertiser for each sale or registration (also called order ID or lead ID).
sale_amount	Sale value received from the advertiser; used to calculate payout and revenue in CPS campaigns.
goal_value	Represents the conversion event; create a goal and map it to this parameter.
sub1 – sub15	Open/custom parameters to capture additional data from the advertiser’s end.
revenue	Used to receive dynamic payout from the advertiser.
currency	Currency of the payout sent by the advertiser.
status	Conversion status (e.g., approved, pending, rejected).
goal_id	Unique ID assigned to a specific goal.
security_token	Unique key used to authenticate and secure conversions.
device_id	Unique identifier for the user’s device.
gaid	Google Advertising ID (for Android devices).
idfa	Apple Identifier for Advertising (for iOS devices).
product_sku	Unique SKU assigned to a product for inventory and tracking.
product_id	Unique ID for the product in the system.
product_name	Official name of the product.
product_brand	Brand name of the product.
product_cat	Category of the product.
user_id	Unique ID for the user.
coupon_code	Discount code applied by the user during purchase.
country_code	2-letter country code to identify the user’s location.

Note:

To use status in the postback:

Approved
Cancelled
Rejected
Pending

You can ask the advertiser to send us the status based on the conversion they have recorded. So, for example, if the conversion is pending on their end, they will fire a postback with &status=pending.

Required & Common Parameters

1. Click ID (`click_id`)

Unique identifier for each click
Used to match the conversion with the original click
Mandatory for attribution

2. Transaction ID (`txn_id`)

Unique ID generated by the advertiser
Helps avoid duplicate conversions

3. Goal Value (`goal_value`)

Represents the conversion event (e.g., install, signup, purchase)
Used for event-based tracking

4. Sale Amount (`sale_amount`)

Total transaction value
Used in CPS campaigns

5. Revenue (`revenue`)

Dynamic payout sent by advertiser
Helps calculate earnings in real time

6. Currency (`currency`)

Defines payout currency (e.g., USD, INR)

7. Status (`status`)

Conversion status (approved, pending, rejected)

8. Sub Parameters (`sub1` – `sub10`)

Custom parameters for additional data

Where to Find Advertiser Postback

You can find the Advertiser Postback section by navigating to:

Campaigns → Open Campaign → Conversion Tracking → Postback URL Section.

You can get Advertiser server postback as per a campaign or as per an advertiser on the subsequent information page:

In the campaign: Open the particular campaign you have created, scroll down at the bottom right, and you will find the Conversion Tracking card.
In Advertiser: Open Advertiser from the menu on the left, then click Manage and choose an Advertiser. The postback URL is located on the right-hand side.

Both of them are the same; whichever is more convenient, you can use them.

We have chosen an example from a campaign:

Learn the Key Parameters for Setting Up Advertiser Postback

We have chosen an example from an advertiser's page:

Advertiser Postback URL

For the Default goal: It can be anything which you are going to track first for the user, eg: Install, registration, etc.

https://demo.vnative.co/acquisition?click_id={ADVERTISER_CLICK_ID_MACRO}&security_token=bxxxxxxxxxx3 &txn_id={ADVERTISER_MACRO_FOR_TXN_ID}&sub1={MACRO__ADV}

For any subsequent goal: It is for subsequent events that take place after the default goal, For example, if the default goal is install then the subsequent goal could be registration, purchase, deposit, etc.

https://demo.vnative.co/acquisition?click_id={ADVERTISER_CLICK_ID_MACRO}&security_token=bxxxxxxxxxxxxxxxxxx3&goal_value=register&txn_id={ADVERTISER_MACRO_FOR_TXN_ID}&sale_amount={ADVERTISER_SALE_AMOUNT_MACRO}&sub1={MACRO__ADV}

*Here, you need to ask the advertiser to place their macro against Trackier's parameter.

Advertiser iframe/image Pixel

For the Default goal: It can be anything which you are going to track first for the user, eg: Install, registration, etc.

*Here, you need to ask the advertiser to place their macro against Trackier's parameter.

Pro Tip:

Trackier Parameter = {Advertiser_macro}
You need to ask the advertiser to place their macro
To verify in Tracking URL, let's say advertiser click id is going in parameter aff_sub, then in
- In the tracking link, it will be &aff_sub={click_id}
- In the postback URL, it will be click_id={aff_sub}
Use Server Postback when the advertiser is using some tracking network, and Pixel when it is a direct advertiser/brand without any tracking platform.

If our postback URL has been put on the advertiser's end and you are still unable to track conversions, please follow these troubleshooting instructions.

For additional parameters

Summary

These parameters enable accurate server-to-server conversion tracking, ensuring proper attribution, detailed reporting, and correct payout calculations within Trackier.

We're thrilled to have put together a top-notch team of qualified experts who are available to handle any of your concerns and respond to any inquiries you may have. You can contact us at any time by sending an email to support@trackier.com or using the in-platform chat feature.

Boost Attribution Accuracy via Segment Trackier Integration

Locate and Access an Advertiser’s Postback in Trackier

Advertiser Server Postback Integration

List of Macros in Trackier

Quick Guide: Setting Up Publisher & Advertiser Postback