Эта страница переведена с помощью Cloud Translation API.

Видеообъявления

В этом руководстве описаны требования к интеграции, конфигурации и соответствующие поля протокола OpenRTB, которые вы можете использовать при размещении ставок на видеоресурсы. Протокол Google RTB устарел и не будет рассматриваться в этом руководстве. Информацию о видеорекламе в протоколе Google RTB см. в руководстве «Видеореклама в Google RTB».

Google поддерживает In-Stream, нативную и межстраничную видеорекламу. Дополнительные сведения об этих форматах см. в руководствах по форматам нативной и межстраничной рекламы.

Требования покупателя

RTB-протокол

В этом руководстве обычно используется формат Protobuf, но имена полей и пути в нем и в формате JSON эквивалентны, если не указано иное.

Вы можете найти прототип OpenRTB и расширения OpenRTB, специфичные для Google, на странице прототипов и справочных данных . Дополнительные сведения о разработке системы торгов см. в разделе «Обработка запроса и построение ответа» .

Креативный обзор

Google рекомендует отправлять креативы на утверждение, прежде чем предлагать им цену. Чтобы начать процесс проверки, вы можете использовать ресурс Creatives API для назначения ставок в реальном времени.

Конфигурация предварительного таргетинга

Чтобы получать видеоресурсы, в вашем аккаунте Авторизованных покупателей необходимо создать конфигурацию предварительного таргетинга , включающую видеоресурсы.

Макросы

Вы можете указать макросы либо в URL-ссылке видео, либо в XML-коде VAST, указанном в BidResponse.seatbid.bid.adm . Кроме того, если вы укажете URL-адрес видео, вы также можете разместить макросы в связанном XML-документе VAST. Для видеообъявлений поддерживаются следующие макросы:

%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%

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

Детали уточнения

Вы можете использовать поле BidRequest.imp.video OpenRTB, чтобы определить, предназначен ли входящий запрос ставки для потокового или межстраничного видеоинвентаря, а также найти дополнительную информацию о запросе, относящуюся к видео. Кроме того, для ресурсов нативной рекламы вы можете использовать BidRequest.imp.native.{request/request_native}.assets.video для получения аналогичной информации, относящейся к видео.

BidRequest.{app/site}.content.producer.domain

URL-адрес страницы с описанием видеоконтента (без параметров). Издатель отправляет этот URL в Google. Например:

http://www.publisher.com/watchpagelink

banner.vcm

Если установлено значение true , сопутствующее объявление можно выбрать для отображения в виде заставки (информационной карточки) в видеослоте после завершения воспроизведения видеообъявления. В противном случае сопутствующее объявление не будет отображаться как заставка.

BidRequest.imp.rwdd

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

BidRequest.imp.video.maxduration

Максимально допустимая продолжительность объявления в секундах, которое вы должны вернуть. Если параметр не установлен, максимальная продолжительность отсутствует. Если BidRequest.imp.video.skip имеет true , это может вести себя по-другому. Дополнительную информацию см. в разделе «Максимальная продолжительность видео с возможностью пропуска» .

BidRequest.imp.video.maxseq

Максимальное количество рекламы в видеоподдержке. Если этот параметр не установлен, рекламное место не является частью модуля видео.

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

BidRequest.imp.video.minduration

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

BidRequest.imp.video.plcmt

Описывает, где будет воспроизводиться видео.

`PLCMT_UNKNOWN`	Местонахождение неизвестно или невозможно определить.
`PLCMT_INSTREAM`	Рекламные объявления в начале, середине и конце ролика, которые воспроизводятся до, во время или после потокового видеоконтента, запрошенного потребителем. Для потокового видео по умолчанию при запуске проигрывателя должен быть включен звук, либо должно быть явно указано намерение пользователя просмотреть видеоконтент. Хотя вокруг плеера может быть и другой контент, видеоконтент должен быть в центре внимания пользователя. Он должен оставаться основным содержимым на странице и единственным видимым видеоплеером, способным воспроизводить звук при воспроизведении. Если проигрыватель преобразуется в плавающий/прикрепленный, последующие вызовы рекламы должны точно передавать обновленный размер проигрывателя.
`PLCMT_ACCOMPANYING_CONTENT`	Реклама в начале, середине и конце ролика, которая воспроизводится до, во время или после потоковой передачи видеоконтента. Видеоплеер загружается и воспроизводится до, между или после абзацев текстового или графического содержимого и начинает воспроизведение только при входе в область просмотра. Сопровождающий контент должен начинать воспроизведение только при входе в область просмотра. Он может преобразоваться в плавающий/прикрепляемый проигрыватель при прокрутке страницы.
`PLCMT_INTERSTITIAL`	Видеообъявления, которые воспроизводятся без видеоконтента. Во время воспроизведения он должен быть в центре внимания страницы, занимать большую часть области просмотра и не может быть прокручен из поля зрения. Это могут быть такие места размещения, как видео в приложении или слайд-шоу.
`PLCMT_NO_CONTENT_STANDALONE`	Видеообъявления, которые воспроизводятся без потоковой передачи видеоконтента. Это может быть в таких местах размещения, как слайд-шоу, собственные каналы, внутри контента или прикрепленные/плавающие.

