What are the available tokens? | Adsterra Help Center

In this article, you will find all the useful macros for your URL to pass data to your tracking tool for further analysis and optimization of your campaigns.

Please keep in mind that “##” is the part of the macro, it's what makes the macro dynamic. So don’t miss it when you are adding macros to your tracking system.

Here is the list of the most popular ones:

##SUB_ID_SHORT(action)## — Click ID. This one is a must-have when you are launching a performance basis campaign.

##PLACEMENT_ID## — ID of the actual source.

##CAMPAIGN_ID## — ID of your campaign at Adsterra’s platform.
##ADVERTISER_ID## — Advertiser ID on the Adsterra platform

##USER_OS## — Operation System on the user’s device.

##USER_CARRIER## — ISP

##USER_OS_VER## — User's operating system version
##LANDING_ID## — Landing page ID

##CAMPAIGN_NAME## — the name of your campaign on the Adsterra platform

##PUBLISHER_ID## — Publisher ID

##ZONE_ID## — Publisher's site ID

##REMOTE_COUNTRY## — full name of Country

##REMOTE_LANGUAGE_CODE## — user’s browser language

##BANNER_ID## — ID of Banner/Creative. This one is handy when you run a campaign with Native Banners or Social bar ad units. With the macro added to the link, you can check performance for all of your creatives on the campaign.

##BROWSER_NAME## — User’s browser

##DEVICE_BRAND## — the brand of the user's device

##DEVICE_MODEL## — the model of the user's device

These you can use for passing your spending to your tracking system:

##COST_CPM## — for CPM based campaigns

##COST_CPA## — for performance based campaigns

##COST_CPC## — for CPC based campaigns

Also, there are a few other macros for advanced analysis:

##COUNTRY_CODE## — 2symbols Country Code (ISO 3166-1 alpha-2)

##COUNTRY_CODE_A3## — 3symbols Country Code ( ISO 3166-1 alpha-3 )

##REMOTE_IP## — User's IP

##USER_CITY## — User's city based on IP address

##USERAGENT## — encoded user-agent

##USERAGENT_DEC## — not encoded user-agent

##TIMESTAMP## — ad display time ( in Unix timestamp format )

##RANDOM_ID## — random ID for RTB integration

If you still have questions or don’t quite understand how all this may be useful for your particular campaign then feel free to reach our support team for getting sound advice on its use.