Postback Parameters for Tracking
What is a Postback?
APostback URLs are essential for tracking user activity and conversions within a performance marketing environment. This document explains the various parameters used in postback URLs and tracking links, detailing each element's function and how it is utilized.
Key Terms
Postback URL: A URL used by the advertiser to send conversion data back to the tracking platform.
Tracking Link: A link that directs traffic to the advertiser's site while keeping track of user activity.
Parameters
Below is a table that lists the most common parameters used in postback URLs and tracking links, along with explanations of what each represents:
Parameter
Description
{offer_id}
The unique ID of the offer being tracked.
{payout}
The monetary value of the conversion or payout.
{status}
The status of the conversion (e.g., pending, approved, rejected).
{event}
The type of event being tracked (e.g., click, install, registration).
{ip}
The IP address of the user making the conversion or event.
{browser}
The browser used by the user during the event.
{sub1} - {sub5}
Custom sub-IDs used for additional tracking purposes (e.g., campaign ID, publisher ID).
{click_id}
A unique identifier for the click that initiated the conversion.
{device_model}
The specific model of the device used by the user.
{device_type}
The type of device used (e.g., mobile, desktop).
{device_vendor}
The manufacturer of the user's device.
{browser_name}
The name of the browser used (e.g., Chrome, Safari).
{browser_version}
The specific version of the browser.
{platform_name}
The operating system of the device (e.g., Windows, iOS, Android).
{platform_version}
The version of the operating system.
{continent}
The continent where the event took place.
{country}
The country of the user.
{state}
The state or region of the user.
{city}
The city of the user.
{isp}
The internet service provider used by the user.
{source}
The traffic source that directed the user to the offer.
{user_agent}
The full user agent string of the user's browser or device.
{event_name}
The name of the event triggered by the user.
{event_slug}
A short code representing the event.
{player_id}
The unique ID assigned to the user or player in the system.
{player_internal_id}
An internal identifier used for tracking the user within the platform.
{player_name}
The user's name.
{player_email}
The user's email address.
{player_username}
The user's username within the platform.
{player_phone}
The user's phone number.
{click_datetime}
The date and time when the click occurred.
{conversion_datetime}
The date and time when the conversion took place.
{reward_amount}
The amount of any reward given to the user for the event or conversion.
Usage Example
A typical postback URL might look something like this:
https://yourdomain.com/postback?offer_id={offer_id}&click_id={click_id}&payout={payout}&status={status}&event={event}&ip={ip}&country={country}&device_type={device_type}This URL allows the tracking system to record essential data points like the offer ID, click ID, payout, event type, and user's location, helping advertisers and publishers optimize their campaigns.
For any further details or questions, feel free to reach out to the support team
Last updated