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

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

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

Макросы запросов объявлений                 Фреймворки API Набор App Bundle Ключ объекта Максимальная продолжительность паузы Позиция рекламной паузы Блокировка кеша Идентификатор клиента Идентификатор CMS DAI_PRE Домен FW CAID GDPR Запрос согласия по GDPR	Число nonce в рекламе In-Stream в Google IFA Тип идентификатора IFA Ограничение показа рекламы MIME-тип медиаконтента Неперсонализированная реклама Партнер, использующий OMID URL страницы Тип места размещения Регламенты SCTE-35 Тег на стороне сервера Идентификатор потока	TFCD TFUA Временная метка Идентификатор транзакции Конфиденциальность в США Агент пользователя IP-адрес пользователя Продолжительность видео Продолжительность видеов секундах Идентификатор видео Название видео
Макросы отслеживания VAST                Блокировка кеша Код ошибки

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

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

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

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

Фреймворки API

 

Макрос
[APIFRAMEWORKS]

 

Параметр sdk_apis.

 

Набор App Bundle

 

Макрос
[APPBUNDLE]

 

Параметр an.

Ключ объекта

 

Макрос
%%ASSET_KEY%%

 

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

Позиция рекламной паузы

 

Макрос
[BREAKPOSITION]

 

Макрос шаблона VAST версии 4.1. Возвращает следующие значения:

1 – видеореклама в начале ролика;
2 – видеореклама в середине ролика;
3 – видеореклама в конце ролика;
4 – отдельное объявление;
0 – другое.

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

 

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

 

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

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

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

 

Макрос
[CACHEBUSTING]

 

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

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

 

Макрос
[CLIENTUA]

 

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

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

 

Макрос
%%CMS_ID%%

 

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

DAI_PRE

 

Макрос
%%DAI_PRE%%

 

Значение по умолчанию: 0. Значение "1" устанавливается, когда при отправке запроса объявления не предполагается блокировка или снижение эффективности этого запроса, например в ситуациях заблаговременной подготовки к паузе или предварительной загрузки. Это значение указывает серверам объявлений, что для обработки запроса может быть доступно больше времени.

Значение действует только на рекламу в линейных видеопотоках и прямых трансляциях.

Домен

 

Макрос
[DOMAIN]

 

Макрос шаблона VAST версии 4.1. Домен, к которому относится URL перехода, использованный при создании трансляции.

FW CAID

 

Макрос
%%FW_CAID%%

 

Пользовательский идентификатор ресурса Freewheel из фида MRSS (только в видео по запросу).

GDPR

 

Макрос
%%GDPR%%

 

Параметр gdpr.

Запрос согласия по GDPR

 

Макрос
[GDPRCONSENT]

 

Параметр gdpr_consent.

Число nonce в рекламе In-Stream в Google

 

Макрос
[GOOGLE_INSTREAM_VIDEO_NONCE]

 

Параметр givn.

IFA

 

Макрос
[IFA]

 

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

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

 

Макрос
[IFATYPE]

 

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

Ограничение показа рекламы

 

Макрос
[LIMITADTRACKING]

 

Параметр ltd.

MIME-тип медиаконтента

 

Макрос
[MEDIAMIME]

 

Макрос шаблона VAST версии 4.1: список поддерживаемых MIME-типов медиаконтента, разделенных запятыми.

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

 

Макрос
%%NPA%%

 

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

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

Партнер, использующий OMID

 

Макрос
[OMIDPARTNER]

 

Макрос шаблона VAST версии 4.1: параметр omid_p.

URL страницы

 

Макрос
[PAGEURL]

 

Макрос шаблона VAST версии 4.1: URL перехода, использованный при создании трансляции.

Тип места размещения

 

Макрос
[PLACEMENTTYPE]

 

Макрос шаблона VAST версии 4.1: при динамической вставке объявлений значение всегда будет "1", поскольку оно относится к рекламе In-Stream.

Изучите сведения о подтипах мест размещения для видео от AdCOM.

Регламенты

 

Макрос
[REGULATIONS]

 

Макрос шаблона VAST версии 4.1: список действующих регламентов на основе параметров, разделенных запятыми. При наличии параметра tfcd=1 будет добавлена строка "coppa", а при наличии параметра gdpr=1 – строка "gdpr".

Тег на стороне сервера

 

Макрос
[SERVERSIDE]

Макрос шаблона VAST версии 4.1: 1 во всех случаях.

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%%

 

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

TFUA

 

Макрос
%%TFUA%%

 

Параметр tfua.

Временная метка

 

Макрос
[TIMESTAMP]

 

Макрос шаблона VAST версии 4.0: текущая временная метка, формат которой соответствует стандарту ISO 8601.

Идентификатор транзакции

 

Макрос
[TRANSACTIONID]

 

Макрос шаблона VAST версии 4.1: идентификатор, служащий для корреляции цепочки запросов объявлений с начала их создания.

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

 

Макрос
%%US_PRIVACY%%

 

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

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

 

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

 

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

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

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

 

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

 

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

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

Продолжительность видео

 

Макрос
%%VIDEO_DURATION%%

 

Данные о продолжительности в миллисекундах из фида MRSS (только в видео по запросу).

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

 

Макрос
%%VIDEO_DURATION_SEC%%

 

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

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

 

Макрос
%%VIDEO_ID%%

 

Идентификатор контента в CMS, полученный из фида MRSS (только в видео по запросу).

Название видео

 

Макрос
%%VIDEO_TITLE%%

 

Название видео из фида MRSS (только в видео по запросу).

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

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

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

 

Макрос
[CACHEBUSTING]

 

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

Код ошибки

 

Макрос
[ERRORCODE]

 

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

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

Макросы в строках с кодировкой URL

В разделе рекламного тега, который должен быть в кодировке URL, можно использовать только макрос без подобной кодировки. Это позволит выполнять замену макроса без ошибок.

Пример

В параметре запроса, который должен быть в кодировке URL, можно использовать макрос с однократно используемым числом в рекламе In-Stream в Google:

 

Правильно
http://www.some-adtag.com?encoded_param=[GOOGLE_INSTREAM_VIDEO_NONCE]%3D5
 

Неправильно
http://www.some-adtag.com?encoded_param=%5BGOOGLE_INSTREAM_VIDEO_NONCE%5D%3D5