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
STITCHEDlubPOD_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,WARNINGlubERROR, 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ź mapyadSelectionsiadPods, 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.stitchingTypema wartośćPOD_SERVING, porównaj poleadBreakIdw mapachadPodsiadBreaksz wywołaniami żądań manifestu lub segmentu bloku reklamowego i sprawdź sygnały po stronie serwera lub sygnały weryfikacji multimediów w mapietrackingPings. - Interfejs API przerw na reklamę DAI: dopasuj wartość
breakSequenceobiektuAdBreakdo właściwościAdBreak.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.