BidRequest.imp.video.playbackmethod

Описывает, как воспроизвести видеорекламу. Метод воспроизведения определяется как автоматическое воспроизведение или воспроизведение по щелчку на основе лучших доступных измерений.

`AUTO_PLAY_SOUND_ON`	Инициируется при загрузке страницы со звуком.
`AUTO_PLAY_SOUND_OFF`	Запускается при загрузке страницы с выключенным звуком.
`CLICK_TO_PLAY`	Запускается по клику со звуком.
`MOUSE_OVER`	Запускается при наведении курсора мыши и включенном звуке.
`ENTER_SOUND_ON`	Запускается при входе в область просмотра с включенным звуком.
`ENTER_SOUND_OFF`	Запускается при входе в область просмотра со звуком по умолчанию.

BidRequest.imp.video.skip

Если true , это означает, что проигрыватель разрешит пропуск видео или что разрешена реклама с возможностью пропуска. В противном случае это означает, что объявления с возможностью пропуска запрещены.

BidRequest.imp.video.startdelay

Значение 0 означает рекламу в начале ролика, -1 – в середине ролика, а -2 — в конце ролика.

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

Эти сигналы не являются уникальными для видеокреативов, но они особенно ценны для участников торгов:

BidRequest.device.ifa

Это поле представляет собой 36-значный UUID, который задается только при использовании SSL и не хэшируется. Это незашифрованная версия BidRequest.device.dpidm5 . Для устройств iOS он содержит идентификатор рекламодателя (IDFA) в верхнем регистре. Для устройств Android он содержит идентификатор Android (ADID) в нижнем регистре. Для устройств Connected TV он содержит их уникальные идентификаторы (например, RIDA от Roku).

BidRequest.device.devicetype

Указывает тип устройства.

`MOBILE`	Устаревший псевдоним для HIGHEND_PHONE или TABLET.
`PERSONAL_COMPUTER`	Включает в себя настольные и портативные устройства.
`CONNECTED_TV`	включает как подключенные телевизоры (то есть смарт-телевизоры), так и подключенные устройства (такие как Roku, Apple TV и т. д.).
`HIGHEND_PHONE`	Включает в себя высококачественные телефонные устройства.
`TABLET`	Включает планшетные устройства.
`CONNECTED_DEVICE`	Включает в себя специальные игровые устройства.
`SET_TOP_BOX`	Включает в себя телевизионные приставки.
`OOH_DEVICE`	Включает в себя устройства наружной рекламы; например, цифровые рекламные щиты.

BidRequest.device.make

Указывает марку устройства (например, Nokia или Samsung).

BidRequest.device.model

Указывает точную модель (например, N70 или Galaxy) устройства, если она доступна, в противном случае указывается общая модель, например «iphone» или «ipad».

BidRequest.imp.metric

Если для Metric.type установлено значение completion_rate , Metric.value будет дробью в диапазоне [0,0, 1,0], представляющей исторический показатель завершения видеообъявлений, показываемых в рекламном месте. Значение по умолчанию -1.0 указывает, что исторические данные о проценте завершения недоступны.

BidRequest.imp.video.poddur

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

Запрос ставки для видео также содержит информацию об инвентаре, такую как тематика, разрешенные поставщики и информация о канале. Все остальные существующие поля в запросе ставки также применимы к видео.

Поля ширины и высоты в сообщении AdSlot запроса видео соответствуют размеру проигрывателя видеорекламы.

BidRequest.imp.ext.allowed_vendor_type: Разрешенные продавцы. Список идентификаторов см. в файлеvendors.txt в технической документации. Например, 309 = видеоблок DFA.
BidRequest.imp.video.mimes: Белый список, описывающий поддерживаемые типы MIME контента для объявлений, показываемых в ответ на запрос ставки; например, «видео/mp4». В ответе на заявку должна быть указана поддержка хотя бы одного из них.

