Sitzungs-ID für die dynamische Anzeigenbereitstellung oder Schlüssel zur Fehlerbehebung finden

Jedem Nutzerstream wird eine Sitzungs-ID zugeordnet, die nach einem Ereignis 48 Stunden lang gespeichert wird. Überwachte Sitzungen werden 60 Tage gespeichert. Sie können die Sitzungs-ID im Feld „Sitzungs-ID“ der „Überprüfung der Streamingaktivitäten“ eingeben. In den Suchergebnissen erhalten Sie detaillierte Informationen zu Nutzeranzeigenanfragen und zum Beheben von Problemen mit einem Videostream.

In diesem Artikel werden folgende Möglichkeiten zum Finden einer Sitzungs-ID behandelt:

• Sitzungs-ID in einer App finden, in der das IMA SDK verwendet wird
• Sitzungs-ID finden, wenn der HTTP-Traffic untersucht wird
• Sitzungs-ID anhand einer emulierten HTTP-Anfrage finden
• Sitzungs-ID in einer SSB-Streamanfrage finden

Schlüssel zur Fehlerbehebung verwenden, um Aktivitäten anzusehen oder Probleme mit einem Videostream zu beheben ^(Beta) 

Alternativ können Sie einen Schlüssel zur Fehlerbehebung verwenden, um Aktivitäten zu sehen oder Probleme mit einem Videostream zu beheben.

Sie haben die Möglichkeit, einen eindeutigen Schlüssel für jeden Stream oder jede Sitzung festzulegen oder zu übergeben, um mit der Überwachung der Streamingaktivitäten eine Fehlerbehebung für den Stream durchführen zu können. Wenn Sie denselben Schlüssel für verschiedene Sitzungen verwenden, ist nur die aktuelle Sitzung suchbar und steht für die Fehlerbehebung zur Verfügung.

• Streams, die mit dem IMA SDK angefragt werden: Informationen zum Festlegen des Schlüssels finden Sie in der SDK-Dokumentation für den API-Aufruf.
• Streams, die ohne IMA SDK angefragt werden (SSB-Anfrage): Übergeben Sie einen Schlüssel zur Fehlerbehebung mit dem Parameter dai-sam-id.

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

Schlüssel dürfen keine personenidentifizierbare Informationen enthalten.

Sitzungs-ID in einer App finden, in der das IMA SDK verwendet wird

Wenn Sie das IMA SDK einsetzen, um einen Videostream zu erstellen, können Sie eine Methode aufrufen, um die Sitzungs-ID festzustellen. Hier finden Sie Informationen dazu, wie Sie die ID mit dem SDK für die jeweilige Plattform erhalten:

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

Viele Anwendungsentwickler entscheiden sich, die Sitzungs-ID zu erfassen und zu protokollieren, damit sie verfügbar ist, wenn Probleme mit dem Stream behoben werden sollen.

Da die Sitzungs-ID unerlässlich ist, um Details zur Anzeigenauslieferung in einem Nutzerstream zu prüfen, ist es hilfreich, eine Methode oder eine versteckte Funktion in Ihrer Anwendung zu implementieren, mit der die ID ganz einfach angezeigt werden kann.

Sitzungs-ID finden, wenn der HTTP-Traffic untersucht wird

Sie können über eine Anwendung, in der das IMA SDK eingesetzt wird, HTTP-Anfragen in einem Proxytool überwachen.

Wenn Sie das IMA SDK verwenden, um einen Videostream für die dynamische Anzeigenbereitstellung anzufordern, sind zwei HTTP-Anfragen verfügbar:

• Die HTTP-POST-Anfrage, die den 201-Status zurückgeben sollte, was bedeutet, dass ein neuer Stream erstellt wurde
• Die HTTP-GET-Anfrage an die URL im Feld stream_manifest *

Zusätzliche Informationen werden in einer JSON-Struktur zurückgegeben, die die stream_id enthält. Dies ist die Sitzungs-ID, die Sie in das Feld „Sitzungs-ID“ eingeben sollten.

Sitzungs-ID anhand einer emulierten HTTP-Anfrage finden

Sie können eine Abfolge von SDK-HTTP-Anfragen simulieren, indem Sie in einer Befehlszeile curl eingeben und die Content-ID und Video-ID aus einer VOD-Stream-URL verwenden.

Beispielsweise können Sie die Content-ID 12345 und Video-ID sample-video verwenden:

1. Geben Sie an der Eingabeaufforderung Folgendes ein:

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

2. (Optional) Pipe an python -mjson.tool zum Ansehen in der Quelltextformatierung.

Beispielausgabe*

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

^{* Sie können die URL stream_manifest verwenden, um die Wiedergabe in einem HLS-Player (z. B. im Webbrowser Safari) zu testen.}

Sitzungs-ID in einer SSB-Streamanfrage finden

Wenn Sie serverseitiges Beaconing (SSB) verwenden, um einen Videostream für die dynamische Anzeigenbereitstellung anzufordern, sind zwei HTTP-Anfragen verfügbar:

1. Die HTTP-GET-Anfrage, die einen 302-Status zurückgeben sollte, um auf eine Weiterleitung hinzuweisen.
2. Die HTTP-GET-Anfrage an die weitergeleitete URL. Diese URL enthält die Sitzungs-ID, die Sie in das Feld „Sitzungs-ID“ eingeben sollten.

Sie können die Sitzungs-ID auch finden, wenn Sie die HTTP-Anfragen in einem Proxytool überwachen, und zwar von einer mobilen oder OTT-Anwendung (Over-the-top) aus.

Sitzungs-ID für eine SSB-Streamanfrage mithilfe von Chrome anfordern

1. Laden Sie die Contentstream-URL in einem Browser.

   Beispielsweise wird mit der Content-ID 12345 und der Video-ID sample-video Folgendes geladen:
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. Rufen Sie in Chrome die Entwicklertools auf.
3. Gehen Sie dort zum Tab Netzwerk.
4. Filtern Sie nach Anfragen, die dai.google.com enthalten.

5. Die ersten beiden Anfragen an die Domain „dai.google.com“ sollten sich an eine Datei namens „master.m3u8“ richten:

   Erste Anfrage: die 302-Antwort

   

   Zweite Anfrage: die URL mit der Sitzungs-ID

   
6. Kopieren Sie die Sitzungs-ID und geben Sie sie in das Feld Sitzungs-ID ein.

Wenden Sie sich bei Problemen oder Ausfällen bei der dynamischen Anzeigenbereitstellung an den Publisher-Support.