Параметри посилань і макроси в оффер-лінках
Ця сторінка пояснює два пов'язані механізми: які параметри можна додавати до посилання, яким ви ведете трафік на свій PWA, і як ці параметри потім автоматично підставляються в посилання на оффер (рекламодавця).
Як це працює в двох словах
- Ви ведете трафік на свій PWA-домен, додавши до посилання потрібні
параметри (
utm_source,sub_1,sub_2тощо). - Zero PWA запам'ятовує ці параметри за відвідувачем.
- Коли відвідувач переходить далі — на оффер, — система бере URL оффера,
який ви налаштували в PWA, і підставляє в нього значення через
макроси — плейсхолдери виду
{sub_1},{click_id},{country}.
Тобто одні й ті самі мітки, з якими прийшов трафік, автоматично "проїжджають" далі — в лінк на оффер, — і ви бачите їх у постбеках від рекламодавця чи трекера.
1. Параметри в посиланні на PWA
Додайте параметри до посилання на ваш PWA-домен звичайним чином, через
? і &:
https://your-domain.com/?utm_source=facebook&utm_campaign=summer&sub_1=creative123&sub_2=zone55
Які параметри розпізнаються
| Параметр в посиланні | Що це |
|---|---|
utm_id, utm_source, utm_medium, utm_campaign, utm_term, utm_content | Стандартні UTM-мітки |
sub_1 … sub_20 | 20 вільних полів під ваші власні мітки (id креативу, зони, плейсменту тощо). Можна писати і без підкреслення — sub1 теж спрацює, але sub_1 має пріоритет, якщо передані обидва |
sub_product | Окреме поле "продукт"; у макросах на кроці 2 доступне під назвою {product} — саме так, без sub_ |
Будь-який інший параметр теж зберігається — наприклад fbclid,
gclid, ad_id, ad_name, campaign_name, adset_name тощо. Такий
параметр автоматично стає макросом з тією самою назвою (детальніше —
нижче), навіть якщо він не входить у список вище.
:::caution Зарезервовані параметри
Кілька назв параметрів займає сам PWA для внутрішніх потреб — не
використовуйте їх для трекінгу, вони не зберігаються як мітки:
originPackage, parent_pwa, previewlang, platform, version,
pwa_id, lang, src.
:::
Важливо: мітки запам'ятовуються за першим візитом
Параметри зчитуються з посилання при першому заході відвідувача на PWA і закріплюються за ним. Якщо той самий відвідувач пізніше відкриє PWA ще раз за іншим посиланням (без міток або з іншими мітками), для макросів на кроці 2 все одно використовуються значення з першого візиту.
2. Механізм макросів у посиланні на оффер
URL оффера налаштовується в PWA → Settings → Offer — окремий рядок
на кожну країну. Замість того, щоб один раз вписати конкретні значення,
ви вставляєте в URL плейсхолдери у фігурних дужках — {ім'я_макроса}.
При переході відвідувача на оффер система підставляє в них реальні
значення.
Приклад URL оффера:
https://advertiser.com/click?clickid={click_id}&s1={sub_1}&s2={sub_2}&source={utm_source}&geo={country}
Для зручності в редакторі URL є кнопки, які самі підставляють {...} у
потрібне місце — не обов'язково писати фігурні дужки вручну. Доступні
кнопками макроси:
utm_id, utm_source, utm_medium, utm_campaign, utm_term,
utm_content, product, visitor_id, country, sub_1 … sub_20.
Крім них, вручну можна дописати ще два системні макроси, яких немає серед кнопок:
| Макрос | Значення |
|---|---|
{click_id} | Унікальний ID саме цього переходу на оффер — те, що зазвичай очікує рекламодавець/трекер для постбеку |
{ip} | IP-адреса відвідувача |
А також — будь-який довільний параметр, який прийшов у посиланні на
PWA і не входить у список вище (наприклад {fbclid}, {gclid},
{ad_id}): він підставляється макросом з такою самою назвою автоматично,
без додаткового налаштування.
Що відбувається, якщо значення немає
Якщо для макроса немає значення (наприклад, у посиланні на PWA не було
sub_5, а в URL оффера є {sub_5}), плейсхолдер просто підставиться
порожнім рядком — сам URL при цьому не ламається.
Параметри понад ті, що вказані макросами
Якщо в момент переходу на оффер прийшли ще якісь параметри, для яких у
URL оффера немає відповідного {макроса}, вони не губляться — система
додає їх в кінець URL оффера як звичайні ?param=value.
Наскрізний приклад
Посилання на PWA:
https://your-domain.com/?utm_source=facebook&utm_campaign=summer&sub_1=creative123&sub_2=zone55
URL оффера, налаштований в PWA:
https://advertiser.com/click?clickid={click_id}&s1={sub_1}&s2={sub_2}&source={utm_source}&geo={country}
Що піде на рекламодавця, коли відвідувач з України перейде на оффер:
https://advertiser.com/click?clickid=8f3a1c9e...&s1=creative123&s2=zone55&source=facebook&geo=UA