Макросы рекламных платформ
Полный справочник динамических параметров и макросов для 12 рекламных платформ — используйте в UTM-метках, трекинговых пикселях и VAST-ссылках.
Что такое макросы? Макросы (динамические параметры) — специальные подстановки, которые рекламная платформа автоматически заменяет на реальные значения при показе или клике. Например,
{keyword} в Яндекс.Директ заменится на ключевое слово, по которому был сделан клик. Используйте их в UTM-параметрах для детальной аналитики.
Яндекс.Директ
{ad_id} / {banner_id}ID объявленияЧисловой идентификатор объявления
{campaign_id}ID кампанииЧисловой идентификатор рекламной кампании
{campaign_name}Название кампанииНазвание кампании, до 255 символов
{campaign_name_lat}Название кампании латиницейТранслитерированное название кампании латиницей, до 255 символов
{campaign_type}Тип кампанииtype1 — Единая перфоманс-кампания; type6 — Баннер на поиске
{creative_id}ID креативаИдентификатор креатива из конструктора
{gbid}ID группы объявленийЧисловой идентификатор группы объявлений
{keyword}Ключевая фразаКлючевая фраза, по которой показано объявление (без минус-слов)
{phrase_id}ID ключевой фразыИдентификатор ключевой фразы для текстово-графических объявлений
{match_type}Тип соответствияrm — автотаргетинг; syn — семантическое соответствие
{matched_keyword}Подобранная фразаПодобранная фраза (используйте вместе с {match_type})
{adtarget_name}Условие нацеливанияНазвание условия нацеливания
{adtarget_id}ID условия нацеливанияЧисловой идентификатор условия нацеливания
{retargeting_id}ID ретаргетингаИдентификатор условия нацеливания на аудиторию
{coef_goal_context_id}ID корректировки ставокИдентификатор корректировки ставок для условия ретаргетинга
{position}Позиция объявленияНомер позиции в блоке; 0 — объявление показано в сетях (используйте вместе с {position_type})
{position_type}Тип блокаpremium — премиум-показы; dynamic_places — динамические места; other — блок справа/внизу; none — показ в сетях
{source}Место показаДомен площадки при показе в сетях; none — при показе на поиске Яндекса
{source_type}Тип площадкиsearch — поиск; context — сети (РСЯ)
{device_type}Тип устройстваdesktop — десктоп; mobile — мобильный; tablet — планшет
{region_name}РегионНазвание региона, в котором было показано объявление
{region_id}ID регионаЧисловой идентификатор региона показа
{yclid}Яндекс Click IDИдентификатор клика для отслеживания источника трафика и импорта конверсий
myTarget
{{advertiser_id}}ID рекламодателяИдентификатор рекламодателя
{{campaign_id}}ID кампанииИдентификатор рекламной кампании
{{campaign_name}}Название кампанииНазвание рекламной кампании
{{banner_id}}ID баннераИдентификатор баннера/объявления
{{geo}}РегионID региона по геодереву myTarget, из которого был сделан переход
{{gender}}ПолПол пользователя, который сделал переход
{{age}}ВозрастВозраст пользователя, который сделал переход
{{random}}Случайное числоСлучайное число. Пример: http://tag.com?rnd={{random}}
{{impression_weekday}}День недели показаДень недели показа баннера. Пример: mon, tue, sat
{{impression_hour}}Час показаЧас показа по московскому времени в 24-часовом формате. Пример: 01, 11, 22
{{user_timezone}}Часовой пояс пользователяВременная зона пользователя. Пример: +3
{{search_phrase}}Поисковая фразаПоисковая фраза пользователя, которому был сделан показ
VK Ads
{{advertiser_id}}ID рекламодателяИдентификатор рекламодателя
{{ad_plan_id}}ID кампанииИдентификатор рекламной кампании
{{ad_plan_name}}Название кампанииНазвание рекламной кампании
{{campaign_id}} / {{ad_group_id}}ID группы объявленийИдентификатор группы объявлений (оба макроса эквивалентны)
{{campaign_name}} / {{ad_group_name}}Название группы объявленийНазвание группы объявлений (оба макроса эквивалентны)
{{banner_id}}ID баннераИдентификатор баннера/объявления
{{geo}}РегионID региона по геодереву VK
{{gender}}ПолПол пользователя, который сделал переход
{{age}}ВозрастВозраст пользователя, который сделал переход
{{random}}Случайное числоСлучайное число. Пример: https://tag.com?rnd={{random}}
{{impression_weekday}}День недели показаДень недели показа баннера. Пример: mon, tue, sat
{{impression_hour}}Час показаЧас показа по московскому времени в 24-часовом формате. Пример: 01, 11, 22
{{user_timezone}}Часовой пояс пользователяВременная зона пользователя. Пример: +3
{{search_phrase}}Поисковая фразаПоисковая фраза пользователя, которому был сделан показ
Google Ad Manager
Макросы для сторонних креативов и тегов VAST в Google Ad Manager (DFP). Регистр важен: %%CACHEBUSTER%%, а не %%Cachebuster%%.
Визуализация и рендеринг
%%ADUNIT%%Рекламный блокВставляет путь к рекламному блоку из исходного запроса объявления
%%DEST_URL_UNESC%%Целевой URL (без экранирования)URL перехода по клику — без экранирования
%%DEST_URL_ESC%%Целевой URL (1× экранирование)URL перехода по клику — с однократным экранированием
%%DEST_URL_ESC_ESC%%Целевой URL (2× экранирование)URL перехода по клику — с двойным экранированием
%%HEIGHT%% / %%WIDTH%%Высота и ширинаРазмеры целевого рекламного блока из настроек Ad Manager
%%PATTERN:key%%Значение по шаблонуПередаёт пользовательские переменные и пары ключ-значение в креатив
%%PATTERN:TARGETINGMAP%%Карта таргетингаДинамически создаёт теги возврата из настроек таргетинга
%%PATTERN:url%%URL ссылающейся страницыПодставляет URL реферера
%%TAG_PARAM%%Параметр тегаПередаёт значения параметров тега объявления (correlator, scor, pod, vpos и др.)
%%TARGET_IN_NEW_WINDOW%%Открыть в новом окне1 — если задан _blank; 0 — в остальных случаях
%%TARGET_WINDOW%%Целевое окноДанные целевого окна (_top, _blank и т.д.) рекламного блока
%%TFCD%%Тег контента для детей1 — детский контент; 0 — другой контент (COPPA)
[%URI_ENCODE:variable%]URI-кодировка переменнойКорректно кодирует пробелы и спецсимволы переменных шаблона для URL (только в шаблонах)
Отслеживание
%%CACHEBUSTER%%Cache-busting (случайное число)Случайное число для предотвращения кеширования. Одинаковое для всех событий одного VAST-креатива
%%CLICK_URL_UNESC%%URL клика (без экранирования)URL отслеживания кликов — используйте в начале анкера:
<a href="%%CLICK_URL_UNESC%%http://...">%%CLICK_URL_ESC%%URL клика (1× экранирование)URL отслеживания кликов — используйте когда счётчик является параметром другого URL
%%CLICK_URL_ESC_ESC%%URL клика (2× экранирование)URL отслеживания кликов с двойным экранированием
%eaid!ID позицииИдентификатор позиции (Line Item)
%eadv!ID рекламодателяИдентификатор рекламодателя, чья позиция показывается
%ebuy!ID заказаИдентификатор заказа (Order)
%ecid!ID креативаИдентификатор креатива
%eenv!Средаi — iframe; j — JavaScript
%epid!ID рекламного блокаИдентификатор рекламного блока, в котором показывается позиция
%esid!ID блока верхнего уровняID рекламного блока верхнего уровня (устаревший)
%%ADVERTISING_IDENTIFIER_PLAIN%%ID устройстваСбрасываемый рекламный идентификатор устройства (IDFA/GAID) — формат 8-4-4-4-12
%%ADVERTISING_IDENTIFIER_TYPE%%Тип ID устройстваТип идентификатора устройства
%%ADVERTISING_IDENTIFIER_IS_LAT%%Ограничение отслеживанияПараметр LAT (Limit Ad Tracking) устройства
%%PREVIEW_MODE%%Режим предпросмотраtrue — предварительный просмотр; false — обычный показ
%%SCHEME%%Схема протоколаhttp: или https: в зависимости от протокола страницы
%%SITE%%СайтДомен параметра URL из тега объявлений
%%VIEW_URL_UNESC%%URL просмотра (без экранирования)Регистрирует показ при скачивании креатива — только для внестраничных креативов
%%VIEW_URL_ESC%%URL просмотра (1× экранирование)Регистрирует показ — экранированный вариант
%%FILE:file_display_name%%Файловый серверЗаменяется полным URL загруженного объекта (изображения и т.п.) по его имени в Ad Manager
GDPR / TCF 2.0
${GDPR}GDPR статус0 — регион вне GDPR; 1 — регион под GDPR
${GDPR_CONSENT_XXXX}Строка TC (TCF 2.0)Строка Transparency & Consent Framework. XXXX — числовой ID поставщика из IAB GVL
${ADDTL_CONSENT}Дополнительное согласиеСтрока дополнительного согласия (Additional Consent Mode)
%%TFUA%%Несовершеннолетние ЕЭЗПомечает запрос для пользователей ЕЭЗ/Великобритании, не достигших возраста согласия
Видео
%%VIDEO_AD_DURATION_SECONDS%%Длительность видео (сек)Продолжительность видеообъявления в секундах
%%VIDEO_AD_DURATION%%Длительность видео (мс)Продолжительность видеообъявления в миллисекундах
%%DESCRIPTION_URL_UNESC%%URL описания видеоURL из параметра description_url тега GPT — без экранирования
%%DESCRIPTION_URL_ESC%%URL описания видео (1× enc)URL описания видео — с однократным экранированием (для вставки в другой URL)
%%REFERRER_URL_UNESC%%URL видеоплеераURL страницы с видеоплеером — без экранирования
%%REFERRER_URL_ESC%%URL видеоплеера (1× enc)URL страницы с видеоплеером — с экранированием
Видеоконтент (только Ad Manager 360)
%%VIDEO_DURATION%%Длительность видео (мс)Продолжительность видеоконтента в миллисекундах
%%VIDEO_ID%%ID видеоУникальный идентификатор видео из CMS
%%VIDEO_METADATA:key%%Метаданные видеоМетаданные видеоресурса по ключу (пары ключ-значение из вкладки "Видео")
%%VIDEO_TITLE%%Название видеоНазвание видео из Ad Manager
%%CMS_ID%%ID источника контентаУникальный числовой ID источника контента для таргетинга видеорекламы
%%FW_CAID%%Специальный ID (FreeWheel)Специальный идентификатор объявления для FreeWheel
%%IAB_CATEGORIES%%Категории IAB (FreeWheel)Рекламные категории IAB, разделённые запятыми — для издателей FreeWheel
Facebook Ads
{{campaign.id}}ID кампанииИдентификатор рекламной кампании Facebook
{{campaign.name}}Название кампанииНазвание рекламной кампании
{{adset.id}}ID группы объявленийИдентификатор группы объявлений (AdSet)
{{adset.name}}Название группыНазвание группы объявлений
{{ad.id}}ID объявленияИдентификатор конкретного объявления
{{ad.name}}Название объявленияНазвание объявления
{{placement}}ПлейсментМесто размещения объявления (feed, stories, reels и т.д.)
{{site_source_name}}Источникfb — Facebook, ig — Instagram, msg — Messenger, an — Audience Network
DV360 (Display & Video 360)
Макросы для сторонних медийных тегов и тегов VAST. Не поддерживаются в объявлениях YouTube и динамических креативах на основе данных.
Показ объявлений
${CACHEBUSTER}Cache-bustingСлучайное число для предотвращения кеширования
${CLICK_URL}URL кликаURL отслеживания кликов DV360
${CLICK_URL_ENC}URL клика (1× enc)URL отслеживания кликов — однократное кодирование
${CLICK_URL_ENC_ENC}URL клика (2× enc)URL отслеживания кликов — двойное кодирование
${CLICK_POINTROLL}URL клика для PointRollURL отслеживания кликов для тегов PointRoll (закодированный)
${DC_DBM_TOKEN}DBM токенПредотвращает двойной учёт показов при использовании тегов в контейнере
${GEO_DMA}DMA-код местоположенияТрёхзначный код медиарынка Nielsen. "Не указано" — если местоположение неизвестно
${GEO_POSTAL_CODE}Почтовый индексСемизначный ID критерия местоположения (почтовые индексы США и Канады не передаются)
${ifdbm:value}Источник динамического креативаВставляет значение при показе объявления через DV360 (для динамических креативов GMC)
${IMPRESSION_ID}ID показаЗакодированный идентификатор события показа в системе DV360
Аукцион
${ADSTXT_AD_SYSTEM_DOMAIN}Домен рекламного сервисаДомен рекламного сервиса из ads.txt. Пустая строка если ads.txt отсутствует
${ADSXT_PUBLISHER_ID}ID издателя (ads.txt)ID издателя из запроса ставки — используйте вместе с ${ADSTXT_AD_SYSTEM_DOMAIN}
${AUCTION_ID}ID аукционаУникальный идентификатор аукциона. Аналог CACHEBUSTER/TIMESTAMP
${BUNDLE_ID}Bundle ID приложенияID приложения из запроса ставки (com.foo.mygame для Android, числа для iOS)
${CAMPAIGN_ID}ID позицииИдентификатор позиции (Line Item), выполняющей показ
${CREATIVE_ID}ID креативаИдентификатор показанного креатива
${EXCHANGE_ID}ID биржиИдентификатор аукциона (биржи) из запроса ставки
${INSERTION_ORDER_ID}ID заказа на размещениеИдентификатор Insertion Order показа
${INVENTORY_SOURCE_EXTERNAL_ID}ID сделкиИдентификатор PMP-сделки, выигравшей аукцион
${PUBLISHER_ID}ID издателяID аукциона/издателя из запроса ставки
${SOURCE_URL}URL источникаURL из запроса ставки
${SOURCE_URL_ENC}URL источника (закодированный)Закодированный URL из запроса ставки
${UNIVERSAL_SITE_ID}ID сайтаИдентификатор сайта из запроса ставки
TCF 2.0 / GDPR
${GDPR}GDPR статус0 — вне GDPR; 1 — под GDPR
${GDPR_CONSENT_xxxxx}Строка TC (TCF 2.0)Строка Transparency & Consent Framework. xxxxx — числовой ID поставщика из IAB GVL
${ADDTL_CONSENT}Дополнительное согласиеСписок ID поставщиков рекламных технологий Google, на работу с которыми дал согласие пользователь
GetIntent
Все макросы в двойных квадратных скобках [[MACRO]]. Доступны в URL кликовых ссылок и трекинговых пикселях.
Общие макросы (браузер + in-app)
[[SSP]]SSPSSP, с которого сделан переход/показ
[[URL]]URL страницыURL, с которого сделан переход (доступен не всегда — зависит от SSP)
[[DOMAIN]]ДоменДомен, с которого сделан переход (например, username.livejournal.com)
[[TOP_LEVEL_DOMAIN]]Домен верхнего уровняДомен верхнего уровня (например, livejournal.com)
[[CAMPAIGN_ID]]ID кампанииИдентификатор кампании из системы GetIntent
[[CAMPAIGN_NAME]]Название кампанииНазвание кампании из системы GetIntent
[[ADVERTISER_ID]]ID рекламодателяИдентификатор рекламодателя
[[CREATIVE_ID]]ID креативаИдентификатор креатива
[[CREATIVE_NAME]]Название креативаНазвание креатива из системы GetIntent
[[CREATIVE_SIZE]]Размер баннераФормат баннера в пикселях
[[CREATIVE_SIZE_X]]Ширина креативаШирина креатива в пикселях
[[CREATIVE_SIZE_Y]]Высота креативаВысота креатива в пикселях
[[CREATIVE_STATUS]]Статус креативаСтатус креатива
[[TAG_ID]]ID баннерного местаИдентификатор баннерного места
[[PUBLISHER_ID]]ID паблишераИдентификатор паблишера
[[AUCTION_ID]]ID аукционаИдентификатор аукциона
[[TIMESTAMP]]ВремяВремя перехода/показа
[[RANDOM]]Случайное числоСлучайное число
[[UID]]ID событияУникальный идентификатор события — для трекинга расхождений
[[WIDTH]]Ширина плеераШирина (в пикселях) видеоплеера, в котором осуществляется показ
[[HEIGHT]]Высота плеераВысота (в пикселях) видеоплеера, в котором осуществляется показ
[[SEGMENT_BILLED_NAME]]Наименование сегмента DMPНаименование стороннего сегмента DMP
[[SEGMENT_BILLED_ID]]ID сегмента DMPИдентификатор стороннего сегмента DMP
[[COST]]Стоимость ставкиСтоимость выигравшей ставки
[[CPM]]CPM[[COST]] × 1000
[[POSTBACK_ID]]ID платформыИдентификатор платформы для передачи данных по трекинговой ссылке
[[IP]]IP пользователяIP-адрес пользователя
[[BLOCKED_DOMAINS]]Заблокированные доменыСписок доменов, помеченных как заблокированные партнёрами SSP
[[ENV_ID]]Домен / ID приложенияДомен (браузер) или идентификатор приложения (in-app)
[[CATEGORIES]]Категории контентаКатегории контента (список)
[[TARGET_CATEGORY]]Главная категория сайтаГлавная категория сайта
[[CLICK_ID]]ID кликаИдентификатор клика
[[COUNTRY]]СтранаСтрана показа/перехода
[[CITY]]ГородГород показа/перехода
[[REGION]]РегионРегион показа/перехода
[[CLUSTER_SUFFIX]]Суффикс кластераСуффикс кластера DSP показа
[[ALT_UID]]Альтернативный ID пользователяАльтернативный идентификатор пользователя
[[LANDING_PAGE]]Целевая страницаЦелевая страница
[[MIME_TYPES]]MIME-типMIME-тип видеокреатива
[[VPAID_VERSIONS]]Версия VPAIDВерсия VPAID-плеера
[[OS]]Операционная системаОперационная система устройства
[[OS_VERSION]]Версия ОСВерсия операционной системы устройства
[[LATITUDE]]ШиротаКоордината широты
[[LONGITUDE]]ДолготаКоордината долготы
[[EVENT_ID]]ID события (универсальный)Уникальный идентификатор показа → клика. Может заменить большинство других макросов для трекинга уникальных событий
Только для мобильного in-app
[[APP_ID]]ID приложенияID мобильного приложения, с которого сделан переход/показ
[[APP_NAME]]Название приложенияНазвание мобильного приложения
[[APP_STORE_URL]]URL магазина приложенийURL магазина приложений (AppStore / Google Play)
[[APP_CATEGORY]]Категория приложенияКатегории приложения в AppStore или Google Play
[[CARRIER_ID]]ОператорМобильный оператор устройства
[[RAW_ADV_ID]]AAID / IDFAAAID (Android) или IDFA (iOS) устройства
[[DEVICE_MODEL]]Модель устройстваМодель устройства
[[DEVICE_MAKE]]Производитель устройстваПроизводитель устройства (например, Apple)
[[DEVICE_TYPE]]Тип устройстваТип устройства: SMARTPHONE, SMART_TV и т.д.
Клик-макросы
[[CLICK_PREFIX]]Click prefixURL с возможностью редиректа на URL после макроса
[[CLICK_PREFIX_ENCODED]]Click prefix (закодированный)Закодированный URL с возможностью редиректа
[[CLICK_TRACKING_BEACON]]Click tracking beaconВозвращает gif-пиксель для трекинга клика
[[CLICK_TRACKING_BEACON_ENCODED]]Click tracking beacon (enc)Закодированный gif-пиксель для трекинга клика
МТС DSP
Макросы пишутся заглавными буквами в формате ${MACRO}. Поддерживаются в кликовой ссылке, пикселях событий и VAST-ссылках. В обычном HTML-баннере макросы не поддерживаются.
В качестве разделителя между макросами рекомендуется ! — другие спецсимволы могут приводить к некорректному открытию страниц.
${OFFER_ID}ID кампанииИдентификатор рекламной кампании
${BANNER_ID}ID креативаИдентификатор креатива
${DEVICE}Тип устройстваmobile, desktop, tablet, smart tv
${TRAFFIC_TYPE}Тип трафикаinapp или web
${PLATFORM_ID}ID SSPИдентификатор SSP
${DOMAIN}Домен показаДомен площадки, на которой произошёл показ
${SEGMENT_ID}ID сегментаАудиторные сегменты, с которыми был связан показ
${RANDOM}Случайное числоУникальное случайное значение
${IMPRESSION_ID}ID показаИдентификатор показа
${ERID}ЕРИР IDЕРИР-идентификатор в соответствии с указанным в кабинете МТС DSP при заведении креатива
${TAGID}ID рекламного местаИдентификатор рекламного места
${PUBLISHER_ID}ID паблишераИдентификатор паблишера
${F70B56015AF2B2F3}ID пользователяИдентификатор пользователя: кука в web, IDFA/GAID в app
${DEVICE_ID}ID устройстваIDFA/GAID устройства
${PRODUCT_ID}ID товара из фидаID продукта из фида: XML-тег <offer id="xxx">
${PRODUCT_URL}URL товара из фидаСсылка на товар из фида: XML-тег <url>
${PRODUCT_URL_ENCODED}URL товара (закодированный)Ссылка на товар из фида в энкодированном виде
Пример: ?utm_term=${OFFER_ID}!${BANNER_ID}!${PLATFORM_ID}!${DEVICE}!${TRAFFIC_TYPE}!${DOMAIN}!${IMPRESSION_ID}
Soloway
Динамические макросы в формате ![macro]. Подставляются при клике на баннер.
![refdomain]Домен размещенияДомен площадки, где произошло размещение (example.ru)
![channel_name]Название каналаНазвание канала размещения (SSP или иной) — совпадает с названием в DSP
![pid]ID каналаID канала размещения (сценария) — совпадает с ID в DSP
![sspdealidstr]ID Direct DealИдентификатор Direct Deal, по которому произошло размещение
![format]Формат баннераФормат баннера: высота × ширина
![creative_id]ID креативаИдентификатор креатива — совпадает с ID в DSP
![creative_name]Название креативаТранслитерированное название креатива (латиница), до 60 символов
![ad]ID кампанииИдентификатор кампании — совпадает с ID в DSP
![placement_name]Название кампанииТранслитерированное название кампании (латиница), до 60 символов
![devicetype]Тип устройства0 — TV; 1 — планшеты; 2 — смартфоны; 3 — десктоп; 4 — прочие
![ostype]Операционная системаИдентификатор ОС пользователя (см. справочник)
![browsertype]БраузерИдентификатор браузера (без версии, см. справочник)
![geozoneid]Регион по IPРегион пользователя по IP (см. справочник)
![vp]Место размещения видео1 — In-Stream; 2 — Out-Stream
![startdelay]Зона видео (pre/mid/post)1 — Pre-Roll; 2 — Mid-Roll; 3 — Post-Roll
Hybrid
Макросы чувствительны к регистру. Поддерживаются в кликовых ссылках, пикселях показа, HTML/VAST/VPAID-тегах и баннерах MRAID.
Основной формат: {macro}. Для случайного числа поддерживаются несколько форматов: {rnd}, ${RND}, [RANDOM], ${CACHEBUSTER}.
Сессия / аукцион
{seanceid} / {sessionid} / {bid_id}Session IDDSP internal delivery seance ID (32 символа, строчные буквы и цифры)
{bet}СтавкаРазмер ставки
{rnd} / ${RND} / [RANDOM] / ${CACHEBUSTER}Случайное числоСлучайная последовательность из 8 цифр
{rnd_nl}Расширенное случайноеСлучайная последовательность из 26 символов (цифры и буквы разного регистра)
{timpestamp} / [timestamp]Unix timestampТекущая дата в формате Unix timestamp
Пользователь и устройство
{visitor_id}ID посетителяИдентификатор посетителя
{idfa}IDFAApple Identifier for Advertisers
{adid} / {gaid}AdID / GAIDGoogle Identifier for Advertisers
{device_id}ID устройстваDevice ID (AdID или IDFA)
{gender_id}Пол0 — Неизвестно; 1 — Мужчина; 2 — Женщина
{user_agent}User AgentUser Agent браузера/устройства
{device}Тип устройстваmobile / desktop / tablet / gameconsole / tv
{device_os}ОС устройстваunknown / ios / android / windows / windowsphone / linux / unix
{device_os_version}Версия ОСВерсия операционной системы устройства
{device_vendor}ПроизводительБренд (производитель) устройства
{device_model}Модель устройстваМодель устройства
{device_connection}Тип соединенияunknown / wifi / cellulardata2g / cellulardata3g / cellulardata4g
{environment}Средаin-app / mobile_web / web
{ip}IP-адресIP-адрес пользователя
{country_iso}Код страныISO-код страны
{city}Регион (рус)Название региона на русском
{city_en}Город (англ)Название города на английском
{city_ru}Город (рус)Название города на русском
{lt}ШиротаГеографическая широта
{ln}ДолготаГеографическая долгота
Площадка и плейсмент
{page_url}URL страницыURL страницы
{domain}Домен паблишераДомен паблишера
{app}Название приложенияНазвание мобильного приложения
{id_inapp} / {bundle_id}Bundle IDBundle приложения (mobile app ID)
{pub_id}ID паблишераИдентификатор паблишера
{site_id}ID сайтаИдентификатор сайта
{placement_id}ID плейсментаИдентификатор плейсмента
{width}Ширина плейсментаШирина плейсмента
{height}Высота плейсментаВысота плейсмента
{ad_size}Размер плейсментаШирина и высота плейсмента (например, 320x50)
{exchange} / {ssp}Название SSPНазвание SSP/биржи
{id_ssp}ID SSPИдентификатор SSP
{is_rewarded}Rewarded1 — rewarded-плейсмент; 0 — нет
{is_interstitial}Interstitial1 — interstitial-плейсмент; 0 — нет
Кампания и креатив
{advertiser_id}ID рекламодателяИдентификатор рекламодателя
{agency_id}ID агентстваИдентификатор агентства
{tradingdesk_id}ID Trading DeskИдентификатор Trading Desk
{campaign_id}ID кампанииИдентификатор кампании
{campaign_name}Название кампанииНазвание кампании
{id_ad}ID баннераИдентификатор баннера
{ad_name}Название баннераНазвание баннера
{creative_type}Тип баннераnative / video / banner
{pixelid} / {cloudid}Pixel IDИдентификатор пикселя (Cloud ID)
{clickid} / {txclickid}Click IDИдентификатор клика (24 цифры)
Погода (уникальные макросы Hybrid)
{tmp}ТемператураТемпература воздуха в месте показа
{air_pollution}Загрязнение воздухаУровень загрязнения воздуха
{allergy_risk}Риск аллергииУровень аллергенной опасности
{allergens}АллергеныСписок аллергенов через запятую
GDPR / Конфиденциальность
{coppa}COPPAСтатус COPPA: 0 или 1
{dnt}Do Not TrackСтатус DNT: 0 или 1
{lmt}Limit Ad TrackingСтатус ограничения отслеживания: 0 или 1
${GDPR} / {gdpr}GDPRСтатус GDPR: 0 или 1
${GDPR_CONSENT}Строка согласия GDPRСтрока GDPR consent
${GDPR_CONSENT_XXX}Строка согласия (вендор)Строка согласия для конкретного вендора (XXX: 206, 68, 755)
${GDPR_PD}Персональные данные GDPRСодержит ли запрос персональные данные: 0 или 1
%aw_random%Случайное число (aw)Альтернативный формат случайного числа
Bidease
Все макросы в формате {{.MACRO}}.
{{.Exchange}}Биржа (Exchange)Название биржи
{{.SSP}}SSPНазвание SSP
{{.AppBundle}}Bundle ID приложенияУникальный идентификатор приложения (bundle_id)
{{.AppName}}Название приложенияНазвание приложения из стора
{{.BidID}}Bid IDУникальный ID ставки (и показа, клика, установки)
{{.CampaignID}}ID кампанииИдентификатор кампании
{{.CampaignTitle}}Название кампанииНазвание кампании
{{.CreativeID}}ID креатива (основной)Основной CreativeID
{{.CampaignCreativeID}}ID креатива кампанииCampaign CreativeID
{{.CreativeHash}}Хеш креативаХеш-значение креатива
{{.CreativeType}}Тип креативаbanner / video / native
{{.ImpWidth}}Ширина плейсментаШирина плейсмента во время ставки
{{.ImpHeight}}Высота плейсментаВысота плейсмента во время ставки
{{.Interstitial}}InterstitialЯвляется ли плейсмент полноэкранным
{{.Rewarded}}RewardedЯвляется ли размещение Rewarded
{{.ImpType}}Тип показаТип показа
{{.IFA}}IFA (IDFA/GAID)Уникальный рекламный ID — регистр подбирается автоматически в зависимости от ОС
{{.DeviceMake}}Производитель устройстваПроизводитель (бренд) устройства
{{.DeviceModel}}Модель устройстваМодель устройства
{{.IP}}IP-адресIP-адрес пользователя
{{.Lang}}ЯзыкЯзык (2 символа: RU, EN и т.д.)
{{.Lat}}ШиротаШирота от −90 до +90 (отрицательная — юг)
{{.Lon}}ДолготаДолгота от −180 до +180 (отрицательная — запад)
{{.City}}ГородГород
{{.Country}}Страна (3 символа)Страна: RUS, USA и т.д.
{{.Country2}}Страна (2 символа)Страна: RU, US и т.д.
{{.OSVer}}Версия ОСВерсия операционной системы
{{.Month}}МесяцМесяц в UTC (числами)
{{.UserAgent}}User AgentUser Agent во время ставки
{{.Revenue}}ДоходДля CPM — стоимость показа; для CPC — стоимость клика
{{.RevenueCPM}}Доход CPMСтоимость 1000 показов
{{.PayoutCPI}}Размер CPI выплатыРазмер CPI-выплаты
{{.UniqueID}}Внутренний ID устройстваВнутренний ID устройства Bidease
{{.EridToken}}ORD-токен (ЕРИР)ЕРИР-токен (ORD Token)
{{.CompanyID}}ID организацииID организации на платформе Bidease
{{.ProductID}}ID продуктаID продукта (приложения или мобильного контента)
{{.OriginCompanyID}}ID исходной кампанииИсходная родительская кампания для ретаргетинга
{{.OriginCreativeID}}ID исходного креативаИсходный родительский креатив для ретаргетинга
{{.CampaignCreatedAt.Format "2006-01-02"}}Дата создания кампанииДата создания кампании в формате 2024-02-07
{{.MD5 .AppBundle}}MD5 Bundle IDMD5-хеш идентификатора приложения (bundle_id)
Трекинговые ссылки Bidease
{{.Error}}Error trackerАдрес трекера ошибок Bidease
{{.Event}}Event trackerАдрес трекера событий Bidease
{{.Imp}}Impression trackerАдрес трекера показов Bidease
{{.ImpCr}}Impression tracker (creatives)Адрес трекера показов из креативов Bidease
{{.Click}}Click trackerАдрес трекера кликов
{{.ImpURL}}Impression tracker (внешний)Ссылка для трекера (AppsFlyer, Adjust и т.п.) — по показам
{{.ClickURL}}Click tracker (внешний)Ссылка для трекера (AppsFlyer, Adjust и т.п.) — по кликам
{{.TargetURL}}Target URLСсылка на приложение в сторе
Genius Desk
Макросы в формате ##MACRO=##.
Основные
##ERID=##ERID токенERID токен креатива из ЕРИР
##CRCLICK=##Click URLОригинальный click URL, заполненный пользователем
##CCID=##ID креатива кампанииID креатива кампании — создаётся автоматически в UI
##CID=##ID кампанииИдентификатор кампании
##ADVID=##ID рекламодателяИдентификатор рекламодателя
##SITEID=##ID сайтаИдентификатор сайта
##PUBID=##ID паблишераИдентификатор паблишера
##REQUESTID=##ID запросаУникальный идентификатор запроса
##GREQUESTID=##Глобальный ID запросаГлобальный уникальный идентификатор запроса
##RANDOM=##Случайное числоСлучайное значение
##DOMAIN=##ДоменДомен, с которого был совершён переход
##REFERER=##РеферерURL источника трафика
##UID=##ID пользователяУникальный идентификатор пользователя
##UNSIGNEDUID=##UID без подписиUID пользователя в неподписанном виде
##IP=##IP-адресIP-адрес пользователя
##UA=##User-AgentUser-Agent устройства
##IDFA=##IDFAIDFA для устройств iOS
##ADVERTISING_ID=##Advertising IDРекламный ID устройства
##APPLICATION_ID=##ID приложенияИдентификатор приложения
Размеры и формат
##WIDTH=##Ширина креативаШирина креатива
##HEIGHT=##Высота креативаВысота креатива
##TAGWIDTH=##Ширина тегаШирина тега креатива
##TAGHEIGHT=##Высота тегаВысота тега креатива
##TAGSIZE=##Размер тегаРазмер тега (ширина x высота)
##TAGID=##ID тегаИдентификатор тега
##SIZE=##Размер креативаРазмер креатива
##VIDEOH=##Высота видеоВысота видеорекламы
##VIDEOW=##Ширина видеоШирина видеорекламы
##MP4_DURATION=##Длительность MP4Длительность видео в формате MP4
##SKIP_TIME_DURATION=##Время до пропускаВремя до возможности пропуска видео
Клики и трекинг
##CLICK=##КликURL для отслеживания кликов
##CLICKF=##Клик (fallback)То же что ##CLICK=##, но для fallback-сценариев
##CLICK0=##Клик с атрибутамиКлики с дополнительными атрибутами
##CLICKF0=##Клик с атрибутами (fallback)Клики с атрибутами для fallback-сценариев
##PRECLICK=##Pre-clickURL для отслеживания до клика (наведение, hover и т.д.)
##PRECLICKF=##Pre-click (fallback)То же что ##PRECLICK=##, но для fallback
##PRECLICK0=##Pre-click с атрибутамиPre-click URL с дополнительными атрибутами
##PRECLICKF0=##Pre-click с атрибутами (fallback)Pre-click с атрибутами для fallback
##SOURCEID=##ID источникаИдентификатор источника
##EXTERNALID=##Внешний IDВнешний идентификатор
##ETID=##Внешний ID (ext)Внешний идентификатор (альтернативный)
Гео и аудитория
##GEO_REGION=##Географический регионГеографический регион пользователя
##SSP_DEVICETYPE=##Тип устройства (SSP)Тип устройства: mobile, desktop, tablet
##SSP_VIDEO_PLACEMENT=##Размещение видеоТип размещения видеорекламы (in-stream, out-stream)
##DOMAIN_HASH=##Хеш доменаХешированное значение домена
##CGID=##ID стратегииИдентификатор стратегии
##KEYWORD=##Ключевое словоКлючевое слово
##DESTURL=##Целевой URLКонечный URL назначения
##DISPLAY_URL=##Отображаемый URLОтображаемый URL