(SSAI) untuk live stream dengan API penayangan Pod Penyisipan Iklan Dinamis (DAI) Google.
Setiap permintaan segmen yang dibuat menggunakan penayangan pod pengalihan segmen harus menyertakan token yang ditandatangani HMAC untuk autentikasi, jika tidak menggunakan notifikasi jeda iklan awal.
Token ini dapat dihitung satu kali per jeda iklan dan dibagikan di semua sesi streaming.
Mengumpulkan parameter token
Kumpulkan informasi berikut dari jeda iklan saat ini, untuk mengisi isi token.
| Parameter Token | ||
|---|---|---|
custom_asset_key
|
Wajib | Kunci aset livestream kustom, dari Google Ad Manager. |
cust_params
|
Opsional | Parameter penargetan kustom. Lihat cust_params.
|
exp
|
Wajib | Stempel waktu habis masa berlaku untuk token ini dalam detik. |
network_code
|
Wajib | Kode jaringan Ad Manager 360 untuk jaringan ini. |
pod_id
|
Wajib | ID untuk jeda iklan. Harus berupa bilangan bulat yang dimulai dari
1 dan bertambah satu untuk setiap jeda iklan.
Nilai ini harus sama untuk semua pengguna yang menonton jeda iklan yang sama dalam peristiwa saat ini. |
pd
|
Wajib, kecuali untuk peristiwa dengan jeda iklan tanpa durasi yang diaktifkan. | Durasi jeda iklan dalam milidetik. Disebutkan di atas sebagai
ad_pod_duration.
|
scte35
|
Opsional | Sinyal SCTE-35 berenkode base64. Klien bertanggung jawab untuk memastikan
bahwa sinyal sudah benar. Jika salah, pesan akan dikirim ke
header HTTP X-Ad-Manager-Dai-Warning dalam respons dan
sinyal tetap disebarkan untuk membuat jeda iklan. Lihat penanda iklan yang didukung untuk mengetahui informasi selengkapnya tentang cara DAI menggunakan sinyal SCTE-35.
|
Buat string token
mencantumkan setiap parameter dalam urutan abjad, dalam format name=value, dengan setiap
pasangan nama-nilai dipisahkan oleh karakter tilde (~).
Parameter opsional tanpa nilai dapat dibiarkan dengan string kosong untuk nilainya, atau dihapus seluruhnya.
format string token
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
Membuat tanda tangan HMAC
Tanda tangan HMAC adalah hash SHA-256 dari string token dalam format HEX. Kunci rahasia adalah kunci autentikasi HMAC yang terkait dengan acara live stream Anda di Google Ad Manager.
String token tanda tangan
Setelah dibuat, tambahkan tanda tangan HMAC ke string token dalam format berikut
~hmac={HMAC signature}
String token berenkode URL
Token ini diteruskan sebagai parameter URL, sehingga harus dienkode URL agar aman.
Contoh 1
Berikut contoh parameter opsional yang tidak digunakan disertakan sebagai string kosong.
String token
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
Kunci rahasia
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Tanda tangan HMAC
86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Token bertanda tangan
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Token bertanda tangan yang dienkode URL:
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
Contoh 2
Berikut adalah contoh saat variabel opsional yang tidak diisi dihilangkan sepenuhnya.
String token
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~exp=1489680000~network_code=6062~pd=180000~pod_id=5
Kunci rahasia
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Tanda tangan HMAC
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Token bertanda tangan
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
Token bertanda tangan yang dienkode URL
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9