Informacje o interfejsie DAI Ad Break API

Interfejs API przerw na reklamę w dynamicznym wstawianiu reklam (DAI) umożliwia tworzenie danych o czasie trwania i kierowaniu reklam w nadchodzących przerwach na reklamę w transmisjach na żywo oraz zarządzanie nimi.

Za pomocą interfejsu DAI Ad Break API możesz:

  • Zwiększanie współczynnika wypełnienia reklam w okresach największego natężenia ruchu: daj usługom DAI więcej czasu na wybór najbardziej dochodowych reklam na potrzeby wydarzeń na żywo. Zalecamy korzystanie z interfejsu DAI Ad Break API, gdy wydarzenia transmitowane na żywo mają dużą liczbę jednoczesnych widzów, dynamiczne tagi reklam lub reklamy o dużym opóźnieniu.
  • Pełna kontrola nad przerwami na reklamy: możesz z wyprzedzeniem tworzyć, aktualizować i usuwać przerwy na reklamy, co daje większą elastyczność niż sygnalizowanie reklam w manifeście i większy współczynnik wypełnienia w przypadku wyświetlania podcastów niż w przypadku podejmowania 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 bloki reklamowe, dostarczając dokładne informacje o przerwach.

Ten przewodnik opisuje metody interfejsu DAI Ad Break API i przedstawia cykl życia przerwy na reklamę w przypadku przepływów DAI Full Service i wyświetlania bloków reklamowych.

Poznaj metody interfejsu DAI Ad Break API

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

  • Create: definiuje nowy podmiot AdBreak dla podmiotu LiveStreamEvent. Opcjonalnie ustaw właściwość expectedStartTime, aby zaplanować decyzję o reklamie, która ma zostać podjęta 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 encji AdBreak dla danej encji 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 ma 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.
  • 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.

Od utworzenia do zakończenia przerwy na reklamę.

Możesz utworzyć element AdBreak od 1 do 300 minut przed przewidywanym rozpoczęciem bloku reklamowego.

  • Nie twórz przerwy na reklamy na mniej niż minutę przed przewidywanym czasem rozpoczęcia, 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 czasem rozpoczęcia, ponieważ serwery reklam mogą unieważnić żądane reklamy.

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łni obsługiwanego przez Google

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 przerwy na reklamę w manifeście transmisji na żywo.

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

Encja przerwy na reklamę od utworzenia do zakończenia w przypadku pełnej obsługi DAI.

Omówienie procesu wyświetlania reklam w przypadku zasobników

W tym procesie zarządzasz plikiem manifestu transmisji na żywo lub korzystasz z usługi manipulacji plikami manifestu 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 AdBreak przed momentem, w którym musisz przesłać żądanie segmentów bloku reklamowego lub manifestu reklamy.

Gdy narzędzie do łączenia filmów wykryje w pliku manifestu znacznik reklamy i wyśle żądania segmentu reklamy z identyfikatorem bloku reklamowego, dynamiczne wstawianie reklam Google użyje danych AdBreak z tym samym identyfikatorem do podejmowania decyzji dotyczących reklam.

Gdy klient zażąda multimediów reklamy, utworzony przez Ciebie za pomocą interfejsu API obiekt AdBreak przejdzie w stan BREAK_STATE_COMPLETE.

Stan ukończenia jednostki przerwy na reklamę.

Wysyłanie pierwszej prośby

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