Объявления с возможностью пропуска в потоке VOD

В этом руководстве показано, как использовать DAI API для запроса потока VOD с рекламой с возможностью пропуска, отображения кнопки пропуска в соответствии с требованиями Google Рекламы и отправки связанных событий отслеживания.

Предварительные условия

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

Чтобы запросить поток VOD с рекламой с возможностью пропуска, вам необходимо передать параметр dai-sas в запросе потока .

конечная точка API 

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

Параметры пути

{CMS_ID} Идентификатор CMS потока.
{VIDEO_ID} Идентификатор видео потока.

Параметры тела

dai-sas Установите dai-sas=1 , чтобы включить рекламу с возможностью пропуска.

Пример запроса (cURL)

Для запросов потока HLS:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Замените 'dash' в URL-адресе потоков DASH:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Используйте следующий формат, чтобы включить несколько параметров потока в тело вашего запроса: 

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Как справиться с пропуском рекламы

Чтобы обрабатывать пропуск рекламы, используйте информацию либо в структуре Ad , либо в структуре AdBreak в зависимости от того, пропускаете ли вы текущую рекламу или всю рекламную паузу. Возьмите start значение и добавьте значение duration , а затем найдите эту точку в потоке. Подсообщение SkipMetadata также включает значение offset , которое представляет собой значение в секундах времени, прежде чем объявление можно будет пропустить. Подсообщение SkipMetadata будет отображаться только в объявлениях, которые можно пропустить.

ad_breaks Список рекламных пауз.
start (число) Позиция в потоке, с которой начинается перерыв, в секундах.
duration (число) Продолжительность рекламной паузы, в секундах.
ads (object(Ad)) Список рекламы в потоке.
start (число) Позиция в потоке, с которого начинается реклама, в секундах.
duration (число) Продолжительность объявления в секундах.
skip_metadata (object(SkipMetadata)) Дополнительные метаданные для пропускаемой рекламы. Если этот параметр установлен, это указывает на то, что объявление можно пропустить, и включает инструкции по обработке пользовательского интерфейса пропуска и событий отслеживания.
offset (число) Смещение указывает время в секундах, в течение которого игрок должен подождать до появления кнопки пропуска в рекламе. Опускается, если не указано в VAST.
tracking_url (строка) URL-адрес, который должен быть проверен при событии пропуска.

Пример ответа

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

После пропуска объявления отправьте пинг по URL-адресу события пропуска, включенному в ответ потока. Он включен в подсообщение SkipMetadata .

Требования к кнопке «Пропустить»

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

Таймер обратного отсчета

Объявление нельзя пропускать до тех пор, пока не наступит время skipoffset , указанное в VAST. В течение этого периода, который нельзя пропустить, вы должны отобразить пользователю уведомление о том, что рекламу можно пропустить через X секунд. Уведомление должно быть переведено на язык пользователя.

Пропустить положение кнопки

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

Пропустить размер кнопки

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

Текст и значок

Кнопка пропуска должна содержать как текст, так и иконку. Вы можете использовать значок «Пропустить следующий материал» в качестве иконографии.

Доступность

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

Интернационализация

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

Рекламные блоки

Кнопку пропуска можно использовать для пропуска либо текущего объявления в рекламном блоке, либо пропуска всего модуля.

Переводы «Пропустить рекламу»

Используйте файл skipAdTranslations.json для перевода текста «Пропустить рекламу» в зависимости от языкового стандарта пользователя.