Документация · Трекинг

Макросы и токены для трекинга

Макросы — это токены в фигурных скобках в URL назначения. В момент клика платформа заменяет каждый из них реальным значением, и трекер получает click ID, источник, ГЕО и другие данные как обычные параметры строки запроса. В каждой форме объявления доступные макросы показаны кликабельными чипами под полем Destination URL; клик по чипу добавляет макрос в конец URL.

Пример

https://your-tracker.example/click?cid={tracking}&zone={spaceid}&sub={subid}&geo={country}&dev={device_type}

Справочник макросов

МакросПередаваемое значение
{tracking}Click ID Reacheffect. Обязателен, чтобы конверсии и постбеки привязывались к клику.
{cid}Внешний click ID, полученный при переходе (собственный ID вышестоящей сети). Не ID кампании и не параметр в , который передаёт собственный click ID Reacheffect.
{campaignid}ID кампании.
{adid}ID объявления (креатива).
{campaign_name}Название кампании.
{subid}ID источника трафика, с которого пришёл клик (может передаваться в закодированном виде; стабилен для каждого источника).
{spaceid}ID рекламной зоны (размещения).
{pid}ID аккаунта паблишера.
{domain}Домен, на котором показалось объявление.
{country}Двухбуквенный код страны посетителя.
{region_name}Регион посетителя.
{city_name}Город посетителя.
{device_type}Тип устройства (desktop, mobile, tablet).
{device_name}Название устройства.
{os_name}Операционная система.
{lang}Язык браузера.
{ispid}ID интернет-провайдера.
{bansize}Размер креатива в формате 300x250 (ширина x высота).
{keywords}Совпавшие ключевые слова (редирект-кампании).
{paid}Сколько ты заплатил за этот клик или показ.
{timestamp}Unix-время клика.
{uvid}Уникальный ID посетителя.
{sid1} … {sid10}Десять слотов sub-ID, которые может передавать рекламный тег паблишера; вводятся вручную, чипами не предлагаются.

Примечания

  • Не каждый макрос имеет смысл для каждого формата; несовпавший токен остаётся в URL как есть. Прежде чем масштабироваться, прогони один клик через трекер.
  • {tracking}
  • ID источников могут быть закодированы; закодированное значение стабильно для каждого источника, поэтому вайтлисты и блэклисты, собранные из него, продолжают работать.
  • Те же макросы работают в стороннем URL трекинга показов в объявлении.
Полный гайд — внутри аккаунта.Documentation → Ads & Creatives