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

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

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

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

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

correlator description_url env gdfp_req iu

output plcmt sz unviewed_position_start

url vpa vpmute wta

 

Параметр	Подробная информация
correlator (Коррелятор)	Параметр "Коррелятор" принимает переменное значение, которое будет одинаковым для всех запросов, полученных в результате одного просмотра страницы. Этот параметр применяется для реализации конкурентного исключения, в том числе на платформах, которые не используют файлы cookie. Если используется IMA SDK, значение параметра задается автоматически. При этом IMA SDK переопределяет значение, установленное вашим проигрывателем. Если IMA SDK не используется, произвольное положительное целое значение этого параметра не должно повторяться для других просмотров страниц. Пример использования correlator=4345645667 Требования Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
description_url (URL описания)	Параметр "URL описания" принимает переменное значение, позволяющее получить информацию о видеоролике, который воспроизводится на странице. Добавьте на страницу от одного до трех абзацев с описанием контента. Например, можно динамически объединить контент страницы из предварительно заданных блоков для параметра description_url. Подробнее о том, как указать уникальный URL описания… Для значения параметра description_url всегда нужно использовать URL-кодирование, если он используется в видеопроигрывателях на веб-страницах, подключенных телевизорах и устройствах OTT. Для рекламы в видеопроигрывателях в мобильных приложениях URL-кодирование не используется. 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_code/.../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 Использование Требуется для сайтов и приложений. Рекомендуется для алгоритмических продаж
vpa (Автоматическое воспроизведение видео)	Рекомендуется руководством MRC по работе с данными о видеорекламе Параметр, который относится к автоматическому воспроизведению видео, принимает постоянное значение. Оно указывает, будет ли рекламный ролик запускаться самостоятельно или только после нажатия на него. Возможные значения: click (если требуется действие пользователя) и auto (если видео воспроизводится автоматически). Если значение этого параметра неизвестно, задавать его не нужно. Пример использования Автовоспроизведение: vpa=auto Воспроизведение по клику: vpa=click Требования Рекомендуется для алгоритмических продаж
vpmute (Воспроизведение видео без звука)	Рекомендуется руководством MRC по работе с данными о видеорекламе Параметр "Воспроизведение без звука" принимает постоянное значение, которое определяет, будет ли воспроизводиться видеообъявление, если в проигрывателе отключен звук. Пример использования Звук отключен: vpmute=1 Звук включен: vpmute=0 Использование Обязательно для сайтов и алгоритмических продаж.
wta (Почему я вижу эту рекламу?)	Параметр "Почему я вижу эту рекламу?" принимает постоянное значение, которое указывает на то, что в видеопроигрывателе поддерживается пометка рекламы. Если параметр &wta не передается, по умолчанию устанавливается значение &wta=1. При использовании IMA SDK пометка рекламы поддерживается автоматически. Если вы не используете IMA SDK, то в проигрывателе должна быть реализована поддержка Icon и IconClickFallbackImage для VAST в соответствии со стандартом IAB. Издателям, которые не показывают значок "Выбор рекламы", приведенный в ответе VAST, необходимо передавать параметр &wta=0. Если в запросе объявления есть параметр &wta=1 или вообще нет параметра &wta, это означает, что издатель обрабатывает предоставленную информацию о значке "Выбор рекламы". Если значок "Выбор рекламы", указанный в ответе VAST, может появляться в сопутствующих объявлениях или иным образом показываться пользователю, в запросах аудиообъявлений необходимо передавать параметр wta=1. В случае с трафиком из ЕЭЗ креативы для резервирования будут допущены к показу по запросам с параметром &wta=0, только если отключены пометки от Google. Объявление должно соответствовать действующим нормативным требованиям к объявлениям, которые показываются в Европейской экономической зоне (ЕЭЗ). В частности, в таких объявлениях пользователям должна предоставляться возможность пожаловаться на противозаконный контент. Издатели также должны сообщать Google о жалобах пользователей на противозаконный контент при помощи специальной формы. Пример использования Поддерживаются варианты: wta=1 или отсутствие параметра wta Не поддерживается: wta=0 Требования Обязательное требование при размещении рекламы через Ad Exchange Обязательное требование для трафика сайтов и приложений при показе в ЕЭЗ Рекомендуется для алгоритмических продаж