Обязательные и рекомендованные параметры для сайтов

Возможность реализации решений для видеорекламы на базе тегов для источников спроса Ad Exchange без использования IMA SDK находится на стадии бета-тестирования и может быть недоступна в вашей сети. За дополнительной информацией обращайтесь к менеджеру своего аккаунта.

Ниже перечислены параметры URL для тегов объявлений VAST. Эти параметры требуются решениям для видеорекламы на основе тегов для сайтов, если они не интегрированы с IMA SDK.

Ознакомьтесь с обязательными параметрами для приложений и обязательными и рекомендуемыми параметрами для алгоритмических продаж.

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

correlator description_url env gdfp_req

iu output plcmt sz

unviewed_position_start url vpmute wta

 

Параметр	Подробная информация
correlator (Коррелятор)	Параметр "Коррелятор" принимает переменное значение, которое будет одинаковым для всех запросов, полученных в результате одного просмотра страницы. Этот параметр применяется для реализации конкурентного исключения, в том числе на платформах, которые не используют файлы cookie. Если используется IMA SDK, значение параметра задается автоматически. При этом IMA SDK переопределяет значение, установленное вашим проигрывателем. Если IMA SDK не используется, произвольное положительное целое значение этого параметра не должно повторяться для других просмотров страниц. Пример использования correlator=4345645667 Требования Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
description_url (URL описания)	Параметр "URL описания" принимает переменное значение, позволяющее получить информацию о видеоролике, который воспроизводится на странице. Обычно это адрес страницы, на которой расположен проигрыватель, но допускается и адрес страницы с информацией о видео. Всегда нужно кодировать значение параметра description_url для видеопроигрывателей на веб-страницах, подключенных телевизоров/устройств OTT и не кодировать для рекламы в видеопроигрывателях в мобильных приложениях. IMA SDK не устанавливает этот параметр автоматически. Его требуется задавать вручную. Примеры использования Пример с кодированием в URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Пример без кодирования: description_url= https://www.sample.com/golf.html Требования Обязательно для сайтов, приложений и Ad Exchange Рекомендуется для алгоритмических продаж
env (Среда)	Параметр "Среда" принимает постоянное значение, которое указывает на запрос in-stream или запрос от проигрывателя. Допустимые значения: instream (подходит как для видео-, так и для аудиообъявлений) и vp (подходит только для видеообъявлений). Пример использования Видео- и/или аудиообъявления: env=instream Только видеообъявления: env=vp Требования Требуется для сайтов и приложений
gdfp_req (Индикатор набора атрибутов Менеджера рекламы)	Параметр "Индикатор набора атрибутов Менеджера рекламы" принимает постоянное значение, указывающее, что пользователь работает с Менеджером рекламы. Пример использования gdfp_req=1 Требования Требуется для сайтов и приложений
iu (Рекламный блок)	Параметр "Рекламный блок" принимает переменное значение, которое должно соответствовать текущему рекламному блоку в формате: /network_id/.../ad_unit Пример использования iu=/6062/videodemo Требования Требуется для сайтов и приложений
output (Формат вывода объявления)	Параметр "Формат вывода объявления" принимает постоянное значение, которое должно соответствовать формату вывода объявления. Используйте output=vast для версии VAST, настроенной в вашей сети по умолчанию. Для определенных тегов объявлений и разделов сайта можно запросить специальные версии VAST или VMAP. Если вы работаете с VAST и в проигрывателе используется IMA SDK, у параметра output в запросе видеообъявления всегда будет значение xml_vast4. Это не вызовет проблем при обработке рекламы, так как в SDK обеспечена обратная совместимость со всеми версиями VAST, которые может использовать любой сторонний сервер объявлений. Используйте значение параметра output=vmap, чтобы выбрать версию VMAP, настроенную в вашей сети по умолчанию (например, VMAP 1). Если вы возвращаете ответ VAST внутри VMAP, то можете указать нужную версию VAST с помощью значений xml_vmap1_vast3 или xml_vmap1_vast4. Пример использования VAST вашей сети по умолчанию: output=vast VAST 4: output=xml_vast4 VMAP вашей сети по умолчанию: output=vmap VMAP 1: output=xml_vmap1 VMAP 1, возвращающий VAST 4: output=xml_vmap1_vast4 Требования Требуется для сайтов и приложений
plcmt (Место размещения)	Параметр для места размещения принимает постоянное значение, которое указывает, объявлен ли инвентарь In-Stream в соответствии со спецификациями IAB и если да, то как (возможные варианты: In-Stream и сопутствующий). Для запросов рекламы вне проигрывателя это поле заполняется автоматически с учетом объявленного формата инвентаря. При этом вариант в поле переопределяет любые прежние значения, объявленные для контента с поддержкой In-Stream или сопутствующего контента. Пример использования Запрос In-Stream: plcmt=1 Запрос сопутствующего контента: plcmt=2 Использование Обязательно для сайтов и алгоритмических продаж.
sz (Размер)	Параметр "Размер" принимает переменное значение, которое должно соответствовать размеру рекламного места основного видео. Если размеров несколько, они должны быть разделены вертикальной чертой (|). Не добавляйте букву v после размера. Пример использования sz=400x300 Требования Требуется для сайтов и приложений Этот параметр необязателен, если запрашивается только ad_type=audio.
unviewed_position_start (Отложенные показы)	Параметр "Отложенные показы" принимает постоянное значение, указывающее на отложенные показы видео. Пример использования unviewed_position_start=1 Требования Требуется для сайтов и приложений
url (URL)	Параметр URL принимает переменное значение, которое должно соответствовать полному URL, с которого поступил запрос. Это значение позволяет покупателям определить источник запроса и понять его контекст. Мы рекомендуем указывать это значение динамически при отправке запроса объявления. При показе рекламы на сайтах таким значением является URL страницы, на которой размещен проигрыватель. Если вы используете IMA SDK, то значение URL задается автоматически. Если это значение устанавливается вашим проигрывателем, то IMA SDK не будет переопределять его. В случае с приложением для мобильных устройств или подключенных телевизоров (например, если пользователь смотрит в мобильном приложении видео, которое также доступно на сайте для компьютеров) в качестве такого значения необходимо указать точный URL, по которому размещен инвентарь для видео- или аудиорекламы*. Значение этого параметра должно быть закодировано. Пример использования url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html *Если инвентарь находится в приложении, то не получится указать для этого параметра переменное значение, соответствующее URL. В этом случае мы рекомендуем использовать следующий синтаксис: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Использование Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
vpmute (Воспроизведение видео без звука)	Рекомендуется руководством MRC по работе с данными о видеорекламе Параметр "Воспроизведение без звука" принимает постоянное значение, которое определяет, будет ли воспроизводиться видеообъявление, если в проигрывателе отключен звук. Пример использования Звук отключен: vpmute=1 Звук включен: vpmute=0 Использование Обязательно для сайтов и алгоритмических продаж.
wta (Почему я вижу эту рекламу?)	Параметр "Почему я вижу эту рекламу?" принимает постоянное значение, которое определяет, поддерживается ли показ сообщения Почему я вижу эту рекламу? в этом видеопроигрывателе. При использовании IMA SDK показ этого сообщения поддерживается автоматически. Если вы не используете IMA SDK, то видеопроигрыватель должен поддерживать элементы Icon и IconClickFallbackImage в соответствии со стандартом IAB для шаблона VAST. Если значок "Выбор рекламы", указанный в ответе VAST, должен появляться в сопутствующих объявлениях или иным образом показываться пользователю, в запросах аудиообъявлений необходимо передавать параметр wta=1. Чтобы объявления от источников спроса Google или объявления с резервированием и размещением в Google могли показываться в ЕЭЗ, в запросах таких объявлений должен содержаться параметр wta=1. Он подтверждает, что значок "Выбор рекламы", указанный в ответе VAST, появляется в видеообъявлении, сопутствующих объявлениях или иным образом представлен во всех креативах, которые показываются пользователю. Пример использования Поддерживается: wta=1 Не поддерживается: wta=0 Требования Обязательное требование при размещении рекламы через Ad Exchange Обязательное требование для трафика сайтов и приложений при показе в ЕЭЗ Рекомендуется для алгоритмических продаж