BidRequest.imp.video.protocols: Описывает поддерживаемые издателем версии VAST для запросов видеорекламы. Содержит массив значений перечисления Protocol , включая: VAST_2_0 , VAST_3_0 , VAST_2_0_WRAPPER , VAST_3_0_WRAPPER , VAST_4_0 , VAST_4_0_WRAPPER и другие.

BidRequest.imp.video.companionad: Это поле включает в себя массив объектов Banner представляющих сопутствующие рекламные объявления, если они доступны.
BidRequest.site.page: URL-адрес страницы просмотра видео или URL-адрес страницы, в которую встроено видео. Например:
http://www.publisher.com/watchpagelink

При ответе на запрос видео система назначения ставок должна вернуть URL-адрес перенаправления VAST или XML-код VAST в поле BidResponse.seatbid.bid.adm . Ответ на заявку также должен содержать соответствующее объявление для видеорекламы. Ниже приводится отрывок из правильного ответа на заявку на видео:

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Важными полями в ответе на ставку для видео являются следующие:

BidResponse.seatbid.bid.ext.attribute

Атрибуты объявлений, которые могут показываться из этого фрагмента. Список идентификаторов см. в файле buy-declarable-creative-attributes.txt . Мы проверяем, чтобы ни один из этих атрибутов не соответствовал атрибутам, запрещенным издателем в запросе ставки. Например, если в любом из полей указано значение 30 , это будет означать, что для показа объявления требуется поддержка VPAID.

BidResponse.seatbid.bid.adm

Для видеообъявлений это URL-адрес перенаправления VAST видеообъявления. Например:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

Альтернативно это может быть необработанный XML-файл VAST.

Примеры запросов ставок и ответов

Видео форматы

Как покупатели могут включать видео
Рекомендуемые OpenRTB сигналы для всех видеоформатов
Прототип рекомендуемых авторизованными покупателями сигналов для всех видеоформатов
Как издатели могут разрешить/запретить видео
Краевые случаи

Как покупатели могут включать видео

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

Интернет

Видеокреатив	Инстрим (все)	В ленте/статья	Нативный фид/статья	Межстраничный	В баннере
VPAID + VAST
ОГРОМНЫЙ
МРАИД + JS
Пользовательский JS
Нативный + VAST

Мобильное приложение

Видеокреатив	Инстрим (все)	В ленте/статья	Нативный фид/статья	Межстраничный	В баннере
VPAID + VAST
ОГРОМНЫЙ
МРАИД + JS
Пользовательский JS
Нативный + VAST

Ключ:	Формат/технология недоступна.		Видеообъявление, принятое в этом месте размещения, подлежит блокировке со стороны издателя.		Видеообъявление недоступно в этом месте размещения.

Формат видео	Рекомендуемые сигналы (только сигналы, относящиеся к видео)	Связанные сигналы (только сигналы, относящиеся к видео)
Инстрим (VPAID)	ВИДЕО объект присутствует и `video.placement = INSTREAM &`
In-Stream (без VPAID)	ВИДЕО объект присутствует и `video.placement = INSTREAM & video.api = 1 VPAID 1.0 or 2:VPAID 2.0`
Непотоковое	Объект ВИДЕО присутствует `video.linearity: linear` размещение зависит от фактического размещение, значения указаны ниже `Video.startdelay = 0`
Подача	ВИДЕО объект присутствует и `video.placement = IN-FEED`
В статье	ВИДЕО объект присутствует и `video.placement = IN-ARTICLE`
Родной	РОДНОЙ объект присутствует и
В баннере	Видеообъект отсутствует & `banner.battr ≠ 6` видео в баннере (автовоспроизведение) и `banner.battr ≠ 7` видео в баннере (по инициативе пользователя)

Формат видео	Подробности запроса ставки (только сведения, относящиеся к видео)
Инстрим	ВИДЕО объект присутствует и `video.placement = INSTREAM &`	`video.api = 1` VPAID 1.0 или `2` : VPAID 2.0
Непотоковое	Объект ВИДЕО присутствует `video.linearity: linear` размещение зависит от фактического размещение, значения указаны ниже `Video.startdelay = 0`
Подача	ВИДЕО объект присутствует и `video.placement = IN-FEED`
В статье	ВИДЕО объект присутствует и `video.placement = IN-ARTICLE`
Родной	РОДНОЙ объект присутствует и
Межстраничное объявление (VAST)	ВИДЕО объект присутствует и `video.placement = INTERSTITIAL`
Межстраничное объявление (без VAST)	ВИДЕО объект присутствует и `video.placement = INTERSTITIAL`	Отфильтровано
Внутрибаннер (MRAID)	Видеообъект отсутствует & `banner.battr ≠ 6` видео в баннере (автовоспроизведение) и `banner.battr ≠ 7` видео в баннере (по инициативе пользователя)
В баннере (без MRAID)	Видеообъект отсутствует & `banner.battr ≠ 6` видео в баннере (автовоспроизведение) и `banner.battr ≠ 7` видео в баннере (по инициативе пользователя)

