Więcej informacji o interfejsie Stream Activity Monitor API

Interfejs API monitora aktywności strumienia (SAM) dynamicznego wstawiania reklam (DAI) umożliwia sprawdzanie i rozwiązywanie problemów z poszczególnymi sesjami oglądania transmisji na żywo i filmów na żądanie (VOD).

Aby wizualnie sprawdzić i rozwiązać problemy z poszczególnymi sesjami oglądania transmisji na żywo lub VOD, użyj narzędzia do monitorowania aktywności w transmisji na żywo w interfejsie Google Ad Managera. Aby automatycznie pobierać dane diagnostyczne sesji, użyj zasobu networks.daiSessions interfejsu Ad Manager API.

Przypadki użycia

Dzięki interfejsowi SAM API możesz zautomatyzować diagnostykę strumieni i rozwiązywać problemy z wyświetlaniem reklam w ramach integracji DAI, takie jak:

  • Sprawdź tworzenie sesji strumienia: potwierdź parametry, tryb łączenia STITCHED lub POD_SERVING, tryb raportowania i metadane treści, które Google DAI otrzymuje podczas tworzenia sesji transmisji na żywo lub VOD.
  • Sprawdzanie żądań i odpowiedzi na żądania reklam: sprawdzaj wychodzące tagi reklam VAST (Video Ad Serving Template) i VMAP (Video Multiple Ad Playlist), kody stanu HTTP, czas oczekiwania na odpowiedź, nieprzetworzone treści odpowiedzi XML i łańcuchy przekierowań kodu opakowującego.
  • Rozwiązywanie problemów z decyzjami dotyczącymi bloków reklamowych i kreacji: sprawdź, które reklamy Google DAI wybiera lub odrzuca w przypadku każdego bloku reklamowego, czas trwania każdej reklamy w bloku reklamowym oraz źródłowy system reklamowy kreacji.
  • Śledzenie wykonywania pobierania z wyprzedzeniem reklam: możesz sprawdzić, czy funkcja DAI Google pobiera blok reklamowy z wyprzedzeniem, i sprawdzić etap pobierania z wyprzedzeniem każdego bloku reklamowego.
  • Sprawdzanie wywołań interfejsu DAI Ad Break API i interfejsu DAI API do wyświetlania bloków reklamowych: sprawdź rzeczywiste wykonanie przerwy na reklamę, czas trwania wyświetlanych reklam i czas trwania wstawionych plansz w porównaniu z wywołaniami interfejsu API, takimi jak interfejs DAI Ad Break API i interfejs DAI API do wyświetlania bloków reklamowych.
  • Sprawdź śledzenie zdarzeń związanych z reklamami: sprawdź, czy pingi śledzenia po stronie klienta lub serwera zostały wysłane, i przeanalizuj odpowiedzi HTTP z serwerów reklam.
  • Zautomatyzuj monitorowanie sesji i alerty: analizuj wpisy uporządkowanych wyników o ważności INFO, WARNING lub ERROR, aby wykrywać problemy z odtwarzaniem lub zarabianiem w automatycznych testach integracji i potokach monitorowania produkcji.

Zasób najwyższego poziomu

Interfejs SAM API jest częścią interfejsu Google Ad Manager REST API (beta) w punkcie końcowym admanager.googleapis.com i udostępnia metodę tylko do odczytu networks.daiSessions.get. Możesz wysłać zapytanie do zasobu DaiSession, używając identyfikatora sesji z dynamicznym wstawianiem reklam lub niestandardowego klucza debugowania. DAI przechowuje zapisy sesji przez maksymalnie 3 dni po odtworzeniu.

Interfejs SAM API nie obsługuje wyświetlania wszystkich zasobów DaiSession w sieci Google Ad Managera.

Sprawdzanie odpowiedzi strumienia DAI za pomocą SAM

Aby sprawdzić, jak Google DAI przetwarza żądania strumienia, przeanalizuj odpowiedź DaiSession:

  • Interfejs DAI API w pełnej wersji: sprawdź pole creationContext.streamCreateRequest, aby zweryfikować wywołanie rejestracji strumienia, sprawdź mapy adSelections i adPods, aby sprawdzić decyzje dotyczące reklam, oraz sprawdź mapę adBreaks, aby potwierdzić czas trwania połączonej reklamy, kreacji planszy i treści.
  • Interfejs DAI API do wyświetlania bloków reklamowych: sprawdź, czy pole creationContext.stitchingType ma wartość POD_SERVING, porównaj pole adBreakId w mapach adPods i adBreaks z wywołaniami żądań manifestu lub segmentu bloku reklamowego i sprawdź sygnały po stronie serwera lub sygnały weryfikacji multimediów w mapie trackingPings.
  • Interfejs API przerw na reklamę DAI: dopasuj wartość breakSequence obiektu AdBreak do właściwości AdBreak.breakSequence.

Wysyłanie pierwszego żądania

Aby skonfigurować uwierzytelnianie i pobrać zasoby sesji DAI, przeczytaj artykuł Korzystanie z interfejsu API narzędzia do monitorowania aktywności w transmisji na żywo.