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