Een DAI-sessie-ID of foutopsporingssleutel zoeken

Aan elke gebruikersstream wordt een sessie-ID toegewezen. Deze wordt opgeslagen tot 48 uur na een gebeurtenis. Gecontroleerde sessies worden 60 dagen opgeslagen. U kunt de sessie-ID opgeven in het veld Sessie-ID van de streamactiviteitscontrole (stream activity monitor, SAM). Via de zoekresultaten kunt u informatie bekijken over de advertentieverzoeken van gebruikers om problemen met een videostream op te lossen.

In dit artikel behandelen we de volgende manieren om een sessie-ID te achterhalen:

• Een sessie-ID zoeken in een app die gebruikmaakt van de IMA-SDK
• Een sessie-ID zoeken als u HTTP-verkeer inspecteert
• Een sessie-ID van een geëmuleerd HTTP-verzoek zoeken
• Een sessie-ID zoeken in een verzoek voor een SSB-stream

Een foutopsporingssleutel gebruiken om activiteit te bekijken of problemen met een videostream op te lossen ^(Bèta) 

U kunt ook een foutopsporingssleutel gebruiken om activiteit te bekijken of problemen met een videostream op te lossen.

U kunt een unieke sleutel instellen of doorgeven voor elke stream of sessie om de fouten in de stream op te sporen via 'Streamactiviteit controleren'. Als u dezelfde sleutel in verschillende sessies gebruikt, kan alleen de recentste sessie worden doorzocht en is alleen de recentste sessie beschikbaar voor foutopsporing.

• Met de IMA-SDK aangevraagde streams: raadpleeg de SDK-documentatie voor API-aanroepen om de sleutel in te stellen.
• Zonder de IMA-SDK aangevraagde streams (SSB): geef een foutopsporingssleutel door met de parameter dai-sam-id.

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

Sleutels kunnen geen persoonlijk identificeerbare informatie bevatten.

Een sessie-ID zoeken in een app die gebruikmaakt van de IMA-SDK

Als u de IMA-SDK gebruikt om een videostream te maken, kunt u een methode aanroepen om de sessie-ID op te halen. Bekijk de onderstaande informatie over hoe u de ID via de SDK van elk platform kunt ophalen:

• Android-SDK
• iOS-SDK
• tvOS-SDK
• HTML5-SDK
• Chromecast-SDK
• Roku-SDK

Veel app-ontwikkelaars kiezen ervoor om de sessie-ID vast te leggen in een logbestand, zodat deze beschikbaar is voor het oplossen van problemen met streams.

Aangezien de sessie-ID essentieel is om informatie over de advertentieweergave in de stream van een gebruiker te bekijken, is het handig om een methode of verborgen functie in uw app te implementeren waarmee makkelijk de ID kan worden weergegeven.

Een sessie-ID zoeken als u HTTP-verkeer inspecteert

U kunt HTTP-verzoeken controleren in een proxytool van een app die gebruikmaakt van de IMA-SDK.

Als u de IMA-SDK gebruikt om een DAI-videostream (dynamische advertentie-invoeging) aan te vragen, zijn er 2 HTTP-verzoeken:

• Het HTTP POST-verzoek, dat moet worden geretourneerd met een 201-status om aan te geven dat er een nieuwe stream is gemaakt.
• Het HTTP GET-verzoek naar de URL in het veld stream_manifest. *

Aanvullende informatie wordt geretourneerd in een JSON-structuur, inclusief de stream_id. Dit is de sessie-ID die u moet opgeven in het veld Sessie-ID.

Een sessie-ID van een geëmuleerd HTTP-verzoek zoeken

U kunt de opdracht curl via een opdrachtregelprompt uitvoeren, met de content-ID en video-ID van een stream-URL voor video on demand, om een reeks SDK HTTP-verzoeken te emuleren.

Bijvoorbeeld met de content-ID 12345 en de video-ID sample-video:

1. Typ het volgende achter een opdrachtregelprompt:

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

2. (Optioneel) Gebruik een pipe naar python -mjson.tool voor een weergave in pretty-print.

Voorbeelduitvoer *

{
"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"
}

^{* U kunt de URL stream_manifest gebruiken om de weergave in een HLS-speler (zoals de Safari-browser) te testen.}

Een sessie-ID zoeken in een verzoek voor een SSB-stream

Als u SSB gebruikt om een DAI-videostream aan te vragen, zijn er twee HTTP-verzoeken:

1. Het HTTP GET-verzoek, dat moet worden geretourneerd met een 302-status, wat duidt op een omleiding.
2. Het HTTP GET-verzoek naar de omleidings-URL. Deze URL bevat de sessie-ID die u moet opgeven in het veld Sessie-ID.

U kunt de sessie-ID ook zoeken als u de HTTP-verzoeken controleert in een proxytool van een mobiele of OTT-app.

Chrome gebruiken om een sessie-ID voor een SSB-streamverzoek te zoeken

1. Laad de contentstream-URL in een browser.

   Voorbeeld: Met de content-ID 12345 en de video-ID sample-video laadt u het volgende:
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. Laad de tools voor Chrome-ontwikkelaars in Chrome.
3. Ga naar het tabblad Netwerk van Ontwikkelaarstools.
4. Filter op verzoeken die dai.google.com bevatten.

5. De eerste twee verzoeken naar het domein dai.google.com moeten voor het bestand met de naam master.m3u8 zijn:

   Eerste verzoek: de 302-reactie

   

   Tweede verzoek: de URL met de sessie-ID

   
6. Kopieer de sessie-ID en geef deze op in het veld Sessie-ID.

Neem contact op met het supportteam voor uitgevers voor problemen met DAI-probleemoplossing of -uitval.