驗證 DAI 影片串流請求

動態廣告插播 (DAI) 驗證金鑰的用途是證明影片串流請求確實由您送出。DAI 可提升廣告放送期間的安全性。金鑰是由 64 個字元和數字組成且不間斷的字串。部分較舊的金鑰可能只以 25 個字元或數字組成。

範例

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Static API 金鑰：當 API 金鑰與 HMAC 同時存在時，API 金鑰享有較高的優先順序。然而，HMAC 金鑰的安全性高於 API 金鑰的安全性。因此，建議使用 HMAC 金鑰。

HMAC：HMAC 型權杖驗證所提供的安全性會比靜態 API 金鑰的安全性更高。HMAC 權杖會使用秘密金鑰及有限持續時間，可確保該權杖無法在使用者或工作階段之間任意共用。

提示：驗證串流請求前，請確認您具備下列條件：

• HMAC 類型的動態廣告插播驗證金鑰
• 已為動態廣告插播設定直播活動

新增 HMAC 動態廣告插播驗證金鑰

產生並新增 HMAC 類型的動態廣告插播驗證金鑰：

1. 登入 Google Ad Manager。
2. 依序按一下「管理」及「影片和音訊」。
3. 選取「動態廣告插播驗證金鑰」。
4. 按一下「新增動態廣告插播驗證金鑰」。
5. 輸入新金鑰的名稱。選取「HMAC」。
6. 按一下「儲存」。

啟用驗證後，系統會在直播中加入這組金鑰。

啟用對 DAI API 提出的請求進行驗證

將 HMAC 金鑰連結至串流：

1. 登入 Google Ad Manager。
2. 依序按一下「影片」和「直播」。
3. 從清單中選取直播，或按一下「新增直播」。進一步瞭解如何建立新的直播。
4. 在「一般設定」下方：
   1. 在「廣告連播資源驗證金鑰」選取「已啟用」，驗證廣告連播請求和/或
   2. 選取「啟用」，為「串流建立驗證金鑰」，驗證串流工作階段請求
5. 選取您建立的 HMAC 金鑰。
6. 按一下「儲存」。

要查看並複製金鑰，請返回詳細資訊頁面。建立有效的動態廣告插播驗證金鑰後，您就可以立即使用。將金鑰嵌入用戶端影片應用程式，您會在該處提出 DAI 串流請求。

提示：最佳做法是為每個用戶端平台 (例如 iOS、Android 和網頁) 分別產生 DAI 驗證金鑰。

儲存後，金鑰會自動設為「有效」。只有正確導入「有效」的金鑰，才能驗證要求。

使用已停用金鑰的請求將會遭到拒絕。建議只在金鑰遭到盜用或不允許使用的情況下，才停用金鑰。

停用現有的驗證金鑰

如要停用驗證金鑰，請按照下列步驟操作：

1. 登入 Google Ad Manager。
2. 依序點按「管理」、「影片和音訊」和「動態廣告插播驗證金鑰」。
3. 從清單中選取要停用的金鑰。
4. 選取「無效」狀態。
5. 按一下「儲存」。

導入驗證金鑰

HMAC 金鑰

瞭解如何導入 HMAC 驗證。

API 金鑰

使用 IMA SDK 來設定 apiKey 物件中的 apiKey 屬性。詳情請參閱 iOS、Android、Chromecast 或 tvOS 開發人員說明文件。

對於伺服器端信標 (SSB)，請使用 api-key 查詢參數：

curl "https://dai.google.com/ondemand/hls/content/CMS_ID/vid/VIDEO_ID/master.m3u8?api-key=<api-authentication-key>"

如有任何與 DAI 疑難排解或服務中斷相關的問題，請與發布商支援團隊聯絡。