Довідник макросів

Повний перелік макросів для 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 → як є).