如未使用初期廣告插播通知,使用區隔重新導向 Pod 服務提出的每個區隔要求,都必須包含 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 雜湊。密鑰是與 Google Ad Manager 直播活動相關聯的 HMAC 驗證金鑰。
簽署權杖字串
產生後,請使用下列格式將 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