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 |
|---|---|---|
| Number | Event time (timestamp) |
| Number | Session start time - first touch with the user (timestamp) |
| String | The domain through which the event occurred |
| UUID (String) | Unique identifier of the incoming click |
2. User Data (EventUser)
Field | Type | Description |
|---|---|---|
| IPv6 | User's IP address (IPv4 as IPv6-mapped) |
| UInt32 | Autonomous system number (ASN) of the provider |
| String | Name of the provider's organization |
| FixedString(2) | Country code (ISO-3166 Alpha-2: US, GB, DE) |
| String | User's region/state |
| Enum8 | Device type: |
| String | Platform (iOS, Android, Windows, macOS, Linux) |
| String | Operating system |
| String | Operating system version |
| String | Browser (Chrome, Firefox, Safari, Edge) |
| String | Browser version |
| String | Browser language (ISO-639: en, ru, de) |
| String | User-Agent string |
| UInt8 | Proxy usage flag (0 or 1) |
| String | Proxy type (VPN, Proxy, Tor, Direct) |
| String | Proxy usage (corporate, public, unknown) |
| UInt8 | Bot flag (0 or 1) |
3. Campaign Parameters (EventCampaign)
Field | Type | Description |
|---|---|---|
| String | Campaign owner ID (user) |
| String | Team ID |
| String | Campaign ID |
| String | Stream set ID within the campaign |
| String | Traffic source ID |
| String | CPA network ID |
| String | Offer ID |
| String | Flow ID |
| String | Creative ID (optional) |
| String | Progressive Web App ID (if used) |
| String | Landing ID (if used) |
4. UTM Tags and External Parameters (EventUtm)
Field | Type | Description |
|---|---|---|
| String | Traffic source (facebook, google, direct) |
| String | Source campaign ID (e.g., Facebook Profile ID) |
| String | Channel (e.g., Facebook BM Account ID) |
| String | Content (e.g., Facebook Campaign ID) |
| String | Keyword (e.g., Facebook AdSet) |
| String | User parameter 1 (e.g., Facebook Ad ID) |
| String | User parameter 2 |
| String | User parameter 3 |
| String | User parameter 4 |
| String | User parameter 5 |
| String | User parameter 6 |
| String | User parameter 7 |
| String | User parameter 8 |
| String | User parameter 9 |
| String | User parameter 10 |
| String | Click ID from the traffic source (fbclid, gclid) |
5. Buyer
Field | Type | Description |
|---|---|---|
| String | Campaign owner ID (user) equivalent to |
| String | Name of the campaign owner (filled from user profile) |
| String | Email of the campaign owner (filled from user profile) |
| String | Role of the campaign owner (filled from user profile) |
