Начните работу с SGAI,Начните работу с SGAI,Начните работу с SGAI

Вставка рекламы, управляемая сервером (SGAI), предоставляет манифест рекламного модуля, готовый для сшивки на клиентских устройствах. Если вы включили Pod Serving DAI в своей сети Google Ad Manager, у вас есть доступ к использованию SGAI. Если у вас не включен Pod Serving DAI, обратитесь к менеджеру своего аккаунта.

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

Если у вас есть сервер манифестов манифеста, вы можете сгенерировать URL-адреса манифеста рекламного модуля и вставить рекламные маркеры, которые несут информацию манифеста рекламного модуля, в поток контента в соответствии с предпочитаемой вами спецификацией.

Кроме того, вы можете запланировать рекламную паузу, используя другой механизм, отличный от рекламных маркеров в манифесте потока. В этих случаях ваше приложение может прослушивать другие события, например взаимодействие пользователя с потоком, само приложение или push-уведомление. После этих событий приложение может сгенерировать URL-адреса манифеста рекламного модуля и попросить проигрывателя начать загрузку манифеста рекламного модуля.

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

Прежде чем продолжить, убедитесь, что у вас есть следующее:

Следуйте рекомендациям

Прежде чем создавать URL-адрес манифеста рекламного блока , мы рекомендуем вам вызвать API раннего уведомления о рекламной паузе (EABN), чтобы указать ожидаемую продолжительность, информацию о таргетинге и другие параметры каждой рекламной паузы.

Для рабочих и тестовых потоков вызовите EABN API, особенно если в вашей рекламной сети есть программные кампании. Дополнительную информацию см. в разделе «Функции и рекомендации для прямого автоматизированного размещения» .

Оставить заявку на регистрацию на трансляцию

Когда пользователь запускает поток контента в вашем приложении видеоплеера, вы отправляете запрос на регистрацию потока с параметрами таргетинга, чтобы создать сеанс потоковой передачи в Менеджере рекламы. Подробную информацию о запросе на регистрацию потока см. в разделе Method:stream . После этого вы получаете данные ответа на запрос.

В следующих примерах выполняется запрос на регистрацию потока:

Обычный текст HTTP

  • Запрос:
authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2
  • Ответ: 
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

Оболочка

  • Командная строка:
curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"
  • Выход: 
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

Javascript

  • Использование API-интерфейса выборки:
const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);
  • Журнал консоли: 
{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

Опрос метаданных рекламной паузы

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

Создайте URL-адрес манифеста рекламного модуля

Создайте URL-адрес ресурса модуля Pod Serving API. Затем передайте URL-адрес видеопроигрывателю, чтобы начать загрузку рекламного модуля.

В следующем примере демонстрируется структура URL-адреса манифеста рекламного модуля:

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/pod/101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

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

Воспроизвести манифест рекламного модуля

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

Если вы создадите URL-адреса манифеста рекламного модуля и вставите их в манифест на стороне сервера, наблюдайте за предстоящими событиями рекламной паузы в видеоплеере и обязательно подписывайтесь на события id3 во время каждого воспроизведения рекламной паузы. Если вы планируете события рекламной паузы со стороны клиента, подпишитесь на события id3 при создании.

Отчеты о показах и рекламных событиях

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