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 sekali per jeda iklan dan dibagikan ke 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 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 meningkat satu untuk setiap jeda iklan.
Nilai ini harus sama untuk semua pengguna yang melihat jeda iklan yang sama pada peristiwa saat ini. |
pd
|
Wajib, kecuali untuk acara yang mengaktifkan jeda iklan tanpa durasi. | Durasi jeda iklan dalam milidetik. Disebut di atas sebagai
ad_pod_duration.
|
scte35
|
Opsional | Sinyal SCTE-35 berenkode base64. Klien bertanggung jawab untuk memastikan
bahwa sinyal benar. Jika salah, pesan akan dikirim ke header HTTP
X-Ad-Manager-Dai-Warning dalam respons dan
sinyal masih disebarkan untuk membuat jeda iklan. Lihat penanda
iklan yang didukung untuk informasi selengkapnya tentang cara DAI menggunakan sinyal SCTE-35.
|
Buat string token
Cantumkan setiap parameter dalam urutan abjad, dalam format name=value, dengan setiap pasangan nama-nilai dipisahkan dengan karakter tilde (~).
Parameter opsional tanpa nilai dapat dibiarkan dengan string kosong untuk nilai tersebut, atau dihapus sepenuhnya.
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 rahasianya adalah kunci autentikasi HMAC yang terkait dengan acara livestream 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 enkode URL
Token ini diteruskan sebagai parameter URL, sehingga harus dienkode ke URL untuk keamanan.
Contoh 1
Berikut adalah contoh saat 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 dengan variabel opsional yang tidak terisi 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