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

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

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

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

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

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

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

• В вашей сети Google Ad Manager включен показ модулей DAI.
• Событие прямой трансляции с типом манифеста обслуживания модуля . Чтобы создать событие, см. раздел «Настройка прямой трансляции для DAI» .

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

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

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

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

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

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

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

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

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

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

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

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

Важно! Не откладывайте отправку ping на URL-адрес проверки носителя. Мы рекомендуем пинговать немедленно и не дольше одной минуты.