Lokalizowanie klucza debugowania lub identyfikatora sesji z dynamicznym wstawianiem reklam

Każdy strumień do użytkownika otrzymuje identyfikator sesji, który jest przechowywany przez 48 godzin po zdarzeniu. Monitorowane sesje są przechowywane przez 60 dni. Możesz wpisać identyfikator sesji w polu „Identyfikator sesji” w narzędziu do monitorowania aktywności w transmisji na żywo (SAM). Wyniki wyszukiwania pozwalają przeglądać szczegółowe informacje o żądaniach reklamy wysyłanych przez użytkowników i rozwiązywać problemy ze strumieniem wideo.

Sposoby odnalezienia identyfikatora sesji, które omówimy:

• Znajdowanie identyfikatora sesji w aplikacji korzystającej z pakietu IMA SDK
• Znajdowanie identyfikatora sesji podczas analizy ruchu HTTP
• Znajdowanie identyfikatora sesji z emulowanego żądania HTTP
• Znajdowanie identyfikatora sesji w żądaniu strumienia SSB

Używanie klucza debugowania do wyświetlania aktywności i rozwiązywania problemów ze strumieniem wideo ^(Beta) 

Możesz też użyć klucza debugowania, aby wyświetlić aktywność lub rozwiązać problemy ze strumieniem wideo.

Możesz ustawić lub przekazać unikalny klucz do każdego strumienia lub sesji, aby umożliwić debugowanie strumienia za pomocą narzędzia SAM. Jeśli używasz tego samego klucza w wielu sesjach, możesz przeszukiwać i debugować tylko ostatnią.

• Żądanie strumienia za pomocą pakietu IMA SDK: zapoznaj się z informacjami dotyczącymi wywołania API w dokumentacji pakietu SDK, aby ustawić klucz.
• Żądanie strumienia bez pakietu IMA SDK (SSB): przekaż klucz debugowania, korzystając z parametru dai-sam-id.

  _{Na przykład: https://dai.google.com/linear/hls/event/.../master.m3u8?dai-sam-id=abcdef-0a1b-12a3}

Klucze nie mogą zawierać żadnych danych umożliwiających identyfikację osób.

Znajdowanie identyfikatora sesji w aplikacji korzystającej z pakietu IMA SDK

Gdy tworzysz strumień wideo, używając pakietu IMA SDK, możesz wywołać odpowiednią metodę, aby uzyskać identyfikator sesji. Szczegółowe instrukcje, jak to zrobić za pomocą pakietu SDK na danej platformie, znajdziesz tutaj:

• SDK na Androida
• SDK na iOS
• SDK na tvOS
• SDK w HTML5
• SDK na Chromecasta
• SDK na Roku

Wielu deweloperów aplikacji decyduje się na przechwytywanie identyfikatora sesji i zapisywanie go w dzienniku, aby móc rozwiązywać problemy ze strumieniem.

Identyfikator sesji jest niezbędny do sprawdzenia szczegółowych informacji o wyświetlaniu reklam w strumieniu do użytkownika, dlatego warto zaimplementować w aplikacji metodę lub ukrytą funkcję, która będzie go pokazywać.

Znajdowanie identyfikatora sesji podczas analizy ruchu HTTP

W narzędziu serwera proxy możesz monitorować żądania HTTP z aplikacji, która korzysta z pakietu IMA SDK.

Gdy wysyłasz żądanie strumienia wideo z dynamicznym wstawianiem reklam (DAI), używając pakietu IMA SDK, generowane są dwa żądania HTTP:

• HTTP POST, które powinno zwrócić stan 201, wskazując, że utworzono nowy strumień;
• HTTP GET na adres URL podany w polu stream_manifest.

Dodatkowe informacje przychodzą w strukturze JSON – w tym parametr stream_id. Jest to identyfikator sesji, który należy wpisać w polu „Identyfikator sesji”.

Znajdowanie identyfikatora sesji z emulowanego żądania HTTP

Żądanie HTTP z pakietu SDK możesz emulować w wierszu poleceń za pomocą narzędzia curl z identyfikatorami treści i wideo, które pochodzą z adresu URL strumienia wideo na żądanie.

Przykład z identyfikatorem treści 12345 i identyfikatorem wideo sample-video:

1. W wierszu poleceń wpisz:

   curl --data "" "http://dai.google.com/ondemand/hls/content/12345/vid/sample-vide/streams"

2. (Opcjonalnie) Przekieruj wyniki do narzędzia python -mjson.tool, aby zobaczyć je w postaci sformatowanej.

Przykładowe wyniki*

{
"duration": 784,
"stream_id": "19b40be0-7942-44ca-97e0-fc7b27f14029",
"stream_manifest": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/master.m3u8",
"stream_type": "on_demand",
"subtitles": [ ... ],
"time_events_url": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/time-events.json"
}

^{* Możesz użyć adresu URL z pola stream_manifest, aby przetestować wyświetlanie w odtwarzaczu HLS (na przykład w przeglądarce Safari).}

Znajdowanie identyfikatora sesji w żądaniu strumienia SSB

Gdy wysyłasz żądanie strumienia wideo z dynamicznym wstawianiem reklam, używając sygnalizowania po stronie serwera (SSB), generowane są dwa żądania HTTP:

1. HTTP GET, które powinno zwrócić stan 302, wskazując przekierowanie;
2. HTTP GET na przekierowanie zawierające „identyfikator sesji”, który należy wpisać w polu „Identyfikator sesji”.

Identyfikator sesji możesz też znaleźć wtedy, gdy w narzędziu serwera proxy monitorujesz żądania HTTP z aplikacji mobilnej lub zgodnej ze standardem OTT.

Znajdowanie identyfikatora sesji w przypadku żądania strumienia SSB w Chrome

1. Wczytaj URL strumienia treści w przeglądarce.

   W przypadku identyfikatora treści 12345 i identyfikatora filmu sample-video wczytaj:
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. W Chrome przejdź do Narzędzi dla deweloperów.
3. W Narzędziach dla deweloperów otwórz kartę Network (Sieć).
4. Przefiltruj żądania, aby zobaczyć te z domeną dai.google.com.

5. Dwa pierwsze żądania do domeny „dai.google.com” powinny dotyczyć pliku „master.m3u8”.

   Pierwsze żądanie: odpowiedź 302

   

   Drugie żądanie: adres URL z identyfikatorem sesji

   
6. Skopiuj identyfikator sesji i wklej go w polu Identyfikator sesji.

W kwestiach związanych z rozwiązywaniem problemów z systemem DAI lub przerwami w jego działaniu kontaktuj się z zespołem pomocy dla wydawców.