С запуском поддержки видеорекламы покупатели смогут приобретать видеоресурсы через Авторизованные покупатели. В этом документе изложены требования к интеграции для покупок через RTB с использованием протокола Авторизованных покупателей. Информацию о доступных протоколах см. в разделе «Выбор протокола» руководства «Начало работы».
Покупатели могут приобретать видеоресурсы в разных местах размещения, включая In-Stream и межстраничные объявления. Подробнее см. в разделе Межстраничная реклама .
Требования покупателя
Новым покупателям RTB следует разрабатывать свои системы назначения ставок, используя последний буфер протокола и информацию, изложенную в следующих разделах. Чтобы загрузить протокол, посетите страницу справочных данных о торгах в режиме реального времени . Информацию о разработке системы торгов см. в разделе «Обработка запроса и построение ответа» .
Поддерживаемые макросы
В видеокреативах In-Stream поддерживаются следующие макросы:
-
%%CACHEBUSTER%%
-
%%WINNING_PRICE%%
-
%%SITE%%
Макросы кликов (например, CLICK_URL_ESC
) не нужны, поскольку авторизованные покупатели включают свои средства отслеживания кликов в оболочку VAST. Поэтому макросы кликов не поддерживаются для видеообъявлений In-Stream. Дополнительные сведения о поддерживаемых макросах см. в разделе «Указание макросов» в разделе «Построение ответа» .
Детали уточнения
Протокол назначения ставок в реальном времени использует видеосообщение, определенное в файле real-time-bidding-proto.txt, для идентификации видеозапросов и предоставления дополнительной информации, относящейся к видео, о запросе.
Следующий список полей во вложенном видеосообщении также содержит подробные описания и примеры:
-
description_url
URL-адрес страницы с описанием видеоконтента (без параметров). Издатель отправляет этот URL в Google. Например:
http://www.publisher.com/watchpagelink
EndCapSupport
- Если этот параметр включен, сопутствующее объявление можно выбрать для отображения в виде заставки (информационной карточки) в видеослоте после завершения воспроизведения видеообъявления.
END_CAP_NOT_ENABLED
Сопутствующее объявление не отображается в конце. END_CAP_OPTIONAL
Конец отображается, если ответ содержит подходящий сопутствующий баннер, но сопутствующий баннер не является обязательным. END_CAP_FORBIDDEN
Ответ с сопутствующим объявлением фильтруется. END_CAP_REQUIRED
Ответ без сопутствующего объявления фильтруется. -
is_embedded_offsite
- Если для этого параметра установлено значение
true
, видео встраивается на страницы за пределами домена издателя. -
is_rewarded
- Если установлено значение
true
, это означает, что пользователь получает вознаграждение за просмотр видеообъявления. Типичными наградами могут быть бесплатное прочтение дополнительной статьи, получение дополнительной жизни в игре или спонсируемая музыкальная сессия без рекламы. -
max_ad_duration
Максимально допустимая продолжительность возвращаемого объявления в миллисекундах. Если установлено значение
0
, максимальная продолжительность отсутствует.-
max_ads_in_pod
- Максимальное количество объявлений в блоке видео Авторизованных покупателей. Ненулевое значение указывает, что текущее рекламное место представляет собой видеомодуль, который может показывать несколько видеообъявлений. Фактическое количество показанных видеообъявлений может быть меньше или равно этому значению, но не может превышать его.
-
min_ad_duration
- Минимальная продолжительность объявления в миллисекундах, которое вы должны вернуть. Если этот параметр не установлен или имеет значение меньше или равно нулю, минимальной продолжительности не существует.
-
Placement
- Описывает, где будет воспроизводиться видео.
UNKNOWN_PLACEMENT
Местонахождение неизвестно или невозможно определить. INSTREAM
In-Stream означает, что реклама воспроизводится до, во время или после другого видеоконтента. Это похоже на традиционную телевизионную рекламу. Видеоконтент, который просматривает пользователь, не воспроизводится во время воспроизведения рекламы. INTERSTITIAL
Межстраничное объявление означает, что видеореклама воспроизводится поверх невидеоконтента (например, новостной статьи или видеоигры). Реклама занимает все или почти все пространство на экране, занимаемое контентом, и пользователь не может перейти к контенту до тех пор, пока реклама не будет завершена или не будет пропущена. IN_FEED
Формат видео в фиде — это видеообъявление, которое показывает, когда пользователь прокручивает ленту контента (обычно ленту социальных приложений, новостную статью и т. д.). Видео отображается в основном ленте, а также в поле зрения пользователя и в процессе чтения. . Видео не отображается сбоку, как видео в баннере. -
skippable_max_ad_duration
- Максимальная продолжительность объявления в миллисекундах, которую следует вернуть, если это объявление можно пропустить. Обычно это отличается от максимальной продолжительности, разрешенной для объявлений без возможности пропуска. Если это поле не установлено или имеет значение меньше или равно нулю, допускается любая длительность.
-
VideoPlaybackMethod
- Описывает, как воспроизвести видеорекламу. Метод воспроизведения определяется как автоматическое воспроизведение или воспроизведение по щелчку на основе лучших доступных измерений.
AUTO_PLAY_SOUND_ON
означает, что реклама воспроизводится автоматически со звуком. AUTO_PLAY_SOUND_OFF
означает, что реклама воспроизводится автоматически без звука. CLICK_TO_PLAY
означает, что объявление не воспроизводится, пока на него не нажмут. -
video_ad_skippable
- Это значение
SkippableBidRequestType
, которое содержит одно из следующих значений:ALLOW_SKIPPABLE
означает, что разрешены объявления как с возможностью пропуска, так и без нее. REQUIRE_SKIPPABLE
означает, что могут быть возвращены только объявления с возможностью пропуска. BLOCK_SKIPPABLE
означает, что могут быть возвращены только объявления без возможности пропуска. По умолчанию, если это поле не установлено, разрешена реклама с возможностью пропуска.
-
videoad_start_delay
Время в миллисекундах от начала видео до момента показа рекламы. 0 означает предпрокрутку, а -1 означает послепрокрутку. Любые другие положительные значения указывают на то, что слот находится в середине видео.
Значение действительно, только если этот параметр установлен. Если не установлено, положение дисплея неизвестно.
Эти сигналы не являются уникальными для видеокреативов, но они особенно ценны для участников торгов:
-
advertising_id
- Это поле представляет собой 16-байтовый UUID, который задается только при использовании SSL. Это незашифрованная версия
encrypted_advertising_id
. Для устройств iOS он содержит идентификатор рекламодателя (IDFA). Для устройств Android он содержит идентификатор Android (ADID). Для устройств Connected TV он содержит их уникальные идентификаторы (например, RIDA от Roku). -
device_type
- Указывает тип устройства.
UNKNOWN_DEVICE
— значение по умолчанию для этого поля. HIGHEND_PHONE
включает мобильные телефоны с возможностью видеосъемки. TABLET
включает планшетные устройства. PERSONAL_COMPUTER
включает настольные и портативные устройства. CONNECTED_TV
включает как подключенные телевизоры (то есть смарт-телевизоры), так и подключенные устройства (такие как Roku, Apple TV и т. д.). GAME_CONSOLE
включает в себя специализированные игровые устройства. -
brand
- Указывает марку устройства (например, Nokia или Samsung). Это поле является необязательным; по умолчанию он не указан.
-
model
- Указывает точную модель (например, N70 или Galaxy) устройства. Это поле является необязательным; по умолчанию он не указан.
-
screen_orientation
- Определяет ориентацию устройства при отправке запроса объявления. Допустимые значения:
LANDSCAPE
,PORTRAIT
иUNKNOWN_ORIENTATION
. -
viewability
- Предоставляет оценку вероятности того, что этот слот будет доступен для просмотра конечному пользователю, исходя из того, как часто он был доступен для просмотра в прошлом. Выражается в процентах в диапазоне [0, 100]. Значение по умолчанию
-1
указывает, что исторические данные о видимости недоступны. -
content_attributes.duration_seconds
- Сколько секунд (например, 200) воспроизводится видео. Это объявлено в сообщении
ContentAttributes
. Для этого параметра установлено значение, указанное в метаданных видео, предоставленных издателем видео.
Запрос ставки для видео также содержит информацию об инвентаре, такую как тематика, разрешенные поставщики и информация о канале. Все остальные существующие поля в запросе ставки также применимы к видео.
Поля ширины и высоты в сообщении AdSlot запроса видео соответствуют размеру проигрывателя видеорекламы.
-
allowed_vendor_type
- Разрешенный поставщик. Список идентификаторов см. в файлеvendors.txt в технической документации. Например, 309 = видеоблок DFA.
-
allowed_video_formats
- Описывает разрешенные видеотехнологии для рекламы, показываемой в ответ на этот запрос. В ответе должна быть указана поддержка хотя бы одного из них. Значения этого повторяющегося поля берутся из перечисления VideoFormat:
VIDEO_FLASH
Позволяет воспроизводить видео в формате Flash Video (FLV). VIDEO_HTML5
Позволяет использовать видео в формате HTML5. VPAID_FLASH
Позволяет воспроизводить видео, используя формат Flash-видео Video Player Ad-Serving Interface Definition (VPAID). VPAID_JS
Разрешает видео в формате видео VPAID JavaScript . -
companion_slot
- Это поле представляет сообщение CompanionSlot, которое включает следующие поля:
height
Доступные высоты для этого слота. width
Доступная ширина для этого слота. CreativeFormat
Формат объявления представляет собой возможные форматы объявления в этом сопутствующем слоте. -
url
URL-адрес страницы просмотра видео или URL-адрес страницы, в которую встроено видео. Например:
http://www.publisher.com/watchpagelink
При ответе на запрос видео система назначения ставок должна вернуть URL-адрес перенаправления VAST в поле video_url
. Ответ на заявку также должен содержать соответствующее объявление для видеорекламы. Ниже приведен фрагмент правильного ответа на ставку видео:
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
Важными полями в ответе на ставку для видео являются следующие:
-
attribute
- Все атрибуты объявлений, которые могут отображаться из этого фрагмента. Список идентификаторов см. в файле buy-declarable-creative-attributes.txt . Мы проверяем, нет ли ни одного из этих атрибутов в списке
excluded_attribute
запроса ставки. Задавайте это поле только в том случае, если возвращается фрагмент HTML или видеообъявление. Например, если для этого поля установлено значение30
это означает, что для показа объявления требуется поддержка VPAID. -
protocol
- Описывает поддерживаемые издателем версии VAST для запросов видеообъявлений, разрешая рекламу VAST вплоть до указанной версии. Содержит набор поддерживаемых протоколов видеорекламы. Это соответствует поведению OpenRTB 2.4. Возможны следующие значения:
VAST_2_0
,VAST_3_0
,VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
иVAST_4_0_WRAPPER
. -
video_url
- URL-адрес перенаправления VAST видеообъявления. Например:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
- Как покупатели могут включать видео
- Рекомендуемые OpenRTB сигналы для всех видеоформатов
- Прототип рекомендуемых авторизованными покупателями сигналов для всех видеоформатов
- Как издатели могут разрешить/запретить видео
- Краевые случаи
Предварительный таргетинг
Чтобы получать видеоресурсы, покупатели RTB должны иметь конфигурацию предварительного таргетинга для RTB, включающую видеоресурсы.
Примеры запросов ставок и ответов
Форматы видео Ad Exchange
Как покупатели могут включать видео
В следующих таблицах показаны способы, с помощью которых покупатели могут включать видео в свои объявления и места размещения, где они могут показываться в Интернете и мобильных приложениях соответственно.
Интернет
Видеокреатив | Инстрим (все) | В ленте/статья | Нативный фид/статья | Межстраничный | В баннере |
---|---|---|---|---|---|
VPAID + VAST | |||||
ОГРОМНЫЙ | |||||
МРАИД + JS | |||||
Пользовательский JS | |||||
Нативный + VAST |
Мобильное приложение
Видеокреатив | Инстрим (все) | В ленте/статья | Нативный фид/статья | Межстраничный | В баннере |
---|---|---|---|---|---|
VPAID + VAST | |||||
ОГРОМНЫЙ | |||||
МРАИД + JS | |||||
Пользовательский JS | |||||
Нативный + VAST |
Ключ: | Формат/технология недоступна. | Видеообъявление, принятое в этом месте размещения, подлежит блокировке со стороны издателя. | Видеообъявление недоступно в этом месте размещения. |
---|
Рекомендуемые сигналы OpenRTB
В следующих таблицах показаны рекомендуемые OpenRTB сигналы для всех форматов видео для настольных компьютеров, мобильных устройств и мобильных приложений .
Рабочий стол и мобильный Интернет
Формат видео | Рекомендуемые сигналы (только сигналы, относящиеся к видео) | Связанные сигналы (только сигналы, относящиеся к видео) |
---|---|---|
Инстрим (VPAID) | ВИДЕО объект присутствует и | |
In-Stream (без VPAID) | ВИДЕО объект присутствует и | |
Outstream | Объект ВИДЕО присутствует | |
Подача | ВИДЕО объект присутствует и | |
В статье | ВИДЕО объект присутствует и | |
Родной | РОДНОЙ объект присутствует и | |
В баннере | Видеообъект отсутствует & |
Мобильное приложение
Формат видео | Подробности запроса ставки (только сведения, относящиеся к видео) | |
---|---|---|
Инстрим | ВИДЕО объект присутствует и | |
Outstream | Объект ВИДЕО присутствует | |
Подача | ВИДЕО объект присутствует и | |
В статье | ВИДЕО объект присутствует и | |
Родной | РОДНОЙ объект присутствует и | |
Межстраничное объявление (VAST) | ВИДЕО объект присутствует и | |
Межстраничное объявление (без VAST) | ВИДЕО объект присутствует и | Отфильтровано |
Внутрибаннер (MRAID) | Видеообъект отсутствует & | |
В баннере (без MRAID) | Видеообъект отсутствует & |
Рекомендуемые сигналы прототипа AdX
В следующих таблицах показаны прототипы рекомендуемых сигналов Авторизованных покупателей для всех форматов видео для настольных компьютеров, мобильных устройств и мобильных приложений .
Рабочий стол и мобильный Интернет
Формат видео | Рекомендуемые сигналы, релевантные для видео | Связанные сигналы, релевантные для видео |
---|---|---|
Инстрим (VPAID) | ВИДЕО-сообщение присутствует и | |
In-Stream (без VPAID) | ВИДЕО-сообщение присутствует и | Разрешенные_видео_форматы = VIDEO_HTML5 & |
Подача | ВИДЕО-сообщение присутствует и | Разрешенные_видео_форматы = VIDEO_HTML5 & |
В статье | ВИДЕО-сообщение присутствует и | |
Родной | РОДНОЕ сообщение присутствует и | |
В баннере | | |
Мобильное приложение
В следующих таблицах показаны рекомендуемые сигналы прототипа AdX для всех форматов видео для настольных компьютеров, мобильных сайтов и мобильных приложений .
Формат видео | Подробности запроса ставки, относящиеся к видео | Сигналы, относящиеся к видео |
---|---|---|
Инстрим | Присутствует ВИДЕО-сообщение | |
Подача | ВИДЕО-сообщение присутствует и | |
В статье | ВИДЕО-сообщение присутствует и | |
Родной | РОДНОЕ сообщение присутствует и | |
Межстраничный | ВИДЕО-сообщение присутствует и | |
Внутрибаннер (MRAID) | | |
В баннере (без MRAID) | | |
Как издатели могут разрешить/запретить видео
В следующих таблицах показаны способы, с помощью которых издатели могут разрешать/запрещать использование видео в своих местах размещения, а также то, как это отображается в запросе ставки для OpenRTB и AdX Proto .
OpenRTB
Вариант паба | Применимые форматы | Описано в запросе ставки как |
---|---|---|
Укажите единицу видео Instream | Инстрим (все) | Видеообъект присутствует и |
Включите VPAID | In-Stream веб-сайт | Видеообъект присутствует и |
Включите IBV | В баннере Межстраничный | |
Включите Outstream ( инструкции ) | Подача В статье | Видеообъект присутствует и |
Включите Outstream ( инструкции ) | Родной | Родной объект присутствует |
Блокировать межстраничное видео | Межстраничное приложение | Объект ВИДЕО отсутствует |
Прототип Ad Exchange
Вариант паба | Применимые форматы | Описывается в запросе ставки как (ПРИМЕЧАНИЕ: это ВСЕ индикаторы опции публикации в запросе ставки — рекомендуемые сигналы см. в таблице ниже) | Настройка по умолчанию |
---|---|---|---|
Укажите единицу видео Instream | Инстрим (все) | Видеосообщение присутствует и | н/д |
Включите VPAID | In-Stream веб-сайт | Видеосообщение присутствует и | Отказался |
Включите IBV | В баннере Межстраничный | | Отказался |
Включение Outstream ( инструкции ) | Подача В статье | Видеосообщение присутствует и | Отказался |
Включите Outstream ( инструкции ) | Родной | РОДНОЕ сообщение присутствует и | Отказался |
Блокировать межстраничное видео | Межстраничное приложение | ВИДЕО-сообщение отсутствует & | Включено |
Краевые случаи
# | Описание случая | Комментарии | Запрос ставки |
---|---|---|---|
1 | Отложенное пользовательское закрытие с использованием MRAID | Для межстраничных объявлений при закрытии объявления покупателю может быть отправлено уведомление с помощью MRAID, даже если он не использовал пользовательское закрытие. Примененный в AdX X всегда будет отображаться поверх любого пользовательского закрытия, даже если пользовательское закрытие появится под ним через 5 секунд. |
Глоссарий
См. видео-глоссарий Авторизованных покупателей .
Поля AdX и OpenRTB в форматах Instream и Outstream.
Прототип Ad Exchange
Запрос ставки.Видео. | |||||
---|---|---|---|---|---|
Placement |
| ||||
videoad_start_delay |
|
Прото OpenRTB
См. OpenRTB 2.5 (начиная со стр. 47).
Запрос ставки.Видео. | |||||
---|---|---|---|---|---|
Placement |
| ||||
linearity | Указывает, должно ли впечатление быть линейным, нелинейным и т. д. Если ничего не указано, предполагается, что разрешены все.
| ||||
videoad_start_delay |
|
Источник значения запроса ставки
OpenRTB Объект | Поля | Ad Exchange /Обмен Торги Outstream | Примеры значений | Кто это определяет? /Откуда берется это значение от? |
---|---|---|---|---|
Объект | ||||
Видео | мимы | да | ["приложение/Javascript", "видео/mp4"]", | |
умопомешательство | нет | Издатель настроен | ||
максимальная продолжительность | да | Издатель настроен | ||
воспроизведениемет ход | да | [6] | Обычно издатель Настроено | |
API (MRAID) | да | [1,2] | ||
протоколы | да | [2,3,5,6,7,8] | ||
линейность | да | [1] | ||
размещение | да | [1] | ||
ширина плеера | да | 400 400 300 | ||
рост игрока | да | 225 300 153 | ||
задержка начала | да | 0 | Google, по умолчанию 5 секунд | |
пропускать | да | 1 | Издатель/Google - для межстраничных объявлений => Google - для Instream => Издатель решает, разрешить ли с возможностью пропуска, без возможности пропуска или и то, и другое. Реклама с вознаграждением, всегда без пропуска; | |
минимальный битрейт | Нет | |||
максимальный битрейт | нет | |||
позиция | да | 1 | ||
Устройство | ||||
Коэффициент пикселей | да | 1 | ||
впечатление | ||||
Безопасный | да | 1 | Google по умолчанию true потому что рекламный тег всегда безопасный |