Adset.ProAdset.ProKnowledge base
RUEN
To app
Home/Трекер/Макроси (placeholders)

Макроси (placeholders)

Макроси - це спеціальні плейсхолдери (змінні) в посиланнях і налаштуваннях, які автоматично замінюються реальними значеннями в момент перенаправлення користувача на цільову сторінку CPA-офера (Flow).

Навіщо потрібні:

  • передавати параметри (campaign, clickId, placement, cost і т. п.);

  • пов'язувати подію (клік → лід/покупка) і правильно атрибутувати джерело;

  • робити динамічні посилання без ручного редагування під кожне оголошення.

Приклад: в посиланні стоїть {event.event_click_id} або {event.ext_sub1} — при кліку трекер замінює дані макроси на реальні значення події.

Доступні кілька груп макросів:

  • Параметри події і трафіку ({event.*})

  • Параметри баєра ({user.*})

1. Базові поля події

Поле

Тип

Опис

{event.event_time}

Number

Час події (timestamp)

{event.event_session}

Number

Час початку сесії - першого дотику з користувачем (timestamp)

{event.event_domain}

String

Домен, через який пройшла подія

{event.event_click_id}

UUID (String)

Унікальний ідентифікатор вхідного кліка

2. Дані користувача (EventUser)

Поле

Тип

Опис

{event.user_ip}

IPv6

IP-адреса користувача (IPv4 як IPv6-mapped)

{event.user_asn}

UInt32

Номер автономної системи (ASN) провайдера

{event.user_asn_org}

String

Назва організації провайдера

{event.user_country}

FixedString(2)

Код країни (ISO-3166 Alpha-2: US, GB, DE)

{event.user_region}

String

Регіон/штат користувача

{event.user_device}

Enum8

Тип пристрою: tv, desktop, mobile, tablet

{event.user_platform}

String

Платформа (iOS, Android, Windows, macOS, Linux)

{event.user_os}

String

Операційна система

{event.user_os_ver}

String

Версія операційної системи

{event.user_browser}

String

Браузер (Chrome, Firefox, Safari, Edge)

{event.user_browser_ver}

String

Версія браузера

{event.user_lang}

String

Мова браузера (ISO-639: en, ru, de)

{event.user_ua}

String

User-Agent рядок

{event.user_proxy}

UInt8

Ознака використання проксі (0 або 1)

{event.user_proxy_type}

String

Тип проксі (VPN, Proxy, Tor, Direct)

{event.user_proxy_usage}

String

Використання проксі (corporate, public, unknown)

{event.user_bot}

UInt8

Ознака бота (0 або 1)

3. Параметри кампанії (EventCampaign)

Поле

Тип

Опис

{event.cmp_user}

String

ID власника кампанії (користувач)

{event.cmp_team}

String

ID команди

{event.cmp_campaign}

String

ID кампанії

{event.cmp_set}

String

ID стрім-сета всередині кампанії

{event.cmp_source}

String

ID джерела трафіку

{event.cmp_cpa}

String

ID CPA-мережі

{event.cmp_offer}

String

ID офера

{event.cmp_flow}

String

ID потоку (Flow)

{event.cmp_creative}

String

ID креативу (опціонально)

{event.cmp_pwa}

String

ID Progressive Web App (якщо використовується)

{event.cmp_landing}

String

ID лендингу (якщо використовується)

4. UTM-мітки та зовнішні параметри (EventUtm)

Поле

Тип

Опис

{event.ext_utm_source}

String

Джерело трафіку (facebook, google, direct)

{event.ext_utm_campaign}

String

ID кампанії джерела (наприклад, Facebook Profile ID)

{event.ext_utm_medium}

String

Канал (наприклад, Facebook BM Account ID)

{event.ext_utm_content}

String

Контент (наприклад, Facebook Campaign ID)

{event.ext_utm_term}

String

Ключове слово (наприклад, Facebook AdSet)

{event.ext_sub1}

String

Користувацький параметр 1 (наприклад, Facebook Ad ID)

{event.ext_sub2}

String

Користувацький параметр 2

{event.ext_sub3}

String

Користувацький параметр 3

{event.ext_sub4}

String

Користувацький параметр 4

{event.ext_sub5}

String

Користувацький параметр 5

{event.ext_sub6}

String

Користувацький параметр 6

{event.ext_sub7}

String

Користувацький параметр 7

{event.ext_sub8}

String

Користувацький параметр 8

{event.ext_sub9}

String

Користувацький параметр 9

{event.ext_sub10}

String

Користувацький параметр 10

{event.ext_click_id}

String

Click ID від джерела трафіку (fbclid, gclid)

5. Buyer

Поле

Тип

Опис

{user._id}

String

ID власника кампанії (користувач) еквівалентно {event.cmp_user}

{user.name}

String

Ім'я власника кампанії (заповнюється з профілю користувача)

{user.email}

String

Email власника кампанії (заповнюється з профілю користувача)

{user.role}

String

Роль власника кампанії (заповнюється з профілю користувача)