Макросы для динамической вставки объявлений

Ознакомьтесь с более подробной информацией о макросах (в том числе о том, как они работают с Менеджером рекламы), а также с полным списком макросов для видео, включая макросы отображения и отслеживания.

Ссылки на описания отдельных макросов

Макросы запросов объявлений                 Набор App Bundle Ключ объекта Максимальная продолжительность паузы Блокировка кеша Идентификатор клиента Идентификатор CMS GDPR	Запрос согласия по регламенту GDPR Идентификатор IFA Тип идентификатора IFA Ограничение отслеживания Неперсонализированная реклама SCTE-35 Идентификатор потока	Тег ресурса для детей Конфиденциальность в США Агент пользователя IP-адрес пользователя Продолжительность видео
Макросы отслеживания VAST                Блокировка кеша Код ошибки

Развернуть все  Свернуть все

Макросы запросов объявлений

Приведенные здесь макросы запросов объявлений можно использовать только в тегах для динамической вставки объявлений, предназначенных для источника видеоконтента по запросу или прямой трансляции. Они не поддерживаются для креативов VAST.

Макросы в квадратных скобках обычно используются для передачи в Менеджер рекламы параметров перенаправления.

Набор App Bundle

 

Макрос
[APPBUNDLE]

 

Параметр an.

Ключ объекта

 

Макрос
%%ASSET_KEY%%

 

Заменяется на код события видеотрансляции.

Максимальная продолжительность паузы

 

Макрос
%%BREAK_DURATION%%
[BREAKMAXDURATION]

 

Продолжительность текущей рекламной паузы в секундах.

Макрос [BREAKMAXDURATION] следует использовать только для тех перенаправлений Менеджера рекламы, где невозможно использовать %%BREAK_DURATION%%.

Блокировка кеша

 

Макрос
[CACHEBUSTING]

 

Случайное число.

Идентификатор клиента

 

Макрос
[CLIENTUA]

 

Идентификатор используемого проигрывателя и клиента VAST.

Идентификатор CMS

 

Макрос
%%CMS_ID%%

 

Заменяется на идентификатор источника контента Менеджера рекламы (так называемый CMS ID), воспроизводимого в настоящий момент. Это значение не представлено в фиде MRSS, но присутствует в интерфейсе Менеджера рекламы.

GDPR

 

Макрос
%%GDPR%%

 

Параметр gdpr.

Запрос согласия по регламенту GDPR

 

Макрос
[GDPRCONSENT]

 

Параметр gdpr_consent.

Идентификатор IFA

 

Макрос
[IFA]

 

Сбрасываемый рекламный идентификатор, получаемый из параметра rdid. Рекламный идентификатор передается только по основным запросам объявлений, если это разрешено флагами конфиденциальности (такими как tfcd и is_lat).

Тип идентификатора IFA

 

Макрос
[IFATYPE]

 

Параметр idtype для динамической вставки объявлений. Тип идентификатора IFA передается только по основным запросам объявлений, если это разрешено флагами конфиденциальности (такими как tfcd и is_lat).

Ограниченное отслеживание

 

Макрос
[LIMITEDTRACKING]

 

Параметр ltd.

Неперсонализированная реклама

 

Макрос
%%NPA%%

 

Заменяется единицей, чтобы пометить запрос объявления как неперсонализированный.

Этот макрос предназначен для запросов объявлений, которые регулируются Генеральным регламентом ЕС о защите персональных данных (GDPR), и используется только в тегах для динамической вставки объявлений. Изучите список других макросов, обеспечивающих соблюдение регламента GDPR.

SCTE-35

 

Макрос
%%SPLICE_INSERT_EVENT_ID%%
%%SPLICE_INSERT_UPID%%
%%TIME_SIGNAL_EVENT_ID%%
%%TIME_SIGNAL_UPID%%
%%TIME_SIGNAL_UPID_RAW%%
%%AFMM_CBC%%

 

Заменяется на сигналы SCTE-35.

Идентификатор потока

 

Макрос
%%STREAM_ID%%

 

Заменяется на идентификатор потока сеанса для контента, который воспроизводится в настоящий момент.

Тег ресурса для детей

 

Макрос
%%TFCD%%

 

Заменяется на значение параметра tfcd.

Конфиденциальность в США

 

Макрос
%%US_PRIVACY%%

 

Заменяется на значение параметра us_privacy.

Агент пользователя

 

Макрос
%%USER_AGENT%%
[DEVICEUA]

 

Агент пользователя, связанный с типом устройства, на котором конечному пользователю показывается объявление.

В случае с переадресацией VAST функция будет корректно выполнена только при использовании макроса [DEVICEUA].

IP-адрес пользователя

 

Макрос
%%USER_IP%%
[DEVICEIP]
[IP_ADDRESS]

 

Заменяется на IP-адрес пользователя.

Макрос [IP_ADDRESS] следует использовать только для тех перенаправлений Менеджера рекламы, где невозможно использовать %%USER_IP%%.

Длительность видео в секундах

 

Макрос
%%VIDEO_DURATION_SEC%%

 

Позволяет указать продолжительность видео в секундах.

Макросы отслеживания VAST

Макросы [CACHEBUSTING] и [ERRORCODE] соответствуют стандарту VAST 4.0 (см. раздел 2.3.7 "Макросы").

Блокировка кеша

 

Макрос
[CACHEBUSTING]​

 

Заменяется на случайное 8-значное число.

Код ошибки

 

Макрос
[ERRORCODE]

 

Заменяется на код ошибки VAST.

Если у вас возникли вопросы, связанные с устранением неполадок при динамической вставке объявлений или со сбоями, обратитесь в службу поддержки издателей.