Więcej informacji o interfejsie DAI Ad Break API

Interfejs API przerw na reklamy w dynamicznym wstawianiu reklam (DAI) umożliwia tworzenie i zarządzanie danymi o czasie i kierowaniu reklam w przypadku nadchodzących przerw na reklamy w transmisjach na żywo.

Interfejs DAI Ad Break API umożliwia:

• Zwiększanie współczynnika wypełnienia reklam w okresach największego ruchu: daj usługom dynamicznego wstawiania reklam więcej czasu na wybór reklam o najwyższych przychodach na potrzeby wydarzeń na żywo. Zalecamy korzystanie z interfejsu DAI Ad Break API, gdy wydarzenia związane z transmisją na żywo mają dużą liczbę jednoczesnych połączeń, dynamiczne tagi reklam lub reklamy o dużym opóźnieniu.
• Pełna kontrola nad blokami reklamowymi: możesz z wyprzedzeniem tworzyć, aktualizować i usuwać bloki reklamowe. Zapewnia to większą elastyczność niż sygnalizowanie reklam w manifeście i wyższy współczynnik wypełnienia w przypadku wyświetlania pakietów reklam w porównaniu z podejmowaniem decyzji w czasie rzeczywistym.
• Zapewnij nieprzerwane wrażenia widzów: zminimalizuj błędy odtwarzania związane z reklamami, takie jak niewypełnione lub przepełnione pakiety reklam, dzięki podawaniu dokładnych informacji o przerwach.

Ten przewodnik zawiera opis metod interfejsu DAI Ad Break API oraz cyklu życia przerwy na reklamę w przypadku przepływów DAI Full Service i Pod Serving.

Metody interfejsu DAI Ad Break API

Interfejs API udostępnia te standardowe metody zarządzania zasobamiAdBreak:

• Create: definiuje nowy obiekt AdBreak dla obiektu LiveStreamEvent. Opcjonalnie ustaw właściwość expectedStartTime, aby zaplanować rozpoczęcie decyzji o reklamie w ciągu 60 sekund przed rozpoczęciem przerwy na reklamę.
• Get: pobiera szczegóły konkretnego elementu AdBreak, w tym stan przerwy na reklamę i metadane dotyczące czasu.
• List: zwraca listę utworzonych wcześniej za pomocą interfejsu API AdBreak podmiotów powiązanych z danym podmiotem LiveStreamEvent, posortowaną w odwrotnej kolejności chronologicznej. Pamiętaj, że interfejs API nie zwraca przerw na reklamy zdefiniowanych tylko w pliku manifestu strumienia treści.
• Update: modyfikuje istniejący element AdBreak przed rozpoczęciem procesu podejmowania decyzji o wyświetleniu reklamy.
• Delete: anuluje decyzję dotyczącą reklamy w przypadku wcześniej utworzonego AdBreak elementu.

Cykl życia przerwy na reklamę

AdBreak może mieć te stany:

• BREAK_STATE_UNSPECIFIED: stan domyślny.
• BREAK_STATE_SCHEDULED: Przerwa na reklamę została utworzona i zaplanowana na potrzeby 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 nadal możesz ją anulować, co może mieć negatywny wpływ na serwery reklam.

Ostrzeżenie: anulowanie przerwy na reklamę w stanie BREAK_STATE_DECISIONED uniemożliwia serwerom reklam dostarczanie reklam, co może negatywnie wpłynąć na funkcje budżetowania i ograniczania liczby wyświetleń serwera reklam.

• BREAK_STATE_COMPLETE: przerwa na reklamę została wyświetlona użytkownikom.

Poniższy diagram przedstawia oś czasu encji AdBreak od utworzenia do ukończenia.

Możesz utworzyć element AdBreak od 1 minuty do 300 minut przed rozpoczęciem przerwy na reklamy.

• Unikaj tworzenia przerwy na reklamy na mniej niż minutę przed przewidywanym czasem rozpoczęcia przerwy, ponieważ Google DAI może nie mieć wystarczająco dużo czasu na podjęcie decyzji dotyczących reklam, co spowoduje niższy współczynnik wypełnienia reklamami.
• Nie twórz przerwy na reklamę wcześniej niż 6 godzin przed jej planowanym rozpoczęciem, ponieważ serwery reklam mogą unieważnić żądane reklamy.

Uwaga: dezaktywacja wydarzenia transmitowanego na żywo powoduje odrzucenie przerw na reklamę w stanie BREAK_STATE_SCHEDULED lub BREAK_STATE_DECISIONED.

W sekcjach poniżej opisujemy przejścia między stanami przerwy na reklamę w przypadku przepływów DAI Full Service i wyświetlania bloków reklamowych.

Omówienie procesu dynamicznego wstawiania reklam w pełnej wersji usługi

Pełna usługa DAI od Google zarządza zarówno manifestem treści, jak i blokami reklamowymi.

W przypadku niestandardowego kierowania reklam użyj interfejsu DAI Ad Break API, aby utworzyć obiekt AdBreak przed odpowiednim znacznikiem reklamy w pliku manifestu transmisji na żywo.

• Ten czas wyprzedzenia umożliwia usługom Google DAI wykorzystanie Twoich AdBreak danych do podejmowania decyzji o reklamach.
• Gdy technologia Google DAI wykryje w pliku manifestu znacznik reklamy, system używa decyzji reklamowych z danymi o AdBreak i przekształca stan podmiotu w BREAK_STATE_COMPLETE.

Ostrzeżenie: gdy dynamiczne wstawianie reklam Google wykryje w manifeście znacznik reklamy, a AdBreak ma stan BREAK_STATE_SCHEDULED, system nie używa danych AdBreak. Obiekt AdBreak pozostaje w stanie BREAK_STATE_SCHEDULED, dopóki nie wywołasz metody usuwania, aby anulować przerwę na reklamę.

Omówienie procesu wyświetlania zasobników

W tym procesie zarządzasz manifestem transmisji na żywo lub korzystasz z usługi manipulacji manifestem innej firmy, aby wykrywać w nim znaczniki reklam.

Wywołaj interfejs DAI Ad Break API przed oczekiwanym czasem rozpoczęcia przerwy na reklamę, aby utworzyć obiekt AdBreakz wyprzedzeniem, zanim będziesz musiał(-a) poprosić o segmenty bloku reklamowego lub manifest reklamy.

Gdy narzędzie do łączenia filmów wykryje w pliku manifestu znacznik reklamy 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 zażąda multimediów reklamowych, utworzony przez Ciebie za pomocą interfejsu API podmiot AdBreak przejdzie w stan BREAK_STATE_COMPLETE.

Prześlij pierwszą prośbę

Aby skonfigurować dostęp do interfejsu API i wysłać pierwsze żądanie, zapoznaj się z artykułem Korzystanie z interfejsu DAI Ad Break API.