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

Полный перечень макросов для offer URL, трек-ссылок и исходящих постбеков, а также параметров клика.

Макросы — это подстановки вида {click_id}, которые darkcore заменяет на реальные значения при формировании offer URL, трек-ссылок и исходящих постбеков. Вставляйте их кнопкой выбора макроса в редакторе или вручную.

Основные

Макрос	Значение
`{click_id}`	Идентификатор клика darkcore
`{status}`	Канонический статус конверсии
`{payout}`	Сумма выплаты
`{currency}`	Всегда `USD`
`{timestamp}`	Unix-время клика
`{sub1}` … `{sub10}`	Саб-параметры клика

Click ID рекламных платформ

Макрос	Значение
`{fbclid}`, `{fbp}`, `{fbc}`	Facebook click / browser / cookie id
`{ttclid}`	TikTok click id
`{gclid}`, `{gbraid}`, `{wbraid}`	Google Ads click IDs
`{campaign_id}`, `{campaign_name}`	Кампания
`{adset_id}`, `{ad_id}`	Группа объявлений / объявление

Гео и устройство

Макрос	Значение
`{geo}`	Страна
`{lang}`	Язык
`{timezone}`	Часовой пояс
`{ip}`	IP-адрес
`{os}`, `{os_version}`	Операционная система
`{device}`, `{device_type}`	Устройство / тип устройства
`{browser}`, `{browser_version}`	Браузер
`{user_agent}`	User-Agent

UTM и источник

Макрос	Значение
`{source}`	Источник
`{utm_source}`, `{utm_medium}`, `{utm_campaign}`	UTM
`{utm_content}`, `{utm_term}`	UTM

Push-атрибуция

Макрос	Значение
`{push_id}`, `{push_name}`	Push-кампания
`{is_push}`, `{is_push_sub}`	Признак push-трафика / подписки

Параметры клика

Эти query-параметры darkcore считывает на клике (адрес потока https://ваш-домен.com/?...) и делает доступными в макросах:

Сабы: sub1…sub10
Click id платформ: fbclid, gclid, ttclid, gbraid, wbraid, twclid, rdt_cid, bigo_click_id, kwai_click_id, ysclid, msclkid
Кампания: campaign_id (алиас utm_id), campaign_name (алиас utm_campaign), adset_id, ad_id
UTM: utm_source, utm_medium, utm_campaign, utm_content, utm_term
Override пикселя: fb_pixel, fb_token, tt_pixel, tt_token, pixel_id
Push: push_id, push_name, is_push, is_push_sub

Экранирование подставляется автоматически: в URL значения всегда url-encoded; в теле постбека — по типу (form → url-encode, json → json-safe, text → как есть).