Membuat token HMAC yang ditandatangani

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