Adset.ProAdset.ProKnowledge base
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

Роль владельца кампании (заполняется из профиля пользователя)