Interfejs API przerwy na reklamę w ramach dynamicznego wstawiania reklam (DAI) umożliwia tworzenie i zarządzanie czasem oraz danymi kierowania reklam w nadchodzących przerwach na reklamę w transmisjach na żywo.
Dzięki interfejsowi API przerw na reklamę DAI możesz:
- Zwiększanie współczynnika wypełnienia reklamą w okresach największego ruchu: daj usługom dynamicznego wstawiania reklam więcej czasu na wybór najbardziej dochodowych reklam do wyświetlania podczas wydarzeń na żywo. Zalecamy korzystanie z interfejsu DAI Ad Break API, gdy wydarzenia transmitowane na żywo mają dużą liczbę jednoczesnych użytkowników, dynamiczne tagi reklam lub reklamy o dużym opóźnieniu.
- Pełna kontrola nad przerwami na reklamę: możesz tworzyć, aktualizować i usuwać przerwy na reklamę z wyprzedzeniem, co zapewnia większą elastyczność niż sygnalizowanie reklam w pliku manifestu i wyższy współczynnik wypełnienia w przypadku wyświetlania bloków reklamowych w porównaniu z podejmowaniem decyzji w czasie rzeczywistym.
- Zapewnianie widzom nieprzerwanych wrażeń: podawaj precyzyjne informacje o przerwach, aby zminimalizować błędy odtwarzania związane z reklamami, takie jak niewypełnione lub przepełnione bloki reklamowe.
Ten przewodnik opisuje metody interfejsu DAI Ad Break API i przedstawia cykl życia przerwy na reklamę w przypadku procesów pełnej obsługi DAI i wyświetlania bloków reklamowych.
Poznawanie metod interfejsu API przerw na reklamę DAI
Interfejs API udostępnia te standardowe metody zarządzania zasobami AdBreak:
Create: definiuje nowy elementAdBreakdla elementuLiveStreamEvent. Opcjonalnie możesz ustawić właściwośćexpectedStartTime, aby zaplanować rozpoczęcie decyzji reklamowej w ciągu 60 sekund przed rozpoczęciem przerwy na reklamę.Get: pobiera szczegóły konkretnego elementuAdBreak, w tym stan przerwy na reklamę i metadane dotyczące czasu.List: zwraca listę encjiAdBreakutworzonych wcześniej za pomocą interfejsu API dla danej encjiLiveStreamEvent, posortowaną w odwrotnej kolejności chronologicznej. Pamiętaj, że interfejs API nie zwraca przerw na reklamę zdefiniowanych tylko w pliku manifestu strumienia treści.Update: modyfikuje istniejący elementAdBreakprzed rozpoczęciem decyzji reklamowej.Delete: anuluje decyzję dotyczącą reklamy w przypadku utworzonego wcześniej elementuAdBreak.
Cykl życia przerwy na reklamę
Encja AdBreak może mieć te stany:
BREAK_STATE_UNSPECIFIED: stan domyślny.BREAK_STATE_SCHEDULED: przerwa na reklamę została utworzona i zaplanowana do podjęcia decyzji o reklamie.BREAK_STATE_DECISIONED: usługi DAI rozpoczęły proces wyboru reklamy na potrzeby przerwy na reklamę. Nie możesz modyfikować przerwy na reklamę, ale możesz ją anulować, co może mieć negatywny wpływ na serwery reklam.
BREAK_STATE_COMPLETE: przerwa na reklamę została wyświetlona użytkownikom.BREAK_STATE_EXPIRED: przerwa na reklamę wygasła przed wyświetleniem. Ma zastosowanie tylko wtedy, gdy włączysz planowanie wielu przerw w przypadku wydarzenia transmitowanego na żywo. Więcej informacji znajdziesz w artykule Ustawienia przerwy na reklamę w trakcie filmu. Domyślnie przerwy na reklamę wygasają 30 minut po wartości polaexpectedStartTimelub 30 minut po rozpoczęciu podejmowania decyzji, jeśli nie ustawisz polaexpectedStartTime. Możesz dostosować ten czas za pomocą polaexpireDuration.
Poniższy diagram przedstawia oś czasu encji AdBreak od utworzenia do zakończenia.

Możesz utworzyć element AdBreak od 1 do 300 minut przed planowanym rozpoczęciem przerwy na reklamę.
- Unikaj tworzenia przerwy na reklamę na mniej niż minutę przed jej oczekiwanym czasem rozpoczęcia, ponieważ Google DAI może nie mieć wystarczająco dużo czasu na podjęcie decyzji dotyczących reklam, co może spowodować niższy współczynnik wypełnienia reklamą.
- Unikaj tworzenia przerwy na reklamę wcześniej niż 6 godzin przed jej oczekiwanym czasem rozpoczęcia, ponieważ serwery reklam mogą unieważnić żądane reklamy.
W sekcjach poniżej opisano przejścia między stanami przerwy na reklamę w przepływach pełnej usługi dynamicznego wstawiania reklam i wyświetlania bloków reklamowych.
Przepływ dynamicznego wstawiania reklam w trybie Full-service
W przypadku pełnej obsługi DAI Google zarządza zarówno plikiem manifestu treści, jak i blokami reklamowymi.
W przypadku niestandardowego kierowania reklam użyj interfejsu DAI Ad Break API, aby utworzyć element AdBreak przed odpowiednim znacznikiem przerwy na reklamę w pliku manifestu transmisji na żywo.
- Ten czas realizacji pozwala usługom Google DAI na wykorzystanie danych
AdBreakdo podjęcia decyzji o wyświetleniu reklamy. - Gdy system Google DAI wykryje znacznik reklamy w pliku manifestu, używa decyzji reklamowych z danymi encji
AdBreaki zmienia stan encji naBREAK_STATE_COMPLETE.
Gdy włączysz planowanie wielu przerw w wydarzeniu z transmisją na żywo, możesz ustawić pole matchParams w encji AdBreak. Dzięki temu procesowi funkcja DAI Google może dopasowywać wykryte znaczniki reklam w pliku manifestu do przerw na reklamę w stanie BREAK_STATE_SCHEDULED lub BREAK_STATE_DECISIONED.

Proces wyświetlania bloków reklamowych
W tym procesie zarządzasz plikiem manifestu transmisji na żywo lub korzystasz z usługi zewnętrznej do manipulowania plikiem manifestu, aby wykrywać znaczniki reklam w pliku manifestu.
Wywołaj interfejs DAI Ad Break API przed oczekiwanym czasem rozpoczęcia przerwy na reklamę, aby utworzyć element AdBreak, zanim będzie trzeba wysłać żądanie dotyczące segmentów bloku reklamowego lub pliku manifestu reklamy.
Gdy narzędzie Video Stitcher wykryje znacznik reklamy w pliku manifestu i wyśle żądania segmentu reklamy z identyfikatorem przerwy na reklamę, Google DAI użyje danych AdBreak z tym samym identyfikatorem do podejmowania decyzji dotyczących reklam.
Gdy klient poprosi o multimedia reklamowe, utworzony przez Ciebie za pomocą interfejsu API element AdBreak przejdzie w stan BREAK_STATE_COMPLETE.

Wysyłanie pierwszego żądania
Aby skonfigurować dostęp do interfejsu API i wysłać pierwsze żądanie, przeczytaj artykuł Korzystanie z interfejsu DAI Ad Break API.