第三者広告サーバー経由で Google アドマネージャーのシグナルを送信する

Google アドマネージャーのサーバーサイド広告挿入（SSAI）で第三者広告サーバーを使用している場合、IMA は、第三者広告サーバーからアドマネージャーに暗号化されたノンスを送信することで、Google アドマネージャーを介して追加の広告枠を収益化できます。このガイドでは、IMA SDK を使用してこれらのシグナルを送信する方法について説明します。

このガイドでは、サンプル広告タグ https://youradserver.com を使用します。実際の広告サーバーで動作するように広告タグを更新する必要があります。

前提条件

IMA HTML5 SDK v3.523.0 以降。
スタートガイドを完了している。

1. Google の DAI サーバーにノンスを送信するようにアプリを設定します

enableNonce を true に設定すると、IMA DAI SDK が暗号化されたノンスを DAI サーバーに送信します。

const streamRequest = new LiveStreamRequest();
streamRequest.enableNonce = true;

2. ノンスを入力するマクロで広告タグを更新する

アドマネージャーの管理画面で、広告サーバーのタグにマクロ [GOOGLE_INSTREAM_VIDEO_NONCE] を追加します。DAI サーバーがミッドロール挿入点に第三者広告サーバーの URL を入力すると、アドマネージャーから暗号化されたノンスがマクロに動的に挿入されます。結果は、サードパーティサーバーで構成する必要があるキーを使用する次のサンプル広告タグに似ているはずです。

https://youradserver.com?ad_manager_nonce=[GOOGLE_INSTREAM_VIDEO_NONCE]

この広告タグでは、ad_manager_nonce をサンプルキーとして使用していますが、ノンス値を受け入れる方法については、サードパーティ広告サーバーに確認する必要があります。

アドマネージャーで広告サーバーのタグを更新するには、[動画 > ライブ配信] に移動し、アクティブなライブ配信を選択するか、新規に作成します。

次に、選択したストリーム内に設定された広告タグにこのマクロを追加します。[ミッドロール挿入点の設定] > [マスター広告タグ] でタグを設定します。

3. 第三者広告サーバーのアドマネージャーのリクエストを設定する

アドマネージャーへのサーバーリクエストにノンスが含まれるように、第三者広告サーバーを設定します。第三者広告サーバー内で設定された広告タグの例を次に示します。

https://pubads.g.doubleclick.net/gampad/ads?givn=%%custom_key_for_google_nonce%%&iu=/21775744923/external/single_ad_samples&sz=640x480

アドマネージャーでは、givn= を探してノンスの値を識別します。第三者広告サーバーは、%%custom_key_for_google_nonce%% などの独自のマクロをいくつかサポートし、前のステップで指定したノンスクエリパラメータに置き換える必要があります。詳しくは、第三者広告サーバーのドキュメントをご覧ください。

注: このガイドでは 2 つのマクロを使用します。

第三者広告サーバーに送信する広告リクエストには、[GOOGLE_INSTREAM_VIDEO_NONCE] マクロを含める必要があります。この広告タグはアドマネージャーの管理画面に保存されます。IMA SDK は（大文字と小文字を区別、完全一致で）検索し、このマクロを暗号化されたノンスに置き換えます。
2 つ目のマクロ %%custom_key_for_google_nonce%% は、第三者広告サーバーによって、Google アドマネージャーへのリクエストの暗号化されたノンスの入力に使用されます。このマクロは一例であり、第三者広告サーバーが受け入れる任意の文字列に構成できます。

これで、これで、ノンスパラメータが IMA DAI SDK から DAI サーバーを経由して第三者広告サーバーに送信され、アドマネージャーに渡されるようになりました。これにより、Google アドマネージャーでの収益化が促進されます。