Tracking macros

Use supported, case-sensitive placeholders in click and tracking URLs.

Campaign and cost

  • {CAMPAIGN} — campaign ID; {BANNER} / {AD_ID} — creative ID.
  • {ADVERTISER} — advertiser ID; {AD_WIDTH} / {AD_HEIGHT} — creative dimensions.
  • {COST} / {VALUE} — reported cost value in USD; interpret it with the campaign pricing model.

Source and click identification

  • {CLICK_ID} — unique click ID required for conversion postbacks.
  • {TRAFFIC_SOURCE} — analytics-safe publisher domain.
  • {SSP} / {SSP_ID}, {SUB_SSP}, {PUB}, {SITE_ID} — source and publisher identifiers.
  • {TRACKING_ID}, {TIMESTAMP} — tracking identifier and time.

Destination and request data

  • {LANDING_PAGE} / {LANDING_PAGE_ENC} — destination and encoded destination.
  • {CLICK_URL} / {CLICK_URL_ENC}, {IMP_URL}, {IMP_PIXEL}, {THIRD_URL} — tracking URLs or pixel values.
  • {COUNTRY} — ISO3 country; {IP}, {OS}, {REFERRER}, {REFERRER_DOMAIN} — request data.

Native and video

  • {TITLE}, {DESCRIPTION} — native text.
  • {VAST_START}, {VAST_FIRST_QUARTILE}, {VAST_MIDPOINT}, {VAST_THIRD_QUARTILE}, {VAST_COMPLETE}, {VAST_VERSION} — video events and version.

Validate replacements

Copy macros from the console and preserve capitalization. Test a real click to confirm expansion. Example: https://tracker.example/click?click_id={CLICK_ID}&campaign={CAMPAIGN}&source={SITE_ID}&cost={COST}. Only pass personal data when necessary and lawful.