Возможность реализации решений для видеорекламы на базе тегов для источников спроса Ad Exchange без использования IMA SDK находится на стадии бета-тестирования и может быть недоступна в вашей сети. За дополнительной информацией обращайтесь к менеджеру своего аккаунта.
В этой статье представлен список обязательных и рекомендуемых параметров для тегов объявлений VAST, используемых при показе рекламы на сайтах.
Содержание
- Обязательные параметры для показа объявлений
- Обязательные параметры для алгоритмических продаж
- Рекомендуемые параметры для алгоритмических продаж
Ознакомьтесь со списком параметров для других способов внедрения и со статьей Требования к URL тегов объявлений VAST.
Обязательные и рекомендованные параметры для сайтов
Обязательные параметры для показа объявлений
correlator (коррелятор)
Описание
Параметр "Коррелятор" (correlator) принимает переменное значение, которое будет одинаковым для всех запросов, полученных в результате одного просмотра страницы. Этот параметр применяется для внедрения конкурентного исключения, в том числе на платформах, не поддерживающих файлы cookie.
Примеры использования
correlator=4345645667
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование SDK
- Если используется IMA SDK, значение коррелятора задается автоматически. При этом IMA SDK переопределяет значение, установленное вашим проигрывателем.
- Если IMA SDK не используется, произвольное положительное целое значение этого параметра не должно повторяться для других просмотров страниц.
description_url (URL описания)
Описание
Параметр "URL описания" (description_url) принимает переменное значение, позволяющее получить информацию о видеоролике, который воспроизводится на странице.
URL описания должен указывать на видео, которое воспроизводится на определенной странице веб-приложения, мобильного приложения или ТВ-приложения. Он не должен являться доменом верхнего уровня для всех видео или всех запросов объявлений. Пример. Если на странице https://sample.com/golf.html показываются видео о футболе, укажите этот URL как значение параметра description_url.
Примеры использования
Для значения параметра description_url всегда нужно использовать кодировку URL, если он относится к веб-страницам с видеоконтентом, подключенным телевизорам и устройствам OTT. Параметр description_url не используется при показе рекламы в видеопроигрывателях в мобильных приложениях.
Пример с кодировкой:description_url=
https%3A%2F%2Fsample.com%2Fgolf.html
Пример без кодировки:description_url=
https://sample.com/golf.html
Требования и рекомендации
Этот параметр требуется для показа объявлений на сайтах и в мобильных приложениях. Он также необходим, если для динамического размещения используется Ad Exchange или AdSense.
Этот параметр рекомендуется при алгоритмических продажах.
Использование SDK
IMA SDK не устанавливает этот параметр автоматически. Его требуется задавать вручную.
Подробнее о том, как задавать данный параметр для IMA SDK на вашей платформе, описано в руководстве по IMA SDK.
env (среда)
Описание
Параметр "Среда" (env) принимает постоянное значение, которое указывает на запрос in-stream или запрос от проигрывателя.
Допустимые значения: instream (подходит как для видео-, так и для аудиообъявлений) и vp (подходит только для видеообъявлений).
Примеры использования
Видео- и/или аудиообъявления:env=instream
Только видеообъявления:env=vp
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Этот параметр необходим для создания точных отчетов по типам запросов с разбивкой данных по категории "Тег видео".
gdfp_req (индикатор набора атрибутов)
Описание
Параметр "Индикатор атрибутов Google Менеджера рекламы" (gdfp_req) принимает постоянное значение, которое указывает, что запрос объявления предназначен для инвентаря Google Менеджера рекламы.
Примеры использования
gdfp_req=1
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
iu (рекламный блок)
Описание
Параметр "Рекламный блок" (iu) принимает переменное значение, которое должно соответствовать текущему рекламному блоку в формате /network_code/.../ad_unit.
Примеры использования
iu=/6062/videodemo
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
output (формат вывода)
Описание
Параметр "Формат вывода" (output) принимает постоянное значение, которое должно быть связано с тем, в каком формате выводится объявление.
Примеры использования
Используется версия VAST сети по умолчанию:
output=vast
Используется VAST 4 (можно задать определенные версии для тех или иных тегов):
output=xml_vast4
Используется настройка VMAP, по умолчанию заданная в сети:
output=vmap
Используется VMAP 1:
output=xml_vmap1
Используется VMAP 1, возвращается VAST 4 (если вы возвращаете VAST внутри VMAP):
output=xml_vmap1_vast4
Требования и рекомендации
Этот параметр обязателен при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы. Он нужен для того, чтобы на запрос объявления возвращался корректный ответ.
Использование SDK
Если вы работаете с VAST и в проигрывателе используется IMA SDK, у параметра output в запросе видеообъявления всегда будет значение output=xml_vast4. Это не ведет к проблемам с надежностью, так как в IMA SDK обеспечена совместимость со всеми версиями VAST, которые может использовать любой сторонний сервер объявлений.
sz (размер)
Описание
Параметр "Размер" (sz) принимает переменное значение, которое должно соответствовать размеру рекламного места основного видео.
Если размеров несколько, они должны быть разделены вертикальной чертой (|).
Не добавляйте букву v после размера.
Примеры использования
Один размер: sz=400x300.
Несколько размеров: sz=300x250|400x300.
Требования и рекомендации
Этот параметр является обязательным при показе объявлений на сайтах, в мобильных приложениях, на подключенных телевизорах и инвентаре для цифровой наружной рекламы.
Этот параметр необязателен, только если в запросе указывается значение ad_type=audio.
unviewed_position_start (отложенные показы)
Описание
Параметр "Отложенные показы" (unviewed_position_start) принимает постоянное значение, которое сообщает о возможности отложенных показов видео.
Примеры использования
unviewed_position_start=1
Требования и рекомендации
Этот параметр является обязательным при размещении объявлений на сайтах и в мобильных приложениях, если возможны отложенные показы.
url (URL)
Описание
Параметр "URL" (url) принимает переменное значение, соответствующее полному URL, с которого поступил запрос. Это значение позволяет покупателям определять контекст запроса. Мы рекомендуем указывать это значение динамически при отправке запроса объявления.
- При показе на сайтах значением этого параметра является URL страницы с видеопроигрывателем.
- При показе на других платформах значением должен быть URL, который наиболее точно соответствует видео- или аудиоинвентарю, на котором размещается реклама. Примером может быть ситуация, когда пользователь смотрит видеоролик в мобильном приложении, который также доступен по URL на сайте*.
Примечание. Параметр url отличается от description_url тем, что url указывает, откуда поступил запрос объявления, а description_url является адресом веб-страницы, которая содержит описание видеоконтента и может быть просканирована поисковыми роботами.
Значение этого параметра должно быть закодировано.
Примеры использования
url=https%3A%2F%2Fexample.com%2Fvideo.html
* Если показ выполняется в приложении и для этого параметра невозможно задать переменное значение URL, мы рекомендуем использовать такой шаблон: url=https%3A%2F%2F<app/bundleid>.example.com
Требования и рекомендации
Этот параметр обязателен только при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.
Использование в SDK
Если вы используете IMA SDK, значение URL задается автоматически. Если это значение устанавливается вашим проигрывателем, оно будет учитываться в IMA SDK.
Обязательные параметры для алгоритмических продаж
ott_placement (место размещения OTT)
Описание
Параметр места размещения OTT (ott_placement) принимает постоянное значение, которое указывает, что объявление запрашивается по технологии ОТТ для места размещения вне проигрывателя.
В примерах ниже используются места размещения следующих форматов:
- Пауза. Объявление Out-Stream, которое показывается как оверлей поверх видеоконтента, когда пользователь приостанавливает воспроизведение.
- Главный экран. Объявление, которое появляется на главном экране подключенного телевизора или приложения с технологией OTT. Может показываться как masthead, баннер или плитка.
- Картинка в картинке. Видеообъявление In-Stream, которое показывается в отдельном видеопроигрывателе рядом с основным контентом. Обычно для него требуется сжатие видеоконтента и загрузка второго видеопроигрывателя.
- L-баннер. Медийное объявление In-Stream, при показе которого основное видео сжимается, а объявление окружает его. Например, оно часто показывается в окне в форме буквы L.
- Оверлей. Любой формат объявления In-Stream, который показывается поверх видеоконтента, но не занимает весь экран. Это может быть медийное или видеообъявление.
Примеры использования
Поддерживаемые форматы и соответствующие значения:
Пауза:ott_placement=1
Главный экран:ott_placement=2
Картинка в картинке:ott_placement=3
L-баннер:ott_placement=4
Оверлей:ott_placement=5
Специальный или другой формат:ott_placement=99
Требования и рекомендации
Этот параметр требуется только при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях и на подключенных телевизорах у издателей, которые монетизируют нестандартные места размещения объявлений при потоковой передаче по технологии OTT.
plcmt (размещение объявлений)
Описание
Параметр "Место размещения" (plcmt) принимает постоянное значение, которое указывает, объявляется ли видеореклама In-Stream как "Instream" или как "Accompanying (Сопутствующее объявление)" в соответствии со спецификациями IAB.
В запросах, не относящихся к видеорекламе In-Stream, значение параметра автоматически указывается для покупателей на основании заявленного формата инвентаря, который переопределяет любое объявление, объявленное как "Instream" или "Accompanying".
Примеры использования
Запрос In-Stream:plcmt=1
Запрос сопутствующего контента:plcmt=2
Требования и рекомендации
Этот параметр является обязательным при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.
vpa (автоматическое воспроизведение)
Описание
Параметр, который относится к автоматическому воспроизведению видео (vpa), принимает постоянное значение. Оно указывает, запускается ли рекламный ролик самостоятельно или только после нажатия на него.
Допустимые значения: click (если требуется действие пользователя) и auto (если видео воспроизводится автоматически). Этот параметр не влияет на статус видеопроигрывателя, и управление воспроизведением осуществляется в самом проигрывателе.
Примеры использования
Автовоспроизведение:vpa=auto
Воспроизведение по клику:vpa=click
Если значение этого параметра неизвестно, задавать его не нужно.
Требования и рекомендации
Этот параметр является обязательным при показе рекламы в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах и в аудиоконтенте.
Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.
vpmute (воспроизведение без звука)
Описание
Параметр "Воспроизведение видео без звука" (vpmute) принимает постоянное значение, которое указывает, начинается ли воспроизведение объявления, если в видеопроигрывателе выключен звук. Этот параметр не влияет на статус видеопроигрывателя, и управление воспроизведением осуществляется в самом проигрывателе.
Примеры использования
Воспроизведение начинается при отключенном звуке:vpmute=1
Воспроизведение начинается при включенном звуке:vpmute=0
Требования и рекомендации
Этот параметр является обязательным при размещении в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконенте и на инвентаре для цифровой наружной рекламы.
Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.
Рекомендуемые параметры для алгоритмических продаж
aconp (непрерывное воспроизведение аудио)
Описание
Параметр "Непрерывное воспроизведение аудио" (aconp) принимает постоянное значение, которое указывает, будет ли аудиоконтент воспроизводиться непрерывно. В Google Менеджер рекламы этот параметр позволяет подбирать самые удобные объявления.
Примеры использования
Непрерывное воспроизведение включено:
aconp=2
Непрерывное воспроизведение выключено:
aconp=1
Если вам неизвестно, непрерывно ли воспроизводится объявление, задайте для данного параметра значение aconp=0 или совсем не указывайте его.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование этого параметра рекомендовано руководствами по работе с данными об аудиорекламе, подготовленными Советом по медиаизмерениям.
dth (подсказка о типе устройства)
Описание
Параметр "Подсказка о типе устройства" (dth) принимает постоянное значение, которое помогает точнее распознавать устройства, в частности подключенные телевизоры и телеприставки.
Некорректное распознавание устройств может быть обусловлено ошибками со стороны издателей или производителей подключенных телевизоров. Используя этот параметр одновременно с другими сигналами, Google может автоматически помечать ситуации, в которых необходимо повторно классифицировать инвентарь на подключенных телевизорах.
Примеры использования
Источники запросов:
- Кнопочный телефон:
dth=1. - Смартфон:
dth=2. - Компьютер:
dth=3. - Планшет:
dth=4. - Подключенный телевизор:
dth=5. - Игровая приставка:
dth=6. - Телеприставка:
dth=7.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование SDK
Этот параметр рекомендуется для решений на основе библиотеки программного доступа (PAL) или инвентаря с аутентификацией на стороне издателя (PAI) и не требуется при работе с IMA SDK или DAI SDK.
givn (однократное воспроизведение видео)
Описание
Если вы работаете с библиотекой Programmatic Access Library (PAL), то параметр с однократно используемым числом для видеообъявления принимает переменное строковое значение.
Однократно используемое число не требует кодирования при добавлении в URL.
Примечание. Если ранее вы добавляли однократно используемое число, используя устаревший параметр paln, то мы рекомендуем отказаться от него и перейти на параметр givn. Также не следует добавлять оба этих параметра.
Примеры использования
Более подробную информацию о том, какое значение передается при использовании этого параметра, можно найти в руководстве по началу работы с библиотекой PAL.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
hl (язык)
Описание
Параметр "Язык" (hl) принимает постоянное значение, используемое для запроса рекламы на этом языке, а также для выбора языка, который используется при выборе и отрисовке объявлений при динамическом размещении видеорекламы с помощью Ad Exchange и AdSense.
Примеры использования
Запрос объявлений на итальянском языке:
hl=it
Значением параметра может быть двухбуквенный код по стандарту ISO 639-1 или трехбуквенный код по стандарту ISO 639-2. Ознакомьтесь со списком допустимых кодов.
Если этот параметр не указан, то используется языковой таргетинг в Ad Exchange.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
omid_p (название партнера, использующего OMID API)
Описание
Параметр "Название партнера, использующего OMID API" (omid_p) принимает переменное значение, которое включает название организации-партнера, применяющей OMID для отслеживания, и версию ее системы.
Параметр "Поддерживаемые SDK API" (sdk_apis) принимает переменное значение: либо название одного поддерживаемого API, либо их список, разделенный запятыми.
Эти параметры – части набора параметров, которые обеспечивают видимость и проверку объявлений.
Примеры использования
Без использования библиотеки PAL:omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Список возможных значений приведен на сайте GitHub.
При использовании библиотеки PAL:request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах, в аудиоконтенте и на инвентаре для цифровой наружной рекламы.
Использование SDK
- Этот параметр доступен только издателям, которые хотят при работе с Open Measurement SDK (OM SDK) использовать отслеживание Active View.
- Чтобы при использовании библиотеки Programmatic Access Library (PAL) сообщить о поддержке OMID, необходимо указать название организации-партнера (
omidPartnerName) и версию ее системы (omidPartnerVersion). Если вы не используете PAL или IMA SDK, вам потребуется задать параметрыomid_pиsdk_apis. - Они не нужны, если вы используете IMA SDK, поскольку в этом случае они задаются автоматически.
vconp (непрерывное воспроизведение видео)
Описание
Параметр "Непрерывный просмотр видео" (vconp) принимает постоянное значение, которое указывает, будет ли проигрыватель воспроизводить видео непрерывно, как при вещании по телевизору.
Примеры использования
Непрерывное воспроизведение включено:vconp=2
Непрерывное воспроизведение выключено:vconp=1
Если значение этого параметра неизвестно, задавать его не нужно.
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при размещении объявлений в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах и в аудиоконтенте.
Использование этого параметра рекомендовано руководствами по работе с данными о видеорекламе, подготовленными Советом по медиаизмерениям.
vid_d (продолжительность видео)
Описание
Параметр "Длительность видео" (vid_d) принимает переменное значение, которое указывает на длительность контента в секундах.
- Параметры
vid_dиallcuesпредназначены для показа объявлений в середине ролика без использования передачи контента. - Правила для объявлений обязательны, если вы намерены показывать рекламу в середине видео. Если в правилах для объявлений используются точки с временным условием (например: "Каждые N секунд" или "В определенные моменты" и т. д.), то будут игнорироваться временные точки, передаваемые с помощью параметра
allcues. Для видеорекламы в середине ролика должна задаваться определенная длительность, поэтому параметрvid_dтоже будет использоваться.
Примеры использования
Длительность видеоконтента, равная 90 000 секунд (25 часов):vid_d=90000
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при размещении объявлений в рамках алгоритмических продаж на сайтах, в мобильных приложениях и на подключенных телевизорах.
vpos (позиция видео)
Описание
Параметр "Позиция видео" (vpos) принимает постоянное значение, которое указывает, где должно быть размещено объявление: в начале, в середине или в конце видеоролика.
Примеры использования
Размещение в начале ролика:vpos=preroll
Размещение в середине ролика:vpos=midroll
Размещение в конце ролика:vpos=postroll
Требования и рекомендации
Хотя этот параметр не является обязательным для какого-либо способа внедрения рекламы, его рекомендуется использовать при размещении объявлений в рамках алгоритмических продаж на сайтах, в мобильных приложениях, на подключенных телевизорах и в аудиоконтенте.
Если используются правила для объявлений, этот параметр не требуется, поскольку он добавляется сервером объявлений автоматически.
wta (почему я вижу эту рекламу)
Описание
Параметр "Почему я вижу эту рекламу?" (wta) принимает постоянное значение, которое указывает на то, что в видеопроигрывателе поддерживается пометка рекламы.
Примеры использования
Если проигрыватель должен отображать значок "Выбор рекламы" из ответа VAST, используйте следующее значение:
wta=1(также можно опустить параметрwtaили передаватьwtaбез значения).Если значок "Выбор рекламы" из ответа VAST будет добавлен в сопутствующее объявление или показан пользователю иным образом, в запросе аудиорекламы должен быть задан параметр
wta=1.
Если значок "Выбор рекламы" из ответа VAST не должен показываться в проигрывателе, используйте следующее значение:
wta=0
Требования и рекомендации
Хотя ни один из вариантов реализации и не требует задавать этот параметр, его рекомендуется использовать при алгоритмических продажах на сайтах, в мобильных приложениях, на подключенных телевизорах и аудиоинвентаре.
Если этот параметр используется, происходит следующее:
- При значении
&wta=0нельзя использовать некоторые типы персонализации для трафика из источников спроса Google. - При значении
&wta=0нельзя показывать креативы с включенными пометками рекламы, если трафик происходит из ЕЭЗ, а реклама размещается в рамках резервирования или гарантированных кампаний с алгоритмической продажей, управляемых издателем.
Объявления, которые показываются в Европейской экономической зоне (ЕЭЗ), должны соответствовать действующим нормативным требованиям. В частности, пользователям должна предоставляться возможность пожаловаться на противозаконный контент. Издатели обязаны уведомлять Google о любом противозаконном контенте, используя форму Сообщить о контенте в Google.
Использование SDK
При использовании IMA SDK пометка рекламы поддерживается автоматически. Если вы не работаете с IMA SDK, то в проигрывателе должна быть реализована поддержка объектов VASTIcon и IconClickFallbackImage в соответствии со стандартом IAB.