Тokens
Tracking traffic often requires transferring click data from the tracker to an external recipient: to a landing page, to a partner network, to a traffic source. This task can be solved using tokens.
For example, if you want to pass the IP value of the click to the offer network, you can use the token {ip}. To pass a token to the offer link, simply select the token you need from the list in the offer settings and substitute it into the GET parameter of the offer:
After that, the tracker will automatically substitute the value of the click IP into the offer link and you can use it in the partner network.
Token list
| Token | Description |
|---|---|
| {clickid} | ID of the click |
| {affiliate_network_id} | ID of the Aff. network |
| {affiliate_network_name} | Name of the Aff. network |
| {browser_name} | Browser name |
| {browser_version} | Browser version |
| {campaign_group_id} | Campaign group ID |
| {campaign_group_name} | Campaign group name |
| {campaign_id}, {campaign} | Campaign ID |
| {campaign_key} | Campaign key |
| {campaign_name} | Campaign name |
| {city} | City |
| {clickcost} | Cost of the click |
| {continent} | Continent |
| {continent_code} | Continent code |
| {country} | Country |
| {country_code} | Country code |
| {date} | Date of click |
| {device_brand} | Device brand |
| {device_model} | Device model |
| {device_name} | Device name |
| {device_type} | Device type |
| {campaign_domain}, {domain} | The domain in the campaign settings |
| {cnv_status}, {status} | Conversions status |
| {cnv_status2}, {status2} | Conversion status2 |
| {cnv_currecny} | Payour currency |
| {event1}, {event2} ... {event30} | Number of event |
| {externalid} | Traffic source token External ID |
| {ip} | IP of the click |
| {isp} | Internet provider |
| {landing_id}, {lander} | Landing ID |
| {landing_name} | Landing name |
| {landing_number} | Number of landing in Path |
| {language} | Browser language |
| {lp_key} | LP key |
| {offer_id} | Offer ID |
| {offer_link} | Link to offer |
| {offer_name} | Offer name |
| {offer_number} | Number of offer in Path |
| {os_name} | OS |
| {os_version} | OS version |
| {path_name} | Name of Path in campaign |
| {path_number} | Number of Path in campaign |
| {payout} | Overall payout sum |
| {postback_payout} | Payout included in the latest postback |
| {redirect_time} | Redirect time |
| {referer} | Referer |
| {ref_domain} | Domain of the referer |
| {real_domain} | Domain that was used in the campaign link |
| {region} | Region |
| {region_code} | Region code |
| {revenue} | Counts the reveune with formula: payout - cost. |
| {rule_name} | Name of the Rule in Campaign |
| {resolution} | Device resolution |
| {state} | State\Province |
| {state_code} | State\Province code |
| {t1}, {t2}, {t3} ... {t30} | Tokens of the Traffic source |
| {traffic_source_id}, {trafficsource} | Traffic source ID |
| {traffic_source_name}, {trafficsource_name} | Traffic source name |
| {uclick} | Identifier of a unique visitor |
| {unixtime} | Current time in Unix format |
| {unixconversiontime} | Date of the conversion creation in Unix format |
| {user_agent} | User-agent |
| {week} | Number of the week when click was created |
| {owner_id}, {user_id} | Campaign owner ID |
| {owner_name}, {user_name} | Campaign offer name |
Tokens on an integrated landing page
To display the value of a token on an integrated landing page, simply add the token to the HTML page of your landing page. For example, if you want to display the user's country, you can use the following code:
<p>Special offer for users from {country}!</p>
Tokens on a regular landing page
To display a token on a regular landing page, you will first need to pass that token in the landing page link:
Next, add the following code to the landing page to display the value of the token:
Special offer for users from <span id="paramValue"></span>!
<script>
const urlParams = new URLSearchParams(window.location.search);
const value = urlParams.get('country');
const paramValueElement = document.getElementById('paramValue');
paramValueElement.textContent = value;
</script>
Tokens on a landing page with an LP pixel
The setup for displaying tokens on a landing page with an LP pixel is similar to the setup for a regular landing page, with the only difference being that the value of the token cannot be obtained directly from the GET parameter, so you need to use similar code:
<script>
BPixelJS.useTokens(function (tokens) {
document.getElementById('country').textContent = tokens.country;
})
</script>
Special offer for users from <span id="country"></span>!