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

С запуском поддержки видеорекламы покупатели смогут приобретать видеоресурсы через Авторизованные покупатели. В этом документе изложены требования к интеграции для покупок через 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

Предварительный таргетинг

Чтобы получать видеоресурсы, покупатели RTB должны иметь конфигурацию предварительного таргетинга для RTB, включающую видеоресурсы.

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

Форматы видео Ad Exchange

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

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

Интернет

Видеокреатив Инстрим (все) В ленте/статья Нативный фид/статья Межстраничный В баннере

VPAID + VAST

ОГРОМНЫЙ

МРАИД + JS

Пользовательский JS

Нативный + VAST

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

Видеокреатив Инстрим (все) В ленте/статья Нативный фид/статья Межстраничный В баннере

VPAID + VAST

ОГРОМНЫЙ

МРАИД + JS

Пользовательский JS

Нативный + VAST

Ключ: Формат/технология недоступна.

Видеообъявление, принятое в этом месте размещения, подлежит блокировке со стороны издателя.

Видеообъявление недоступно в этом месте размещения.

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

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

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

Формат видео Рекомендуемые сигналы (только сигналы, относящиеся к видео) Связанные сигналы (только сигналы, относящиеся к видео)

Инстрим (VPAID)

ВИДЕО объект присутствует и
video.placement = INSTREAM &


In-Stream (без VPAID)

ВИДЕО объект присутствует и
video.placement = INSTREAM &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0


Outstream

Объект ВИДЕО присутствует

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

Outstream

Объект ВИДЕО присутствует

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 видео в баннере (по инициативе пользователя)


Рекомендуемые сигналы прототипа AdX

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

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

Формат видео Рекомендуемые сигналы, релевантные для видео Связанные сигналы, релевантные для видео

Инстрим (VPAID)

ВИДЕО-сообщение присутствует и
placement = INSTREAM &
Allowed_video_formats = VPAID_JS

Allowed_video_formats = VIDEO_HTML5
Allowed_ad_types = VIDEO

In-Stream (без VPAID)

ВИДЕО-сообщение присутствует и
placement = INSTREAM &
Allowed_video_formats ≠ VPAID_JS

Разрешенные_видео_форматы = VIDEO_HTML5 &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

Подача

ВИДЕО-сообщение присутствует и
placement = IN-FEED

Разрешенные_видео_форматы = VIDEO_HTML5 &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

В статье

ВИДЕО-сообщение присутствует и
placement = IN-ARTICLE

Allowed_video_formats = VIDEO_HTML5 &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

Родной

РОДНОЕ сообщение присутствует и
VIDEO = 000x000 в собственном сообщении

Allowed_ad_types = NATIVE

В баннере

excluded_attribute ≠ 95 VideoType: Видео в баннере (блокируется издателем)

Allowed_ad_types = BANNER

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

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

Формат видео Подробности запроса ставки, относящиеся к видео Сигналы, относящиеся к видео

Инстрим

Присутствует ВИДЕО-сообщение
placement = INSTREAM

Allowed_video_formats = VIDEO_HTML5
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

Подача

ВИДЕО-сообщение присутствует и
placement = IN-FEED

Allowed_video_formats = VIDEO_HTML5 &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

В статье

ВИДЕО-сообщение присутствует и placement = IN-ARTICLE

Allowed_video_formats = VIDEO_HTML5 &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

Родной

РОДНОЕ сообщение присутствует и
VIDEO = 000x000 в собственном сообщении

Allowed_ad_types = NATIVE

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

ВИДЕО-сообщение присутствует и
placement = INTERSTITIAL &

Allowed_video_formats = VIDEO_HTML5 &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

Внутрибаннер (MRAID)

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable) &
excluded_attribute ≠ 32 MraidType: MRAID

Allowed_video_formats = VIDEO_HTML5 &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = BANNER

В баннере

(без MRAID)

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable) &
excluded_attribute = 32 MraidType: MRAID

Allowed_video_formats = VIDEO_HTML5 &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = BANNER

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

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

OpenRTB

Вариант паба Применимые форматы Описано в запросе ставки как

Укажите единицу видео Instream

Инстрим (все)

Видеообъект присутствует и
video.placement = INSTREAM

Включите VPAID

In-Stream веб-сайт

Видеообъект присутствует и
video.api = 1 (VPAID 1.0) или 2 (VPAID 2.0)

Включите IBV

В баннере

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

banner.battr ≠ 6 видео в баннере (автовоспроизведение) и/или 7 видео в баннере (по инициативе пользователя)

Включите Outstream ( инструкции )

Подача

В статье

Видеообъект присутствует и
video.placement = IN-FEED или IN-ARTICLE

Включите Outstream ( инструкции )

Родной

Родной объект присутствует

Блокировать межстраничное видео

Межстраничное приложение

Объект ВИДЕО отсутствует

Прототип Ad Exchange

Вариант паба Применимые форматы Описывается в запросе ставки как (ПРИМЕЧАНИЕ: это ВСЕ индикаторы опции публикации в запросе ставки — рекомендуемые сигналы см. в таблице ниже) Настройки по умолчанию

Укажите единицу видео Instream

Инстрим (все)

Видеосообщение присутствует и
placement = INSTREAM

н/д

Включите VPAID

In-Stream веб-сайт

Видеосообщение присутствует и
Allowed_video_formats = VPAID_JS &
исключенный_атрибут ≠ 30 InstreamVastVideoType: Vpaid

Отказаться

Включите IBV

В баннере

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

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)

Отказаться

Включение Outstream ( инструкции )

Подача

В статье

Видеосообщение присутствует и
Allowed_video_formats = VIDEO_HTML5 &
placement = IN-FEED or IN-ARTICLE

Отказаться

Включение Outstream ( инструкции )

Родной

РОДНОЕ сообщение присутствует и

VIDEO = 000x000 в собственном сообщении

Отказаться

Блокировать межстраничное видео

Межстраничное приложение

ВИДЕО-сообщение отсутствует &
excluded_attribute = 30 InstreamVastVideoType: Vpaid

Включено

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

# Описание случая Комментарии Запрос ставки

1

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

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


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


Глоссарий

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

Поля AdX и OpenRTB в форматах Instream и Outstream.

Прототип Ad Exchange

Запрос ставки.Видео.
Placement
Инстрим mWeb

0: UNKNOWN_PLACEMENT
1: INSTREAM

mApp

0: UNKNOWN_PLACEMENT
1: INSTREAM

Outstream mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE

Rewarded

is_rewarded

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

Outstream Rewarded

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

Прото OpenRTB

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

Запрос ставки.Видео.
Placement
Инстрим mWeb

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

mApp

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

Outstream mApp Interstitial

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

Native

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

Rewarded

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

linearity

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

Инстрим mWeb

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

mApp

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

Outstream 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

Outstream Rewarded

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

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

OpenRTB
Объект
Поля Ad Exchange
/Обмен
Торги
Outstream
Примеры значений Кто это определяет?
/Откуда берется это значение
от?
Объект
видео мимы да ["приложение/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
потому что рекламный тег всегда
безопасный