產生已簽署的 HMAC 權杖

如果透過區隔重新導向廣告連播放送方式提出,每個區隔要求都必須包含 用於驗證的 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