Как издатели могут разрешить/запретить видео

В следующей таблице показаны способы, с помощью которых издатели могут разрешать/запрещать использование видео в своих местах размещения.

Вариант паба	Применимые форматы	Описано в запросе ставки как
Укажите единицу видео Instream	Инстрим (все)	Видеообъект присутствует и `video.placement = INSTREAM`
Включите VPAID	In-Stream веб-сайт	Видеообъект присутствует и `video.api = 1` (VPAID 1.0) или `2` (VPAID 2.0)
Включите IBV	В баннере Межстраничный	`banner.battr ≠ 6` видео в баннере (автовоспроизведение) и/или `7` видео в баннере (по инициативе пользователя)
Подписаться ( инструкции )	Подача В статье	Видеообъект присутствует и `video.placement = IN-FEED` или `IN-ARTICLE`
Как включить не-In-Stream ( инструкции )	Родной	Родной объект присутствует
Блокировать межстраничное видео	Межстраничное приложение	Объект ВИДЕО отсутствует

Краевые случаи

#	Описание случая	Комментарии	Запрос ставки
1	Отложенное пользовательское закрытие с использованием MRAID	Для межстраничных объявлений при закрытии объявления покупателю может быть отправлено уведомление с помощью MRAID, даже если он не использовал пользовательское закрытие. Примененный X авторизованными покупателями всегда будет отображаться поверх любого индивидуального закрытия, даже если пользовательское завершение появится под ним через 5 секунд.

Описание случая

Комментарии

Запрос ставки

Отложенное пользовательское закрытие с использованием MRAID

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

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

Глоссарий

См . видео-глоссарий Авторизованных покупателей .

Соответствующие поля для форматов Instream и Non-Instream.

См. OpenRTB 2.5 (начиная со стр. 47).

Запрос ставки.Видео.

Placement

Инстрим

mWeb

1 : В потоке
2 : В баннере

mApp

1 : В потоке
2 : В баннере

Непотоковое

mApp Interstitial

5 : Межстраничный

Native

3 : В статье
4 : Подача

Rewarded

is_rewarded_inventory : Расширение OpenRTB bool

linearity

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

Инстрим

mWeb

1 : LINEAR (в потоке)

mApp

1 : LINEAR (в потоке)

Непотоковое

mApp Interstitial

2 : INTERSTITIAL

Native

3 : IN_FEED
5 : IN_ARTICLE

videoad_start_delay

Инстрим

mWeb

>0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL

Непотоковое

Rewarded

>0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL

Источник значения запроса ставки

OpenRTB Объект	Поля	Авторизованные покупатели /Обмен Торги Непотоковое	Примеры значений	Кто это определяет? /Откуда берется это значение от?
Объект
Видео	мимы	да	["приложение/Javascript", "видео/mp4"]",	Google
	умопомешательство	нет		Издатель настроен
	максимальная продолжительность	да		Издатель настроен
	воспроизведениемет ход	да	[6]	Обычно издатель Настроено
	API (MRAID)	да	[1,2]	Google
	протоколы	да	[2,3,5,6,7,8]	Google
	линейность	да	[1]	Google
	размещение	да	[1]	Google
	ширина плеера	да	400 400 300	Google
	рост игрока	да	225 300 153	Google
	задержка начала	да	0	Google, по умолчанию 5 секунд
	пропускать	да	1	Издатель/Google - для межстраничных объявлений => Google - для Instream => Издатель решает, разрешить ли с возможностью пропуска, без возможности пропуска или и то, и другое. Реклама с вознаграждением, всегда без пропуска;
	минимальный битрейт	Нет		Google
	максимальный битрейт	нет		Google
	позиция	да	1	Google
Устройство
	Коэффициент пикселей	да	1	Google
впечатление
	Безопасный	да	1	Google по умолчанию true потому что рекламный тег всегда безопасный

Видеообъявления

Требования покупателя

RTB-протокол

Креативный обзор

Конфигурация предварительного таргетинга

Макросы

Детали уточнения

Примеры запросов ставок и ответов

Видео форматы

Как покупатели могут включать видео

Интернет

Рекомендуемые сигналы OpenRTB

Рабочий стол и мобильный Интернет

Мобильное приложение

Как издатели могут разрешить/запретить видео

Краевые случаи

Глоссарий

Соответствующие поля для форматов Instream и Non-Instream.

Источник значения запроса ставки