Pierwsze kroki ze SGAI

Wstawianie reklam z instrukcjami po stronie serwera (SGAI) udostępnia plik manifestu bloku reklamowego zszywanie na urządzeniach klienckich. Jeśli masz włączone DAI wyświetlania bloków reklamowych w Google sieci Ad Managera, masz dostęp do SGAI. Jeśli nie masz usługi wyświetlania bloków reklamowych Dynamiczne wstawianie reklam (DAI) jest włączone. Skontaktuj się z menedżerem konta.

W przypadku SGAI do tworzenia strumienia możesz używać podów obsługujących punkty końcowe interfejsu API pobierania metadanych reklamy i plików manifestu bloku reklamowego.

Jeśli masz serwer do manipulacji plikiem manifestu, możesz wygenerować blok reklamowy adresy URL plików manifestu i wstaw znaczniki reklam, które zawierają informacje z pliku manifestu bloku reklamowego. zgodnie z preferowaną specyfikacją.

Możesz też zaplanować przerwę na reklamę, używając innego mechanizmu, niż znaczniki reklam w pliku manifestu strumienia. W takich przypadkach aplikacja może nasłuchiwać na inne zdarzenia, np. interakcję użytkownika ze strumieniem, lub powiadomienie push. Po tych zdarzeniach aplikacja może wygenerować reklamę adresów URL bloku reklamowego i poinformować odtwarzacz, aby rozpoczął wczytywanie pliku manifestu bloku reklamowego.

Wymagania wstępne

Zanim przejdziesz dalej, przygotuj te informacje:

Postępuj zgodnie z rekomendacjami

Przed Tobą wygeneruj adres URL pliku manifestu bloku reklamowego, Nazywasz Interfejs API Early Ad Break Notification (EABN) by określić oczekiwany czas trwania, informacje dotyczące kierowania i inne parametry każdej przerwy na reklamę.

W przypadku strumieni produkcyjnych i testowych wywołaj interfejs EABN API, zwłaszcza jeśli reklama ma kampanie zautomatyzowanych. Więcej informacji: Funkcje i wskazówki dotyczące automatyzacji bezpośredniej.

Przesyłanie prośby o rejestrację transmisji na żywo

Gdy użytkownik rozpocznie w aplikacji z odtwarzaczem strumień treści, utworzysz strumień żądanie rejestracji z parametrami kierowania w celu utworzenia sesji strumieniowania w usłudze Ad Manager. Szczegółowe informacje o zgłaszaniu prośby o rejestrację na transmisję: Method:stream (Metoda:stream). Później otrzymasz dane odpowiedzi od wniosku.

Żądanie rejestracji strumienia jest wysyłane w tych przykładach:

Zwykły tekst HTTP

  • Prośba:
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
  • Odpowiedź:
{
    "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"
}

Pudrowy róż

  • Wiersz poleceń:
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"
  • Dane wyjściowe:
{
    "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

  • Przy użyciu interfejsu Fetch 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);
  • Dziennik konsoli:
{
    "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"
}

Ankieta o metadanych przerwy na reklamę

Po wysłaniu żądania rejestracji strumienia sprawdź metadane reklamy. Do ankietę, ustaw minutnik za pomocą przycisku polling_frequence w odpowiedzi na żądanie strumienia na stronie rejestracji, by wywołać reklamę metadane. W każdej ankiecie możesz otrzymać częściową listę reklam z metadanymi, być dostępne.

Generowanie adresu URL pliku manifestu bloku reklamowego

Utwórz adres URL dla zasób poda interfejsu Pod Serving API. Później prześlij URL do odtwarzacza, aby odtworzyć film wczytanie bloku reklamowego.

Ten przykład przedstawia strukturę adresu URL pliku manifestu bloku reklamowego:

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

Parametry adresu URL pliku manifestu bloku reklamowego możesz obliczyć na podstawie przerwy na reklamę. informacje pobrane z odtwarzacza wideo lub powiadomienie serwera. Dla: wymagań dotyczących tych parametrów, zobacz Metoda: plik manifestu poda.

Odtwórz plik manifestu bloku reklamowego

W aplikacji odtwarzacza wideo klienta rozpocznij odtwarzanie strumienia treści od kanału głównego i postępuj zgodnie z dokumentacją dotyczącą odtwarzacza, i w razie potrzeby harmonogram reklam.

Jeśli wygenerujesz adresy URL pliku manifestu bloku reklamowego i wstawisz je w pliku manifestu w sekcji po stronie serwera, obserwować nadchodzące zdarzenia przerwy na reklamę w odtwarzaczu i sprawdzać, subskrybuj zdarzenia id3 podczas każdego odtwarzania przerwy na reklamę. Jeśli zaplanujesz wyświetlanie reklamy zdarzenia przerwy na reklamę po stronie klienta, zasubskrybuj zdarzenia id3 podczas tworzenia.

Raportowanie wyświetleń i zdarzeń reklamowych

Gdy odtwarzacz odtwarza blok reklamowy i natrafia na metadane opóźnione o identyfikatorze id3, odsłuchaj zdarzenia reklamowe które odtwarzacz uruchamia i przetwarza wysyłania pingów weryfikacyjnych dla multimediów.