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

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

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

オーバーライドが可能なアド マネージャー広告タグのパラメータ

特定のパラメータに移動:

addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent givn|paln idtype is_lat iu

iu is_lat ltd mpt mpv npa omid_p ppid ptpl ptpln rdid rdid

rdp sdk_apis sid sz tfcd trt vconp vpa vpmute wta

 

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

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

IMA SDK または SSB を使用して、デフォルトの広告タグをオーバーライドする方法をご確認ください。

パラメータ	説明	値の例
iu	現在の広告ユニットです。 形式は次のとおりです。 /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	アド マネージャー キャンペーンのターゲティングで使用する Key-Value ペア。一部のプラットフォームでは URL エンコーディングが必要です。 IMA DAI SDK for HTML5 を使用する場合、値は自動的にエンコードされるため、URL エンコードの要件は適用されません。このパラメータは、すでに HTML5 でエンコードされている場合、機能しません。	複数の Key-Value ペアの例: section=sports  page=golf,tennis   SSB ストリーム: cust_params 値全体をエンコードして連結しますが、さらにエンコードすることはありません。 cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast: 値のみをエンコードします。 streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku: cust_params 値全体をエンコードして連結しますが、さらにエンコードすることはありません。 request.adTagParameters =   "cust_params=   section%3Dsports   %26page%3Dgolf%2Ctennis"   iOS、tvOS: エンコードはしません。 request.adTagParameters = @{   @"cust_params" :   @"section=sports&   multi=golf,tennis"};   Android: エンコードはしません。 Map<String, String> adTagParams =   new HashMap<>();   adTagParams.put(   "cust_params",   "ge=0&gr=2");
sz	デフォルトの広告タグの sz パラメータをオーバーライドします。これにより、デバイスに合わせて動的にサイズを設定できます。 サイズの末尾に「v」を付けないでください。	sz=400x300
tfcd	リクエストに子供向け取り扱いのタグを設定します。 DAI リクエストに tfcd=1 が含まれる場合、rdid、idtype、is_lat パラメータに割り当てられた値はすべて、COPPA を遵守するため削除されます。	tfcd=1
description_url	ページで再生される動画について説明しているページの URL。通常は動画プレーヤーが置かれているページの URL になりますが、動画の説明を別途記載したページを指定することもできます。 SSB ストリームで使用する場合と IMA DAI SDK for Roku を使用する場合は、常に description_url を URL エンコードする必要があります。IMA 5 SDK for HTML5 を使用する場合、値は自動的にエンコードされるため、この要件は適用されません。このパラメータは、すでに HTML5 でエンコードされている場合、機能しません。 このパラメータは IMA SDK で自動的に設定されないため、手動で設定する必要があります。 このフィールドは、Ad Exchange を使用している場合は必須になります。詳細	URL エンコードした値の例: description_url= http%3A%2F%2Fwww.sample.com %2Fgolf.html エンコードなしの値の例: description_url= http://www.sample.com/ golf.html
ppid	フリークエンシー キャップ、オーディエンス セグメンテーションとターゲティング、広告の順次ローテーション、オーディエンスに基づくその他の広告配信設定を複数のデバイスに適用する場合、パブリッシャーは、これらの機能に使用する識別子としてパブリッシャー指定の識別子（PPID）を送信できます。詳細	ppid= 12JD92J...
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
an	an パラメータはアプリ名を表します。 ほとんどのプログラマティック動画広告で必要となるため、モバイルアプリとコネクテッド テレビ デバイスから送信されるリクエストに適用する必要があります。* IMA SDK では自動的に入力されますが、DAI API と SSB（SDK 以外の環境）では手動で指定する必要があります。 * iOS と tvOS ではアプリ名を人間が読める形式にする必要がある一方、SDK では 9 桁の App Store ID にアクセスできません。この場合、SDK では an パラメータ（com.package.publisher 形式）経由でアプリバンドルが送信されます。	an=sample%20app
ltd	Cookie や他のローカル ID の使用についてユーザーの同意がない場合に、制限された方法で広告を配信するかどうかを示します。詳細	ltd=1
rdid idtype is_lat	（通常のウェブやモバイルウェブではなく）ネイティブ アプリケーションの場合は、SDK によって、ユーザー ターゲティング用のリセット可能なデバイス識別子が rdid、idtype、is_lat のパラメータとともにストリーム リクエストに渡されます。SSB ストリームでは、クライアントサイドの動画ソリューション広告リクエストの場合と同様に、これらのパラメータを明示的に渡す必要があります。 iOS 14.5 以降、Apple は LAT シグナルのサポートを終了しました。Google は代わりにゼロ以外の IDFA の有無に基づいて、App Tracking Transparency をサポートしているバージョンの iOS でのトラッキングにユーザーが同意したことを示します。そのため、正確な OS バージョンを示す有効な UserAgent が必要です。	リセット可能なデバイス識別子の詳細な例をご確認ください。
trt	購入したトラフィックまたはそれ以外のトラフィックを指定します。	未定義のトラフィック タイプ: trt=0 購入したトラフィック: trt=1 自然検索トラフィック: trt=2
vconp	Recommended per MRC の動画測定ガイドラインで推奨 テレビ放送のように、プレーヤーでコンテンツ動画を連続再生するかどうかを示します。 連続再生をオンにする場合は「2」、オフにする場合は「1」の値を指定します。 不明な場合はこのパラメータを未設定のままにします。	連続再生オン: vconp=2   連続再生オフ: vconp=1
vpa	Recommended per MRC の動画測定ガイドラインで推奨 広告を自動再生するか、クリックで再生するかを示します。 ページでユーザーの操作を待機する場合は「click」、動画を自動再生する場合は「auto」の値を指定します。 不明な場合はこのパラメータを未設定のままにします。	自動再生: vpa=auto   クリックして再生: vpa=click
vpmute	Recommended per MRC の動画測定ガイドラインで推奨 動画プレーヤーがミュートされているときに広告を再生するかどうかを示します。 ミュート中に再生する場合は「1」、ミュート解除中に再生する場合は「0」の値を指定します。 不明な場合はこのパラメータを未設定のままにします。	ミュート中に再生: vpmute=1   ミュート解除中に再生: vpmute=0
npa	広告リクエストのカスタマイズ設定。URL の末尾が省略される場合もあるため、このパラメータはタグの前の方に指定することをおすすめします。 ここでは npa=1 を指定して、広告リクエストをパーソナライズされていない広告としてマークします。パラメータを指定しないと、デフォルトでパーソナライズド広告に設定されます。	npa=1
omid_p	OMID パートナー名パラメータには、OMID 測定を統合するパートナーの名前とパートナー バージョンを示す変数値を設定します。 このパラメータは、Open Measurement SDK（OM SDK）の使用時にアクティブ ビューの測定を必要とするパブリッシャーにのみ適用されます。IMA SDK を使用するときは自動的に設定されるため、使用しないでください。 Programmatic Access Library（PAL）の使用時に OMID のサポートを指定するには、omidPartnerName API と omidPartnerVersion API を使用してパートナーの名前とバージョンを設定する必要があります。PAL と IMA を使用しない場合は、omid_p パラメータと sdk_apis パラメータを設定する必要があります（サポートされている API。他のカンマ区切り API を含む場合があります）。	PAL を使用する場合: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' PAL を使用しない場合: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
gdpr gdpr_consent	双方向の Cookie 同期リクエストで TCF v2.0 同意情報を渡すために使用されます。	GDPR の仕様をご覧ください。
givn|paln	Programmatic Access Library（PAL）を使用する統合の場合、video nonce パラメータには変数の文字列値を指定できます。 ノンスは URL セーフです。URL エンコードする必要はありません。 注: 以前に従来の paln パラメータを使用してノンスを指定していた場合は、givn パラメータに移行して paln の送信を停止することを強くおすすめします。両方のパラメータを含めないでください。	このパラメータに渡される値の詳細については、PAL のスタートガイドをご覧ください。
addtl_consent	IAB に登録されていない同意済みの Google の広告技術プロバイダのリスト。	追加同意の仕様をご覧ください。
rdp	データ処理を制限するには、rdp=1 と明示的に指定するか、rdp（設定値なし）と指定します。このパラメータが見つからないか、rdp=0 に設定されている広告リクエストは、制限付きデータ処理のネットワーク設定が有効になっていない限り制限されません。	rdp=1
sdk_apis	この SDK API フレームワークのパラメータには、プレーヤーが対応しているすべての API フレームワークを示す定数の整数値からなるカンマ区切りのリストを設定します。 API フレームワークの値のリストをご確認ください。 このパラメータは、Programmatic Access Library（PAL）を使用するパブリッシャーが使用します。IMA SDK を使用しているときにこのパラメータに値を設定しようとすると、IMA SDK でサポートされている値でオーバーライドされます。	sdk_apis=2,7,9
sid	フリークエンシー キャップの目的でのみ使用できる、プライバシーに配慮した広告 ID です。IAB の IFA ガイドラインで規定されているとおり、このパラメータは UUID 形式で指定する必要があります。詳細 セッション ID を渡さないようにするには、sid=0 を設定します。	sid=123e4567-e89b-12d3 -a456-426614174000
wta	動画プレーヤーが「広告の表示について」の表示をサポートしているかどうかを示します。 IMA SDK を使用している場合は、自動的にサポートされます。IMA SDK を使用していない場合は、DAI API ガイドに沿って、動画プレーヤーに VAST の Icon と IconClickFallbackImage のサポートを実装する必要があります。* SSB では WTA はサポートされていません。 このフィールドは、Ad Exchange を使用している場合は必須です。詳細 * IconClickFallbackImage のサポートは必須ではありません（コネクテッド テレビ デバイスを除く）。	サポートしている場合: wta=1 サポートしていない場合: wta=0

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

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

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

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

 

SDK を使って adTagParameters を設定する

iOS、tvOS、Android のアプリで、SDK を使って cust_params や description_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%3Dgolf%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%3Dgolf%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%3Dgolf%26section %3Dblog%26otherKey%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%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

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

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

DAI のトラブルシューティングやサービス停止に関連する問題については、パブリッシャー サポートにお問い合わせください。