Макросы
Макрос — слово в фигурных скобках в ссылке, например {click_id}. Когда пользователь кликает по объявлению, кабинет заменяет макрос значением и только потом открывает вашу страницу. Так в трекер или аналитику попадают ID клика, кампании, источника и данные об устройстве.
Где использовать
Макросы работают в двух полях:
- Конечный URL в настройках кампании;
- Страница перехода в креативе. Если в креативе отмечено Совпадает с URL в настройках рекламной кампании, используется ссылка кампании.
Под каждым из этих полей есть список Доступные макросы. Клик по макросу вставляет его в поле.
Список макросов
| Макрос | Что подставляется | Пример значения | Когда пусто |
|---|---|---|---|
{click_id} | ID клика: уникальная строка из 36 символов. Её же трекер возвращает в постбэкеСерверное уведомление о конверсии, которое трекер отправляет в кабинет. | 3f1c9a2e-5b7d-4c1a-9e2f-0a1b2c3d4e5f | Всегда заполнен |
{campaign} | ID кампании | 1038 | Всегда заполнен |
{creative} | ID креатива | 7712 | Всегда заполнен |
{zone_id} | Где был показ: ID источника трафика и ID места размещения у него, через двоеточие. Значение кодируется для ссылки, поэтому двоеточие передаётся как %3A | 1201%3Aa7f3c9 | ID места размещения может быть пустым: 1201%3A |
{cpc} | Стоимость клика в валюте аккаунта, четыре знака после точки. Для Pop с оплатой за показы — цена одного показа | 0.0500 | При оплате за показы (CPM) у всех форматов, кроме Pop |
{language} | Язык пользователя: две строчные латинские буквы | de | Язык не определился |
{device} | Тип устройства: mobile, tablet, pc, ctv (Smart TV) или bot | mobile | Тип не определился |
{browser} | Браузер: Chrome, ChromeMobile, Safari, Firefox, Edge, Opera, YandexBrowser, SamsungInternet и другие | ChromeMobile | Браузер не определился |
{platform} | Операционная система: android, ios, windows, macos, linux или symbian | android | ОС не определилась |
{random} | Случайная строка из 8 символов: латинские буквы, цифры, _ и -. Новая при каждом клике. Помогает обойти кеш трекера. В списке Доступные макросы подписан «Генерация случайного числа», но подставляется именно строка | aZ3_kP9x | Всегда заполнен |
{sub_age} | Только для Push: сколько дней назад пользователь подписался на уведомления | 12 | 0, если источник не передал возраст подписки или формат не Push |
Макрос {sub_age} появляется в списке Доступные макросы только у Push-кампаний и Push-креативов.
Пример
Ссылка в поле Конечный URL:
text
https://example.com/sale?click_id={click_id}&campaign={campaign}&source={zone_id}&os={platform}Так её увидит сайт после клика:
text
https://example.com/sale?click_id=3f1c9a2e-5b7d-4c1a-9e2f-0a1b2c3d4e5f&campaign=1038&source=1201%3Aa7f3c9&os=androidПравила
- Пишите макрос точно как в списке. Регистр важен:
{Click_ID}не заменится. Неизвестный макрос, например с опечаткой, останется в ссылке как есть. - Ставьте макросы в значения параметров после
?и&, как в примере. Значения, кроме{zone_id}и{language}, подставляются без кодирования. - Для учёта конверсий нужен
{click_id}. Трекер должен сохранить его и вернуть в постбэке без изменений. Конверсия засчитывается, если она пришла не позже чем через 60 дней после клика. Подробнее — в инструкции «Настроить postback и учёт конверсий». - В ссылке постбэка макросы кабинета не нужны. Её заполняет трекер своими макросами.