產生已簽署的 HMAC 權杖

如未使用初期廣告插播通知,使用區隔重新導向 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