Skip to content

Macros

Placeholders expanded in destination URLs and postbacks.

2 min read

Browse documentation

Macros are placeholders in curly braces that ArcTrack replaces with real values. They work in offer destination URLs, fallback URLs and transparent url= values (click macros), and in partner postback URLs and bodies (click and conversion macros). Unknown macros are left untouched, and names are case-insensitive.

Click macros#

MacroValue
{click_id}The click ID (32 hex characters)
{transaction_id}Same as {click_id}
{offer_id} / {offer_code} / {offer_name}The offer
{aff_id} / {affiliate_id} / {aff_code}The partner
{advertiser_id}The advertiser
{sub1} … {sub5}Sub-IDs from the link
{source_id}Source ID from the link
{gclid} / {fbclid}Ad-platform click IDs
{country} / {region} / {city}Approximate location from the IP address
{device} / {os} / {browser}From the user agent
{ip} / {user_agent}The visitor's IP address and user agent
{timestamp}Unix time in seconds
{date}Date in UTC, YYYY-MM-DD
{random}A random number
{ext_campaign_id} / {ext_adgroup_id} / {ext_ad_id} / {ext_keyword}Ad-platform campaign, ad group, ad and keyword

Conversion macros (postbacks only)#

MacroValue
{conversion_id}Conversion ID
{event} / {event_name}Event code and name
{payout}Partner payout
{revenue}Revenue
{sale_amount}Sale amount reported by the advertiser
{currency}Currency code
{status}approved, pending or rejected
{adv_txid}Advertiser transaction ID
{conversion_ts} / {click_ts}Conversion and click time
{adv1} … {adv5}Values the advertiser sent

Encoding#

  • In URLs values are percent-encoded, so a sub-ID containing & cannot break the URL.
  • In POST bodies values are JSON-escaped when the body starts with {, otherwise form-encoded.

Example#

Destination URL:

URL
https://shop.example.com/?clickid={click_id}&src={source_id}&c={country}

After a click from Germany with source_id=blog-7:

URL
https://shop.example.com/?clickid=01928f7c3a2b4e5d6f708192a3b4c5d6&src=blog-7&c=DE
PreviousTracking linksNext Conversions & postbacks
Something unclear or missing on this page?Tell us

Ready to send your first click?

Create a workspace, add a tracking domain and copy your first link — the guides above walk you through every step.

Contact salesBook a demo