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

Макросы в URL оффера (подстановка при редиректе)

Указываются в поле url оффера в фигурных скобках, трекер подставляет реальные значения при формировании ссылки редиректа. Значения URL-кодируются — можно не бояться пробелов и спецсимволов в sub-параметрах, трекер сам не сломает URL.

Макрос	Что подставляется
{clickid}	Уникальный ID клика (ULID). Обязателен в ссылке оффера — без него постбек невозможно сматчить с кликом.
{sub1} … {sub10}	Значения sub-параметров клика (см. ниже, как они принимаются на входе).
{geo}	Код страны по GeoIP.
{city}	Город по GeoIP.
{device}	Тип устройства (desktop/mobile/tablet/tv).
{os}	ОС, определённая по User-Agent.
{browser}	Браузер, определённый по User-Agent.
{source}	Источник трафика клика.
{campaign}	Кампания (см. ниже, из каких query-параметров берётся).
{creative}	ID креатива.
{flow}	Идентификатор потока.
{offer}	Идентификатор оффера.
{rnd}	Случайный токен (8 байт в hex) — на случай, если оффер сам не добавляет антикэш-параметр.

Какие параметры трекер принимает во входящей ссылке (/go/{token}, /{token}, /api/click)

Это параметры, которые вы добавляете в трекинговую ссылку своего сайта/кампании — трекер их разбирает и кладёт в клик, откуда они попадают в {sub1}…{sub10} и другие макросы выше, а также в измерения отчётов.

Параметр(ы) ссылки	Куда попадает
sub1…sub10 или короткая форма s1…s10	{sub1}…{sub10}. Явный sub1 имеет приоритет над s1, если переданы оба. Короткая форма s1/s2 — то, что используется в ссылках SEO-сайтов (/go/{flow}?s1={site}&s2={page}).
campaign, utm_campaign или campaign_id	{campaign} (первый непустой из перечисленных, в этом порядке).
adset, adset_id или utm_content	Адсет клика (используется в отчётах, отдельного макроса под адсет в URL оффера нет — берите через sub).
creative, creative_id или utm_term	{creative}.
fp	Fingerprint-значение от JS-пикселя/S2S-вызова (участвует в определении уникальности клика).
site_id	Числовой ID сайта сетки.
landing_id	Числовой ID лендинга.
gclid, fbclid, yclid, ttclid, wbraid, gbraid, msclkid, rb_clickid	Внешний click ID рекламной системы (берётся первый непустой в этом порядке).

Гео/устройство/ОС/браузер в макросы приходят не из параметров ссылки, а вычисляются трекером на лету (GeoIP по IP, разбор User-Agent).

Макросы во входящей ссылке постбека

Постбек-URL, который вы отдаёте партнёрской сети, состоит не из фиксированных макросов {...}, а из имён параметров, которые вы задаёте сами при настройке маппинга эндпоинта (какое имя параметра у сети соответствует нашему clickid/статусу/сумме и т.д.). Сеть сама подставляет в свои макросы (у неё они называются иначе, например {subid} или {click_id}) значение, которое вы передали ей в исходной ссылке оффера как {clickid}.

Типовой пример (эндпоинт с кастомным маппингом clickid/status/sum/txid):

https://<трекер-домен>/pb/{token}?clickid={CLICK_ID}&status={STATUS}&sum={PAYOUT}&txid={TRANSACTION_ID}

где {CLICK_ID}, {STATUS}, {PAYOUT}, {TRANSACTION_ID} — это макросы сети, которые она сама заменит на реальные значения при отправке постбека. Полный список имён параметров, которые понимает эндпоинт, и словарь допустимых значений статуса — в разделе маппинга (Постбеки, готовые пресеты под конкретные сети).

Дальше

Как принимаются постбеки и что означает каждый параметр маппинга — Постбеки. Как создать оффер/поток с этими макросами через API — Быстрый старт, Публичный API.