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 streaming sesi.
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 meningkat satu untuk setiap jeda iklan.
Nilai ini harus sama di seluruh pengguna yang melihat jeda iklan yang sama di peristiwa saat ini. |
pd
|
Wajib, kecuali untuk acara dengan jeda iklan tanpa durasi yang diaktifkan. | Durasi jeda iklan dalam milidetik. Di atas, disebutkan sebagai
ad_pod_duration.
|
scte35
|
Opsional | Sinyal SCTE-35 berenkode base64. Klien bertanggung jawab untuk memastikan
bahwa sinyal tersebut benar. Jika salah, pesan akan dikirim ke
Header HTTP X-Ad-Manager-Dai-Warning dalam respons dan
sinyal masih disebarluaskan untuk membuat jeda iklan. Lihat yang didukung
penanda iklan untuk informasi lebih lanjut tentang cara DAI menggunakan sinyal SCTE-35.
|
Membuat string token
cantumkan setiap parameter dalam urutan abjad, dalam format name=value, dengan setiap
pasangan nama-nilai yang dipisahkan dengan karakter tanda gelombang (~).
Parameter opsional tanpa nilai dapat dibiarkan pada tempatnya dengan string kosong untuk nilai, 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}
Buat tanda tangan HMAC
Tanda tangan HMAC adalah hash SHA-256 dari string token dalam format HEX. Tujuan kunci rahasia adalah Kunci autentikasi HMAC yang dikaitkan dengan acara livestream di Google Ad Manager.
String token tanda tangan
Setelah dibuat, tambahkan tanda tangan HMAC ke string token di format
~hmac={HMAC signature}
String token yang dienkode ke URL
Token ini diteruskan sebagai parameter URL, sehingga harus dienkode ke URL demi keamanan.
Contoh 1
Berikut adalah contoh saat parameter opsional yang tidak digunakan disertakan sebagai kosong {i>string<i}.
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 yang ditandatangani
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 jika 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 yang ditandatangani
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