如果透過區隔重新導向廣告連播放送方式提出,每個區隔要求都必須包含 用於驗證的 HMAC 簽署憑證 (如未使用) 即將到來的廣告插播通知。
每個廣告插播時間點可以計算這個權杖一次,並在所有串流中共用 工作階段。
收集權杖參數
從目前的廣告插播收集下列資訊來填入 符記主體
權杖參數 | ||
---|---|---|
custom_asset_key
|
必要 | Google Ad Manager 提供的自訂直播素材資源鍵。 |
cust_params
|
選用 | 自訂指定參數。詳情請參閱 cust_params 。
|
exp
|
必要 | 這個權杖的到期時間戳記 (以秒為單位)。 |
network_code
|
必要 | 這個聯播網的 Ad Manager 360 聯播網代碼。 |
pod_id
|
必要 | 廣告插播的 ID。須為整數,開頭應為
1 ,並針對每個廣告插播增加 1 次。
在所有查看相同廣告插播時間點的所有使用者,這個值都必須相同 目前的事件。 |
pd
|
必填 (啟用未指定時間長度廣告時段的事件除外)。 | 廣告插播的時間長度 (以毫秒為單位)。上述指的是
ad_pod_duration 。
|
scte35
|
選用 | 採用 Base64 編碼的 SCTE-35 信號。客戶必須負責確保
訊號是否正確無誤如果不正確,系統會將訊息傳送至
回應中的 X-Ad-Manager-Dai-Warning HTTP 標頭和
但信號仍會傳播以建立廣告插播時間點詳情請參閱支援
廣告標記,進一步瞭解 DAI 如何使用 SCTE-35 信號。
|
建立符記字串
按字母順序列出每個參數,格式為 name=value
,
名稱值組合,並以波浪號 (~
) 字元分隔。
沒有值的選用參數可以放在沒有值的選用參數中,但保留空白字串 或完全移除
權杖字串格式
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
產生 HMAC 簽章
HMAC 簽章是權杖字串的 SHA-256 雜湊,採用 HEX 格式。 密鑰則是 HMAC 驗證金鑰 與 Google Ad Manager 中的直播活動建立關聯
簽署權杖字串
產生憑證後,請將 HMAC 簽名附加至以下字串中的憑證字串: 格式
~hmac={HMAC signature}
網址編碼權杖字串
這個權杖是以網址參數的形式傳遞,因此必須採用網址編碼以確保安全。
範例 1
以下範例將未使用的選用參數設為空白 字串。
權杖字串
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
Secret 金鑰
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC 簽章
86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
已簽署的權杖
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
網址編碼簽署權杖:
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
範例 2
在以下範例中,系統會完全省略未填入的選用變數。
權杖字串
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~exp=1489680000~network_code=6062~pd=180000~pod_id=5
Secret 金鑰
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC 簽章
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
已簽署的權杖
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
網址編碼的已簽署權杖
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9