Adset.ProAdset.ProKnowledge base
Home/Tracker/Macros (placeholders)

Macros (placeholders)

Macros are special placeholders (variables) in links and settings that are automatically replaced with real values at the moment of redirecting the user to the target CPA Offer page (Flow).

Why they are needed:

  • to pass parameters (campaign, clickId, placement, cost, etc.);
  • to link events (click → lead/purchase) and correctly attribute the source;
  • to create dynamic links without manual editing for each ad.

Example: in the link there is {event.event_click_id} or {event.ext_sub1} — when clicked, the tracker replaces these macros with the actual event values.

Available several groups of macros:

  • Event and traffic parameters ({event.*})
  • Buyer parameters ({user.*})

1. Basic Event Fields

Field

Type

Description

{event.event_time}

Number

Event time (timestamp)

{event.event_session}

Number

Session start time - first touch with the user (timestamp)

{event.event_domain}

String

The domain through which the event occurred

{event.event_click_id}

UUID (String)

Unique identifier of the incoming click

2. User Data (EventUser)

Field

Type

Description

{event.user_ip}

IPv6

User's IP address (IPv4 as IPv6-mapped)

{event.user_asn}

UInt32

Autonomous system number (ASN) of the provider

{event.user_asn_org}

String

Name of the provider's organization

{event.user_country}

FixedString(2)

Country code (ISO-3166 Alpha-2: US, GB, DE)

{event.user_region}

String

User's region/state

{event.user_device}

Enum8

Device type: tv, desktop, mobile, tablet

{event.user_platform}

String

Platform (iOS, Android, Windows, macOS, Linux)

{event.user_os}

String

Operating system

{event.user_os_ver}

String

Operating system version

{event.user_browser}

String

Browser (Chrome, Firefox, Safari, Edge)

{event.user_browser_ver}

String

Browser version

{event.user_lang}

String

Browser language (ISO-639: en, ru, de)

{event.user_ua}

String

User-Agent string

{event.user_proxy}

UInt8

Proxy usage flag (0 or 1)

{event.user_proxy_type}

String

Proxy type (VPN, Proxy, Tor, Direct)

{event.user_proxy_usage}

String

Proxy usage (corporate, public, unknown)

{event.user_bot}

UInt8

Bot flag (0 or 1)

3. Campaign Parameters (EventCampaign)

Field

Type

Description

{event.cmp_user}

String

Campaign owner ID (user)

{event.cmp_team}

String

Team ID

{event.cmp_campaign}

String

Campaign ID

{event.cmp_set}

String

Stream set ID within the campaign

{event.cmp_source}

String

Traffic source ID

{event.cmp_cpa}

String

CPA network ID

{event.cmp_offer}

String

Offer ID

{event.cmp_flow}

String

Flow ID

{event.cmp_creative}

String

Creative ID (optional)

{event.cmp_pwa}

String

Progressive Web App ID (if used)

{event.cmp_landing}

String

Landing ID (if used)

4. UTM Tags and External Parameters (EventUtm)

Field

Type

Description

{event.ext_utm_source}

String

Traffic source (facebook, google, direct)

{event.ext_utm_campaign}

String

Source campaign ID (e.g., Facebook Profile ID)

{event.ext_utm_medium}

String

Channel (e.g., Facebook BM Account ID)

{event.ext_utm_content}

String

Content (e.g., Facebook Campaign ID)

{event.ext_utm_term}

String

Keyword (e.g., Facebook AdSet)

{event.ext_sub1}

String

User parameter 1 (e.g., Facebook Ad ID)

{event.ext_sub2}

String

User parameter 2

{event.ext_sub3}

String

User parameter 3

{event.ext_sub4}

String

User parameter 4

{event.ext_sub5}

String

User parameter 5

{event.ext_sub6}

String

User parameter 6

{event.ext_sub7}

String

User parameter 7

{event.ext_sub8}

String

User parameter 8

{event.ext_sub9}

String

User parameter 9

{event.ext_sub10}

String

User parameter 10

{event.ext_click_id}

String

Click ID from the traffic source (fbclid, gclid)

5. Buyer

Field

Type

Description

{user._id}

String

Campaign owner ID (user) equivalent to {event.cmp_user}

{user.name}

String

Name of the campaign owner (filled from user profile)

{user.email}

String

Email of the campaign owner (filled from user profile)

{user.role}

String

Role of the campaign owner (filled from user profile)