ストリームにターゲティング パラメータを指定する

下記のターゲティング パラメータの指定はいずれも任意です。

ビデオ オンデマンド(VOD)のコンテンツ ソースを作成または設定する際や、ダイナミック広告挿入(DAI)のライブ ストリームを設定する際は、デフォルトの動画広告タグを指定する必要があります。すべての DAI ストリームでは、指定した広告タグとそのパラメータがデフォルトで使用されます。プレーヤーから個々のストリームに合わせて独自の広告がリクエストされるようにしたい場合は、以下の方法を使用できます。

デフォルトの広告タグをオーバーライドする

動画プレーヤーからストリームがリクエストされると、管理画面で指定したとおりのデフォルトの広告タグが使用されます。このタグの一部のパラメータについては、ストリーム リクエスト内でオーバーライドすることができます。該当のパラメータは以下のとおりです。

パラメータ 説明 値の例
iu

現在の広告ユニット。次の形式を使用します。

/network_id/directory/ad_unit

iu=/6062/video/example_unit
cust_params

アド マネージャー キャンペーンのターゲティングで使用する Key-Value ペア。一部のプラットフォームでは URL エンコーディングが必要です。

複数の Key-Value ペアの例:

  • section=sports 
  • page=baseball,tennis
 

SSB ストリーム: cust_params 値全体をエンコードして連結しますが、さらにエンコードすることはありません。

cust_params=
  "section%3Dsports
  %26page%3Dbaseball%2Ctennis"

 

HTML5Chromecast:
値のみをエンコードします。

