Membuat token HMAC yang ditandatangani

Setiap permintaan segmen atau manifes yang dibuat menggunakan penayangan pod harus menyertakan token yang ditandatangani HMAC untuk autentikasi, sebagai penggantian 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
ad_break_id Wajib diisi jika parameter pod_id tidak diberikan. ID string untuk jeda iklan.
custom_asset_key Wajib diisi jika parameter event tidak diberikan. Kunci aset livestream kustom, dari Google Ad Manager.
cust_params Opsional Parameter penargetan kustom untuk jeda iklan.
event Wajib diisi jika parameter custom_asset_key tidak diberikan. Kunci aset live stream, yang dihasilkan oleh Google Ad Manager.
exp Wajib Stempel waktu habis masa berlaku untuk token ini dalam detik.
network_code Wajib jika parameter custom_asset_key diberikan. Kode jaringan Ad Manager 360 untuk jaringan ini.
pod_id Wajib diisi jika parameter ad_break_id tidak diberikan. ID numerik untuk jeda iklan.
pd Wajib diisi, kecuali untuk peristiwa dengan jeda iklan tanpa durasi yang diaktifkan. Durasi jeda iklan dalam milidetik.
scte35 Opsional Sinyal SCTE-35 yang dienkode dengan Base64 untuk jeda iklan.

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 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 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

cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=

Kunci rahasia

A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F

Tanda tangan HMAC

ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e

Token bertanda tangan

cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e

Token bertanda tangan yang dienkode URL:

cust_params%3D~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3Dea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e

Contoh 2

Berikut adalah contoh saat variabel opsional yang tidak diisi dihilangkan sepenuhnya.

String token

custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~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

Contoh 3

Berikut adalah contoh dengan ad_break_id.

String token

ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000
Kunci rahasia
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
Tanda tangan HMAC
327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29

Token bertanda tangan

ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~hmac=327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29

Token bertanda tangan yang dienkode URL

ad_break_id%3Dadbreak1~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~hmac%3D327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29