Aby wdrożyć wstawianie reklam po stronie serwera (SSAI) w przypadku transmisji na żywo HLS lub DASH, użyj interfejsu Pod Serving API do wysyłania żądań dotyczących bloków reklamowych z adaptacyjną szybkością transmisji. Obsługiwane rozdzielczości i szybkości transmisji bitów znajdziesz w sekcji Formaty audio i wideo oraz transkodowanie.
Na tej stronie opisujemy, jak używać interfejsu Pod Serving API w przypadku transmisji na żywo.
Wymagania wstępne
Zanim przejdziesz dalej, musisz mieć:
Skonfiguruj wydarzenie transmitowane na żywo z typem dynamicznego wstawiania reklam (DAI) Blok reklamowy z przekierowaniem. Wybierz jedną z tych opcji:
- Skonfiguruj transmisję na żywo na potrzeby dynamicznego wstawiania reklam.
- Wybierz bibliotekę klienta interfejsu SOAP API i wywołaj metodę
LiveStreamEventService.createLiveStreamEventsz obiektemLiveStreamEventi typemdynamicAdInsertionTypeustawionym na wyliczeniePOD_SERVING_REDIRECT. Wszystkie biblioteki klienta znajdziesz w artykule Biblioteki klienta i przykładowy kod.
Aplikacja kliencka działająca w przeglądarce, na urządzeniu mobilnym lub telewizorze, która wczytuje strumień i obsługuje zdarzenia, takie jak odtwarzanie, wstrzymywanie, kliknięcie lub dotknięcie.
Manipulator manifestu do obsługi żądań strumieniowania z aplikacji klienta. Ważne: w przypadku usługi manifestu zalecamy zaawansowany przepływ wyświetlania.
Konto Google Ad Managera z włączoną funkcją wyświetlania bloków reklamowych z DAI.
Podstawowy proces wyświetlania
Aby dostarczyć strumień, wybierz protokół strumieniowania i wykonaj te czynności:
HLS
Aby zarejestrować sesję, wyślij żądanie strumienia z odtwarzacza wideo do Google Ad Managera.
Rozpocznij odpytywanie metadanych reklam w przypadku nadchodzących zdarzeń związanych z reklamami.
Poproś manipulatora pliku manifestu o plik manifestu transmisji na żywo.
Opcjonalnie: wyślij powiadomienie o wcześniejszej przerwie na reklamę do Google Ad Managera. Ważne: zalecamy wykonanie tego kroku, aby zwiększyć współczynnik wypełnienia.
Gdy manipulator pliku manifestu wykryje znacznik przerwy na reklamę, skonstruuj adresy URL segmentów reklam i wstaw je do pliku manifestu.
- Podczas przerwy na reklamę odtwarzacz wideo klienta wysyła żądanie segmentu reklamy i przekierowuje adres URL segmentu, aby pobrać plik segmentu reklamy.
Wyodrębnianie identyfikatorów zdarzeń związanych z reklamami z tagów ID3 w celu znajdowania i wysyłania do Google pingów weryfikujących media.
DASH
Wykonaj wszystkie czynności na karcie HLS.
Poproś o szablon okresu DASH tylko raz i zapisz go w pamięci podręcznej. W ten sposób tworzone są okresy dla wszystkich przerw na reklamy w sesji.
Zaawansowany przepływ wyświetlania
Aby dostarczyć strumień, wybierz protokół przesyłania strumieniowego:
HLS
Aby zarejestrować sesję, wyślij żądanie strumienia z odtwarzacza wideo klienta do Google Ad Managera.
Rozpocznij odpytywanie metadanych reklam w przypadku nadchodzących zdarzeń związanych z reklamami.
Poproś manipulatora pliku manifestu o plik manifestu transmisji na żywo.
Opcjonalnie: wyślij powiadomienie o wcześniejszej przerwie na reklamę do Google Ad Managera, aby zwiększyć współczynnik wypełnienia.
Wyślij do Google Ad Managera żądanie metadanych dotyczących czasu trwania bloku reklamowego (ATM).
Pobierz dokładny czas bloku reklamowego i czas wyświetlania reklamy, aby utworzyć adresy URL segmentów reklam.
Połącz adresy URL segmentów reklam w pliku manifestu.
Gdy manipulator pliku manifestu wykryje znacznik przerwy na reklamę, skonstruuj adresy URL segmentów reklam i wstaw je do pliku manifestu.
- Podczas przerwy na reklamę odtwarzacz wideo klienta wysyła żądanie segmentu reklamy i przekierowuje adres URL segmentu, aby pobrać plik segmentu reklamy.
Wyodrębnianie identyfikatorów zdarzeń związanych z reklamami z tagów ID3 w celu znajdowania i wysyłania do Google pingów weryfikujących media.
DASH
Wykonaj wszystkie czynności na karcie HLS.
Użyj odpowiedzi metadanych dotyczących czasu trwania bloku reklamowego (Ad pod Timing Metadata, ATM) w przypadku dodatkowych wymaganych pól, aby utworzyć okresy DASH.
Szczegółowe instrukcje
Szczegółowe informacje o punktach końcowych interfejsu API oraz przykładowe dane żądań i odpowiedzi znajdziesz w artykułach Aplikacja odtwarzacza wideo klienta do transmisji na żywo i Manipulator manifestu do transmisji na żywo.