streamRequest.adTagParameters = {
  "cust_params": "section=sports&
  multi=baseball%2Ctennis"};

 

Roku: cust_params 値全体をエンコードして連結しますが、さらにエンコードすることはありません。

request.adTagParameters =   "cust_params=section%3Dsports
  %26page%3Dbaseball%2Ctennis"

 

iOStvOS: エンコードはしません。

request.adTagParameters = @{
  @"cust_params" : @"section=sports&
  multi=baseball,tennis"};

 

Android: エンコードはしません。

Map<String, String> adTagParams =
  new HashMap<>();
  adTagParams.put("cust_params",
  "ge=0&gr=2");

sz

デフォルトの広告タグの sz パラメータをオーバーライドします。これにより、デバイスに合わせて動的にサイズを設定できます。

サイズの末尾に「v」を付けないでください。

sz=400x300
tfcd

リクエストに子供向け取り扱いのタグを設定します。詳細

tfcd=1

description_url

ページで再生される動画について説明しているページの URL。通常は動画プレーヤーが置かれているページの URL になりますが、動画の説明を別途記載したページを指定することもできます。

description_url の値は、SSB ストリームの場合と、HTML5 または Roku の SDK を使用する場合は、常に URL エンコードする必要があります。


このフィールドは、Ad Exchange を使用している場合は必須です。詳細

URL エンコードした値の例:
description_url=
http%3A%2F%2Fwww.sample.com
%2Fgolf.html

エンコードなしの値の例:
description_url=
http://www.sample.com/golf.html

ppid フリークエンシー キャップ、オーディエンス セグメンテーションとターゲティング、広告の順次ローテーション、オーディエンスに基づくその他の広告配信設定を複数のデバイスに適用する場合、サイト運営者またはパブリッシャーは、これらの機能に使用する識別子としてサイト運営者指定の識別子(PPID)を送信できます。詳細 ppid=12JD92JD8078S8J29SDOAKC0EF230337
ciu_szs

コンパニオン広告サイズのカンマ区切りリスト。

コンパニオン広告は、DAI との組み合わせで、HTML5 SDK を使用する場合にのみサポートされます。

ciu_szs=728x90,300x250
mpt

パートナー プレーヤーの名前。主に SDK が組み込まれている JWPlayer、Brightcove、Ooyala などのパートナーで使用されます。

mpt=JWPlayer
mpv

パートナー プレーヤーのバージョン。mpt が設定されている場合にのみ設定し、SDK が組み込まれているパートナー プレーヤーのバージョンを表します。

mpv=2.1
ptpl 広告ブレーク テンプレート ID。

この ID は、アド マネージャーの管理画面のブレーク テンプレートの設定に表示される、アド マネージャーの URL で確認できます。break_template_id パラメータの値が ID です。

ptpl=1234
ptpln 広告ブレーク テンプレートの名前。アド マネージャーでの表示名ではなく、[名前] フィールドに該当します。

 

ptpln=my_break_template
npa 広告リクエストのカスタマイズ設定。URL の末尾が省略される場合もあるため、このパラメータはタグの前の方に指定することをおすすめします。

ここでは npa=1 を指定して、広告リクエストをパーソナライズされていない広告としてマークします。パラメータを指定しないと、デフォルトでパーソナライズド広告に設定されます。

npa=1
rdid
idtype
is_lat
(通常のウェブやモバイルウェブではなく)ネイティブ アプリケーションの場合は、SDK によって、ユーザー ターゲティング用のリセット可能なデバイス識別子rdididtypeis_lat のパラメータとともにストリーム リクエストに渡されます。SSB ストリームでは、クライアントサイドの動画ソリューション広告リクエストの場合と同様に、これらのパラメータを明示的に渡す必要があります。

iOS 14 以降、Apple では LAT シグナルがサポートされなくなったため、デフォルトでオプトアウトすることはできません。

サイト運営者(パブリッシャー)が確認済みの場合、Google では代わりにゼロ以外の IDFA の有無に基づいて、トラッキングが無効化されていないかどうかを判断します。そのため、適切な OS バージョンを示す有効な UserAgent が必要です。

リセット可能なデバイス識別子の詳細な例をご確認ください。
session_update_url ストリームの再生中にユーザーのターゲティング データを更新するための URL。ストリーム全体を再度リクエストする必要はありません。

これは、再生時間が不明なライブスポーツ イベントや、ユーザーの現在地が変わる可能性のあるモバイル デバイスで役立ちます。

session_update_url=https://example.com
vconp MRC の動画測定ガイドラインで推奨

テレビ放送のように、プレーヤーでコンテンツ動画を連続再生するかどうかを示します。

連続再生をオンにする場合は「2」、オフにする場合は「1」の値を指定します。

不明な場合はこのパラメータを未設定のままにします。

連続再生オン:
vconp=2
 

連続再生オフ:
vconp=1

vpa MRC の動画測定ガイドラインで推奨

広告を自動再生するか、クリックで再生するかを示します。

ページでユーザーの操作を待機する場合は「click」、動画を自動再生する場合は「auto」の値を指定します。

不明な場合はこのパラメータを未設定のままにします。

自動再生:
vpa=auto
 

クリックして再生:
vpa=click

vpmute MRC の動画測定ガイドラインで推奨

動画プレーヤーがミュートされているときに広告を再生するかどうかを示します。

ミュート中に再生する場合は「1」、ミュート解除中に再生する場合は「0」の値を指定します。

不明な場合はこのパラメータを未設定のままにします。

ミュート中に再生:
vpmute=1
 

ミュート解除中に再生:
vpmute=0

IMA SDK を使ってデフォルトの広告タグをオーバーライドする

動画プレーヤーから IMA SDK を使って DAI ストリームをリクエストする際は、adTagParameters フィールドを使用できます。このフィールドは、Key-Value ペアを使って辞書のような構造で指定します。キーには、上記の表にあるアド マネージャー広告タグのパラメータを使用できます。

同じ構造を使って、ストリームをカスタマイズし、アド マネージャー広告リクエストに関連しないパラメータを渡すことができます。特定のストリーム バリエーションをリクエストする方法と、広告なしの時間枠を設定する方法

adTagParameters フィールドの実装方法は、プログラミング言語やプラットフォームによって多少異なります。iOSAndroidtvOSChromecastHTML5 のデベロッパー向けドキュメントや、DAI プレーヤーとアプリ開発ガイドで紹介しているドキュメントをご覧ください。

 

SDK を使って adTagParameters を設定する

iOStvOSAndroid のアプリで、SDK を使って cust_paramsdescription_url を設定する場合は、文字列を URL エンコードしないでください。cust_params は、Key-Value ペアを「&」で連結した 1 つの文字列として渡すことができます。

たとえば、cust_params を「sport=football&city=newyork」という値に設定するとします。

エンコードなしの値を使った adTagParams の構造は次のようになります。

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport=football&city=newyork",
  "description_url": "http://www.sample.com/golf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}

 

エンコードした値を使った adTagParameters の構造は次のようになります(HTML5 ストリームのリクエストの場合)。

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport%3Dfootball%26city%3Dnewyork",
  "description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}

 

エンコードした値を使った adTagParams の構造は次のようになります(Roku ストリームのリクエストの場合)。

request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"

DAI API を使ってデフォルトの広告タグをオーバーライドする (ベータ版) 

動画プレーヤーから DAI API を使って DAI ストリームをリクエストする際は、Key-Value ペアを渡すことができます。キーには、上記の表にあるアド マネージャー広告タグのパラメータを使用できます。

これらのパラメータは、HTTP POST リクエストの本文の一部として送信します。フォームの形式は、リニア(ライブ)VOD の両方で application/x‑www‑form‑urlencoded となります。

同じ構造を使って、ストリームをカスタマイズし、アド マネージャー広告リクエストに関連しないパラメータを渡すことができます。特定のストリームのバリエーション パラメータHMAC 認証をリクエストする方法をご確認ください。

DAI API の実装例をご確認ください。

SSB を使ってデフォルトの広告タグをオーバーライドする

SSB のデフォルトの VOD 広告タグを変更する場合の例を以下に示します。プレーヤーまたはアプリから渡されるオーバーライドのパラメータはハイライト表示されています。

ビデオ オンデマンドの例

 
基本の VOD ストリーム URL http://dai.google.com/ondemand/hls/content/
<contentid>/vid/<vid>/master.m3u8
  (広告ユニットを指定) http://dai.google.com/ondemand/hls/content/
<contentid>/vid/<vid>/master.m3u8?iu=/9876/
path/to/adunit
  (オーバーライドする
Key-Value を指定)
http://dai.google.com/ondemand/hls/content/<contentid>/vid/
<vid>/master.m3u8?cust_params=sport%3Dfootball%26section
%3Dblog%26anotherKey%3Dvalue1%2Cvalue2
  (子供向けコンテンツの
宣言を指定)
http://dai.google.com/ondemand/hls/content/<contentid>/vid/
<vid>/master.m3u8?tfcd=1 
  (オーバーライドする広告ユニット、Key-Value、
カスタム description_url
子供向けコンテンツの宣言を指定)
http://dai.google.com/ondemand/hls/content/<contentid>/vid/
<vid>/master.m3u8?iu=/9876/path/to/adunit
&cust_params=sport%3Dfootball%26section
%3Dblog%26anotherKey%3Dvalue1%2Cvalue2
&description_url=https://mysite.com/description.html
&tfcd=1
 

ライブリニア ストリームの例

 
基本のライブリニア ストリーム URL https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8
  (広告ユニットを指定) https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8
?iu=/9876/path/to/adunit
  (オーバーライドする Key-Value を指定) https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8
?cust_params=sport%3Dfootball%26section
%3Dblog%26anotherKey%3Dvalue1%2Cvalue2
  (子供向けコンテンツの
宣言を指定)
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8
?tfcd=1
  (オーバーライドする広告ユニット、Key-Value、
カスタム description_url
子供向けコンテンツの宣言を指定)
https://dai.google.com/linear/hls/event/<asset_key>/master.m3u8
?iu=/9876/path/to/adunit
&cust_params=sport%3Dfootball%26section
%3Dblog%26anotherKey%3Dvalue1%2Cvalue2
&description_url=https://mysite.com/description.html
&tfcd=1

特定のライブ ストリーム中にターゲティング パラメータを動的に更新する

IMA DAI SDK の replaceAdTagParameters メソッドを使用して、ストリームの再生中に特定のユーザーのターゲティング データを動的に更新できます。

この情報は役に立ちましたか?
改善できる点がありましたらお聞かせください。