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

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

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

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

Протокол RTB

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

Протокол OpenRTB и расширения OpenRTB для 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 можно определить, относится ли входящий запрос ставки к инвентарю для видеорекламы In-Stream или межстраничных видеообъявлений, а также получить дополнительную информацию о запросе, связанную с видео. Кроме того, для нативного рекламного инвентаря можно использовать параметр 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

Максимальное количество объявлений, которые могут быть показаны в динамическом пакете видеообъявлений. Если задан параметр poddur, но не задан параметр maxseq или задано значение 0, то ограничений на количество объявлений в пакете нет. Google поддерживает только динамические пакеты.

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

BidRequest.imp.video.minduration

Минимальная длительность в секундах для каждого отдельного объявления, включенного в ответ на запрос ставки. Если значение не задано, минимальная продолжительность не ограничена.

BidRequest.imp.video.plcmt

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

PLCMT_UNKNOWN	Место размещения неизвестно или не может быть определено.
PLCMT_INSTREAM	Видеореклама в начале ролика, реклама в середине видео и реклама в конце видео, которые показываются до, во время или после воспроизведения потокового видеоконтента, запрошенного пользователем. В видеорекламе In-Stream звук должен быть включен по умолчанию при запуске проигрывателя или должно быть явно выражено намерение пользователя посмотреть видеоконтент. Рядом с проигрывателем может быть и другой контент, но видеоконтент должен быть основной целью посещения. Он должен оставаться основным контентом на странице и единственным видеопроигрывателем в видимой области экрана, способным воспроизводить звук. Если проигрыватель преобразуется в плавающий или закрепленный, последующие вызовы объявлений должны точно передавать обновленный размер проигрывателя.
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.imp.video.durfloors и BidRequest.imp.audio.durfloors

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

Ниже приведен пример того, как будет выглядеть заданный Google атрибут durfloors:

1. {"maxdur": 16, "bidfloor": 5} – (0, 16) сек. при $5.
2. {"mindur": 16, "maxdur": 31, "bidfloor": 10}, представляющий [16, 31) сек. при $10.
3. {"mindur": 31, "bidfloor": 20} – [31, inf) сек. при $20.

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

BidRequest.device.ifa

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

BidRequest.device.devicetype

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

MOBILE	Устаревший псевдоним для HIGHEND_PHONE или TABLET.
PERSONAL_COMPUTER	Включает настольные компьютеры и ноутбуки.
CONNECTED_TV	включает как подключенные телевизоры (Smart 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-типы контента для объявлений, показываемых в ответ на запрос ставки, например video/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: "eW3q768m3k93fv93a80tGQ"
seatbid {
  bid {
    id: "0uMc95E6ClImM3p5FSe"
    impid: "1"
    price: 0.034745
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_168019"
    cat: "7"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 61170857882
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 30
}

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

BidResponse.seatbid.bid.ext.attribute

Атрибуты объявлений, которые могут быть показаны из этого фрагмента. Список идентификаторов приведен в файле buyer-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.

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

• Примеры запросов ставок для видеорекламы
• Примеры ответов на запросы ставок для видеорекламы

Переопределение настроек пропуска

Google автоматически применяет переопределение настроек пропуска к ставкам в реальном времени для видеоинвентаря. Это позволяет предотвратить исключение ваших ставок из аукциона из-за различий между настройками пропуска, указанными в запросе ставки, и настройками пропуска креативов, которые вы возвращаете в ответе на запрос ставки. Переопределение настроек пропуска не применяется в следующих случаях:

• Креатив, указанный в ответе на запрос ставки, реализован с помощью VPAID. Определить, какие из ваших видеокреативов реализованы с помощью VPAID, можно по полю Creative.video.videoMetadata.isVpaid в API назначения ставок в реальном времени.
• Издатель собирается выполнить отрисовку креатива. Это можно определить по полю BidRequest.imp.displaymanager. Если издатель будет отрисовывать креатив, то значение этого поля будет 'PUBLISHER'.

Ниже приведены примеры того, как применяется переопределение настроек пропуска.

• Сценарий 1.
• Вы получаете запрос ставки, в котором поле BidRequest.imp.video.skip имеет значение 0 (для формата JSON) или false (для формата Protobuf).
• Вы назначаете ставку на креатив с возможностью пропуска.
• Результат: ваша ставка участвует в аукционе. Если ваша ставка выиграет и видеокреатив будет отрисован, он будет показан без возможности пропуска.
• Сценарий 2.
• Вы получаете запрос ставки, в котором поле BidRequest.imp.video.skip имеет значение 1 (для формата JSON) или true (для формата Protobuf).
• Вы назначаете ставку с креативом без возможности пропуска, продолжительность которого превышает значение, указанное в поле BidRequest.imp.video.skipmin.
• Результат: ваша ставка участвует в аукционе. Если ваша ставка выиграет и видеокреатив будет отрисован, он будет показан с возможностью пропуска.

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

• Как покупатели могут добавлять видео
• Рекомендуемые сигналы OpenRTB для всех видеоформатов
• Рекомендуемые сигналы proto Авторизованных покупателей для всех видеоформатов
• Как издатели могут разрешить или запретить видео
• Пограничные ситуации

Как покупатели могут добавлять видео

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

Веб

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

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

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

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

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

Как издатели могут разрешить или запретить показ видеообъявлений

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

Пограничные ситуации

Глоссарий

Ознакомьтесь с глоссарием по видеорекламе в Авторизованных покупателях.

Поля, относящиеся к форматам In-Stream и вне проигрывателя

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

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