ダイナミック広告挿入(DAI)認証キーは、動画ストリーム リクエストの送信元がお客様自身であることを証明するために使用します。DAI を使用すると、広告配信中のセキュリティを向上できます。キーは 64 文字の英数字で構成されます(空白は含みません)。一部の古いキーは、25 文字の英数字で構成される場合もあります。
例:0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B
認証キーを作成するには次のいずれかを使用します。手順はどちらも同じです。
静的な API キー: API と HMAC の両方のキーが含まれる場合は、API が HMAC よりも優先されます。API キーは HMAC キーよりもセキュリティが低いため、HMAC キーの使用をおすすめします。
HMAC (ベータ版) : HMAC ベースのトークン認証を使用する場合は、staticAPI キーよりもセキュリティが高まります。ユーザー間やセッション間で簡単にトークンを共有できないよう、HMAC トークンでは秘密鍵が使用され、有効期間も制限されるためです。
新しい認証キーを追加する
- Google アド マネージャーにログインします。
- [管理者] [動画] [DAI 認証キー] をクリックします。
- [新しい認証キー] をクリックします。
- [名前] に、キーを識別しやすい名前を入力します。
- 認証キーの [タイプ] として [API] または [HMAC] を選択します。
API と HMAC の両方のキーが含まれる場合は、API が HMAC よりも優先されます。API キーは HMAC キーよりもセキュリティが低くなります。
- [保存] をクリックします。
キーを表示したりコピーしたりするには、詳細ページに戻ります。有効な DAI 認証キーを作成したら、すぐに使用を開始できます。広告を動的に挿入する部分にキーを埋め込んでください。
保存すると、キーは自動的に「有効」に設定されます。リクエストを検証できるのは、正しく実装された「有効」なキーのみです。
無効なキーを使用したリクエストは拒否されます。キーの無効化は、セキュリティ上の問題がある場合にのみ行ってください。
既存の認証キーを無効にする
- Google アド マネージャーにログインします。
- [管理者] [動画] [DAI 認証キー] をクリックします。
- 無効にするキーの名前をクリックします。
- ステータスとして [無効] を選択します。
- [保存] をクリックします。
認証キーを実装する
HMAC キー (ベータ版)
HMAC 認証を実装する方法をご覧ください。
API キー
IMA SDK を使用して、IMAStreamRequest
オブジェクトの 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>"