Menemukan ID sesi DAI atau kunci debug

Setiap streaming yang dilakukan pengguna akan diberi ID sesi, yang disimpan selama 48 jam setelah acara. Sesi yang dipantau akan disimpan selama 60 hari. Anda dapat memasukkan ID sesi ke kolom "ID sesi" dari pemantauan aktivitas streaming (SAM). Hasil penelusuran memungkinkan Anda melihat detail tentang permintaan iklan pengguna untuk memecahkan masalah streaming video.

Kami akan membahas cara berikut untuk menemukan ID sesi:

• Menemukan ID sesi di aplikasi yang menggunakan IMA SDK
• Menemukan ID sesi saat memeriksa traffic HTTP
• Menemukan ID sesi dari permintaan HTTP yang diemulasi
• Menemukan ID sesi dalam permintaan streaming SSB

Menggunakan kunci debug untuk melihat aktivitas atau memecahkan masalah streaming video ^(Beta) 

Atau, Anda dapat menggunakan kunci debug untuk melihat aktivitas atau memecahkan masalah streaming video.

Anda dapat menyetel atau memberikan kunci unik streaming atau sesi agar dapat melakukan debug streaming menggunakan SAM. Jika Anda menggunakan kunci yang sama di semua sesi, hanya sesi terbaru yang dapat ditelusuri dan dapat di-debug.

• Streaming yang diminta dengan IMA SDK: lihat dokumentasi SDK tentang panggilan API untuk menyetel kunci.
• Streaming yang diminta tanpa IMA SDK (SSB): berikan kunci debug menggunakan parameter dai-sam-id.

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

Kunci tidak boleh berisi informasi identitas pribadi.

Menemukan ID sesi di aplikasi yang menggunakan IMA SDK

Jika menggunakan IMA SDK untuk membuat streaming video, Anda dapat memanggil sebuah metode untuk mendapatkan ID sesi. Lihat detail cara mendapatkan ID di setiap SDK platform:

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

Banyak developer aplikasi memilih untuk menangkap ID sesi dan mencatatnya dalam log agar tersedia untuk pemecahan masalah streaming.

Karena pentingnya ID sesi dalam meninjau detail terkait penayangan iklan di streaming pengguna, sebaiknya terapkan metode atau fitur tersembunyi di aplikasi Anda untuk menampilkan ID dengan mudah.

Menemukan ID sesi saat memeriksa traffic HTTP

Anda dapat memantau permintaan HTTP di alat proxy dari aplikasi yang menggunakan IMA SDK.

Saat menggunakan IMA SDK untuk meminta streaming video Penyisipan Iklan Dinamis (DAI), ada dua permintaan HTTP:

• HTTP POST yang akan menampilkan status 201, menunjukkan bahwa streaming baru telah dibuat.
• Permintaan HTTP GET ke URL di kolom stream_manifest. *

Informasi tambahan ditampilkan dalam struktur JSON, dengan menyertakan stream_id. Ini adalah ID sesi yang akan Anda masukkan ke kolom "ID sesi".

Menemukan ID sesi dari permintaan HTTP yang diemulasi

Anda dapat mengemulasikan urutan permintaan HTTP SDK menggunakan curl dari permintaan command line, dengan ID konten dan ID video dari URL streaming video on demand.

Misalnya, menggunakan ID konten 12345 dan ID video sample-video:

1. Ketik hal berikut dari permintaan baris perintah:

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

2. (Opsional) Beri batas pipa pada  python -mjson.tool untuk melihat dalam bentuk pretty print.

Contoh output *

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

^{* Anda mungkin dapat menggunakan URL stream_manifest untuk menguji pemutaran di pemutar HLS (misalnya, di browser web Safari).}

Menemukan ID sesi dalam permintaan streaming SSB

Saat menggunakan SSB untuk meminta streaming video Penyisipan Iklan Dinamis (DAI), ada dua permintaan HTTP:

1. Permintaan HTTP GET, yang akan menampilkan status 302, menunjukkan adanya pengalihan.
2. Permintaan HTTP GET ke URL yang dialihkan. URL ini berisi "ID sesi" yang akan Anda masukkan ke kolom "ID sesi".

Anda juga dapat menemukan ID sesi saat memantau permintaan HTTP di alat proxy dari aplikasi seluler atau OTT.

Menemukan ID sesi untuk permintaan streaming SSB menggunakan Chrome

1. Muat URL streaming konten di browser.

   Misalnya, dengan menggunakan ID konten 12345 dan ID video sample-video, muat:
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. Di Chrome, muat Developer Tools.
3. Buka tab Jaringan di Developer Tools.
4. Filter permintaan yang menyertakan dai.google.com.

5. Dua permintaan pertama ke domain "dai.google.com" akan berupa file yang bernama "master.m3u8":

   Permintaan pertama: Respons 302

   

   Permintaan kedua: URL dengan ID sesi

   
6. Salin ID sesi dan masukkan ID tersebut ke kolom ID sesi.

Untuk mengatasi persoalan terkait pemecahan masalah atau pemadaman DAI, hubungi dukungan penayang.