Skip to content

Макросы ​

Макрос — слово в фигурных скобках в ссылке, например {click_id}. Когда пользователь кликает по объявлению, кабинет заменяет макрос значением и только потом открывает вашу страницу. Так в трекер или аналитику попадают ID клика, кампании, источника и данные об устройстве.

Где использовать ​

Макросы работают в двух полях:

  • Конечный URL в настройках кампании;
  • Страница перехода в креативе. Если в креативе отмечено Совпадает с URL в настройках рекламной кампании, используется ссылка кампании.

Под каждым из этих полей есть список Доступные макросы. Клик по макросу вставляет его в поле.

Список макросов ​

МакросЧто подставляетсяПример значенияКогда пусто
{click_id}ID клика: уникальная строка из 36 символов. Её же трекер возвращает в постбэкеСерверное уведомление о конверсии, которое трекер отправляет в кабинет.3f1c9a2e-5b7d-4c1a-9e2f-0a1b2c3d4e5fВсегда заполнен
{campaign}ID кампании1038Всегда заполнен
{creative}ID креатива7712Всегда заполнен
{zone_id}Где был показ: ID источника трафика и ID места размещения у него, через двоеточие. Значение кодируется для ссылки, поэтому двоеточие передаётся как %3A1201%3Aa7f3c9ID места размещения может быть пустым: 1201%3A
{cpc}Стоимость клика в валюте аккаунта, четыре знака после точки. Для Pop с оплатой за показы — цена одного показа0.0500При оплате за показы (CPM) у всех форматов, кроме Pop
{language}Язык пользователя: две строчные латинские буквыdeЯзык не определился
{device}Тип устройства: mobile, tablet, pc, ctv (Smart TV) или botmobileТип не определился
{browser}Браузер: Chrome, ChromeMobile, Safari, Firefox, Edge, Opera, YandexBrowser, SamsungInternet и другиеChromeMobileБраузер не определился
{platform}Операционная система: android, ios, windows, macos, linux или symbianandroidОС не определилась
{random}Случайная строка из 8 символов: латинские буквы, цифры, _ и -. Новая при каждом клике. Помогает обойти кеш трекера. В списке Доступные макросы подписан «Генерация случайного числа», но подставляется именно строкаaZ3_kP9xВсегда заполнен
{sub_age}Только для Push: сколько дней назад пользователь подписался на уведомления120, если источник не передал возраст подписки или формат не 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 и учёт конверсий».
  • В ссылке постбэка макросы кабинета не нужны. Её заполняет трекер своими макросами.

© Youtarget