この記事では、VAST 広告タグで使用できるパラメータのリストを示します。特定のパラメータについて詳しく知りたい場合に役立ちます。
このページの内容
実装タイプ別のパラメータ リスト
特定の実装を使用している場合は、その実装の用途と要件を規定したカスタム パラメータ リストを使用できます。実装タイプ別のカスタム パラメータ リストをご覧ください。
ウェブ モバイルアプリ コネクテッド テレビ オーディオ デジタル屋外広告
すべてのパラメータ
広告配信の必須パラメータ
通常、これらのパラメータは、ほとんどの実装で広告配信に必須です。ただし、必須ではない場合があります。最も正確なリストについては、特定の実装タイプのパラメータ リストを使用してください。
説明
「相関値」パラメータ(correlator
)には、同じページビューからの複数のリクエストに共有される変数値を設定します。競合相手の除外を実装するときに使用します。これには Cookie のない環境での実装も含まれます。
使用例
correlator=4345645667
要件と推奨事項
ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告で広告配信を実装する場合、このパラメータは必須です。
SDK の使用
- IMA SDK を使用している場合、correlator 値は自動的に設定されます。プレーヤーによってこの値が設定されたとしても、IMA SDK によって独自の値で上書きされます。
- IMA SDK を使用していない場合は、複数のページビューで再利用されない、真にランダムな正の整数値を設定するようにしてください。
説明
「説明の URL」パラメータ(description_url
)には、ページで再生される動画の説明となる変数値を設定します。
説明の URL は、ウェブアプリ、モバイルアプリ、テレビアプリの特定のページで再生される動画に関するものである必要があります。すべての動画またはすべての広告リクエストのトップレベル ドメインを指定することはできません。たとえば、https://www.sample.com/golf.html
ページでゴルフ関連の動画を表示している場合、そのページを description_url
の値として設定します。
使用例
description_url
値は、動画を含むウェブページとコネクテッド テレビ / OTT デバイスの場合は URL エンコードする必要があります。ただし、モバイルアプリの場合は description_url
値をエンコードしないでください。
URL エンコード:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
エンコードなし:
description_url=
https://www.sample.com/golf.html
要件と推奨事項
ウェブやモバイルアプリで広告配信を実装する場合、このパラメータは必須です。また、Ad Exchange または AdSense を使用してダイナミック アロケーションを行う場合も必須です。
このパラメータは、プログラマティック収益化を行う場合は推奨されます。
SDK の使用
このパラメータは IMA SDK で自動的に設定されないため、手動で設定する必要があります。
プラットフォームの IMA SDK ガイドをご覧ください。
説明
「環境」パラメータ(env
)には、インストリーム リクエスト、または特に動画プレーヤーからのリクエストであることを示す定数値を設定します。
有効な値は、動画広告とオーディオ広告に使用できる instream
、または動画広告にのみ使用できる vp
です。
使用例
動画、オーディオ、またはその両方:
env=instream
動画のみ:
env=vp
説明
出力形式パラメータ(output
)には、広告の出力形式を示す定数値を指定します。
使用例
ネットワークのデフォルトの VAST バージョンを使用する:
output=vast
VAST 4 を使用する(特定のタグに特定のバージョンを設定できます):
output=xml_vast4
ネットワークのデフォルトの VMAP 設定を使用する:
output=vmap
VMAP 1 を使用する:
output=xml_vmap1
VMAP 1 を使用して VAST 4 を返す(VMAP 内部で VAST を返す場合):
output=xml_vmap1_vast4
要件と推奨事項
ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告で広告配信を実装する場合、このパラメータは必須です。正しい広告配信レスポンス形式を出力する必要があります。
SDK の使用
VAST については、動画プレーヤーで IMA SDK を使用している場合、動画広告リクエストの output パラメータは常に output=xml_vast4
に設定されます。IMA SDK は第三者広告サーバーが配信するすべての VAST バージョンと下位互換性があるため、信頼性に関する問題が発生することはありません。
説明
URL(url
)パラメータには、リクエスト送信元の完全な URL を示す変数値を設定します。この値は、リクエストがどこから送信されているかを購入者が把握するために必要となります。可能な限り、この値は広告リクエストに動的に含めるようにしてください。
- ウェブの場合は、動画プレーヤーを表示しているページの URL を指定します。
- ウェブ以外の環境の場合は、収益化する動画またはオーディオ広告枠を最も正確に表す URL を指定する必要があります。たとえば、ユーザーがモバイルアプリで視聴している動画をデスクトップでも視聴できる場合は、その動画の URL を指定します*。
注: url
は広告リクエストが行われた場所を指すのに対し、description_url
は動画の内容を説明しているウェブクロール可能なページを指すという点で、url
と description_url
は異なります。
このパラメータの値はエンコードする必要があります。
使用例
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* アプリ環境でこのパラメータに変数の URL 値を設定できない場合は、次の形式を使用することをおすすめします。url=https%3A%2F%2F<app/bundleid>.example.com
要件と推奨事項
ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告で広告配信を実装する場合、このパラメータは必須です。
SDK の使用
IMA SDK を使用している場合は、URL 値が自動的に設定されます。プレーヤーで値が設定された場合、IMA SDK では設定された値が優先されます。
説明
ミュート時の動画再生(vpmute
)パラメータには、動画プレーヤーがミュートされているときに広告の再生を開始するかどうかを示す定数値を設定します。このパラメータは動画プレーヤーの状態を変更するものではなく、再生処理は動画プレーヤーで直接行う必要があります。
使用例
ミュートされているときに再生する場合:
vpmute=1
ミュートが解除されているときに再生する場合:
vpmute=0
要件と推奨事項
ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でプログラマティックな収益化を行う場合、このパラメータは必須です。
このパラメータは、Media Rating Council(MRC)の動画測定ガイドラインでも推奨されています。
プログラマティックの必須パラメータ
説明
OTT プレースメント パラメータ(ott_placement
)には、インストリーム以外の OTT プレースメントのリクエストを示す定数値を設定します。
下の例のプレースメントの定義:
- 一時停止: ユーザーがコンテンツの再生を一時停止したときに、動画コンテンツの上にオーバーレイで表示されるアウトストリーム フォーマット。
- ホーム画面: コネクテッド テレビ デバイスまたは OTT アプリのホーム画面に表示される広告。ホーム画面上のマストヘッド、バナー、タイルの実装などがあります。
- ピクチャー イン ピクチャー: 動画コンテンツの横にある別の広告動画プレーヤーで再生されるインストリーム動画広告。通常、動画コンテンツを縮小して 2 つ目の動画プレーヤーを読み込む必要があります。
- L バナー: 動画コンテンツを縮小して、動画の周囲に広告を配置するインストリーム ディスプレイ広告。通常は L 字型の広告コンテンツ ボックスですが、これに限定されません。
- オーバーレイ: 動画コンテンツの上に表示され、全画面を占有しないインストリーム広告フォーマット。ディスプレイ広告または動画広告のいずれかです。
使用例
サポートされている形式とそれに対応する値は次のとおりです。
一時停止:
ott_placement=1
ホーム画面:
ott_placement=2
ピクチャー イン ピクチャー:
ott_placement=3
L バナー:
ott_placement=4
オーバーレイ:
ott_placement=5
カスタム / その他:
ott_placement=99
要件と推奨事項
このパラメータは、OTT ストリーミング環境で標準以外のプレースメントを収益化しているパブリッシャーが、ウェブ、モバイルアプリ、コネクテッド テレビでプログラマティックな収益化を行う場合にのみ必須です。
説明
施設タイプ(venuetype
)パラメータは、屋外の施設タイプを示すために使用されます。値には、IAB OpenOOH 施設タイプの 1.1 の分類でサポートされている整数列挙の ID を使用できます。
使用例
ホテルの客室の場合:
venuetype=80703
タクシーの後部座席にあるタブレットの場合:
venuetype=103
説明
動画の自動再生(vpa
)パラメータには、広告の動画コンテンツを自動再生で開始するか、クリックで開始するかを示す定数値を設定します。
ページでユーザーの操作を待機する場合は click
、動画を自動再生する場合は auto
の値を指定します。このパラメータは動画プレーヤーの状態を変更するものではなく、再生処理は動画プレーヤーで直接行う必要があります。
使用例
自動再生の場合:
vpa=auto
クリックで再生する場合:
vpa=click
不明な場合はこのパラメータを未設定のままにします。
要件と推奨事項
ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオでプログラマティックな収益化を行う場合、このパラメータは必須です。
このパラメータは、Media Rating Council(MRC)の動画測定ガイドラインでも推奨されています。
プログラマティックの推奨パラメータ
説明
「音声の連続再生」パラメータ(aconp
)には、プレーヤーがオーディオ コンテンツを連続再生するかどうかを示す定数値を指定します。これにより、Google アド マネージャーでユーザー エクスペリエンスに最適な広告が選択されます。
使用例
連続再生オン:
aconp=2
連続再生オフ:
aconp=1
音声が連続再生されるかどうかわからない場合は、このパラメータを未設定のままにするか、aconp=0
に設定します。
要件と推奨事項
このパラメータが広告配信に必須となる実装タイプはありませんが、ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でプログラマティック収益化を行う場合は推奨されます。
このパラメータは、Media Rating Council(MRC)の音声測定ガイドラインでも推奨されています。
説明
アプリ ID パラメータ(msid
)とアプリ名パラメータ(an
)には、変数値を指定します。ほとんどのプログラマティック動画広告で必須のため、モバイルアプリとコネクテッド テレビ デバイスから送信するリクエストには、これらのパラメータを適用する必要があります。
iOS と tvOS ではアプリ名を人間が読める形式にする必要がある一方、IMA SDK はアプリ ID にアクセスできません。この場合、IMA SDK から msid
パラメータは送信されず、アプリバンドルが an
パラメータ経由で送信されます。
使用例
msid=com.package.publisher&an=sample%20app
アプリ ID の名前と形式は、アプリストアによって異なります。アプリの識別に関する IAB ガイドラインまたは一般的な一意の識別子の例をご覧ください。
アプリストアが存在しないプラットフォームの場合、IAB はストア ID として com.publisher.deviceplatform
の形式を使用することを推奨しています。
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプはありませんが、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でのプログラマティック収益化には推奨されます。
ブランド保護と購入者への透明性の確保のため、アプリ情報の提供を強くおすすめします。
SDK の使用
IMA SDK を使用する場合はこれらのパラメータが自動的に入力されますが、非 SDK 環境(VAST を直接呼び出す場合など)や、Programmatic Access Library(PAL)またはパブリッシャー認証済み広告枠(PAI)を使用する場合は手動で指定する必要があります。
注: HTML5 IMA SDK を使用している場合、アプリ情報は使用されません。
説明
「デバイスタイプのヒント」パラメータ(dth
)には、特にコネクテッド テレビやセットトップ ボックス環境でデバイスの分類ミスを減らすのに役立つ定数値を設定します。
デバイスの分類ミスは、パブリッシャーまたはコネクテッド テレビの OEM 側での意図しないエラーが原因で発生することがあります。このパラメータは、コネクテッド テレビの広告枠が再分類される可能性のあるインスタンスを Google が自動的に報告できるように、他のシグナルと組み合わせて使用されます。
使用例
リクエスト元:
- フィーチャー フォン:
dth=1
- スマートフォン:
dth=2
- パソコン:
dth=3
- タブレット:
dth=4
- コネクテッド テレビ:
dth=5
- ゲーム機:
dth=6
- セットトップ ボックス:
dth=7
要件と推奨事項
このパラメータが広告配信に必須となる実装タイプはありませんが、ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でプログラマティック収益化を行う場合は推奨されます。
SDK の使用
このパラメータは、PAL および PAI(SDK 以外)実装で推奨されます。IMA SDK、DAI SDK では必要ありません。
説明
Programmatic Access Library(PAL)を使用する統合の場合、video nonce パラメータには変数の文字列値を指定します。
ノンスは URL セーフです。URL エンコードする必要はありません。
注: 以前に従来の paln
パラメータを使用してノンスを指定していた場合は、givn
パラメータに移行して paln
の送信を停止することを強くおすすめします。両方のパラメータを指定しないでください。
使用例
このパラメータに渡される値の詳細については、PAL のスタートガイドをご覧ください。
説明
「言語」パラメータ(hl
)には、定数値を設定します。特定の言語の広告をリクエストしたり、広告を選択する際や、ダイナミック アロケーションで Ad Exchange または AdSense の動画広告をレンダリングする際の言語を指定したりするために使用します。
使用例
イタリア語の広告をリクエスト:
hl=it
ISO 639-1(2 文字)または ISO 639-2(3 文字)のコードを使用できます。詳しくは、有効なコードのリストをご参照ください。
省略した場合は、Ad Exchange の言語による広告のターゲティングで指定された言語のいずれかがデフォルトで使用されます。
要件と推奨事項
このパラメータが広告配信に必須となる実装タイプはありませんが、ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でプログラマティック収益化を行う場合は推奨されます。
説明
アプリ ID パラメータ(msid
)とアプリ名パラメータ(an
)には、変数値を指定します。ほとんどのプログラマティック動画広告で必須のため、モバイルアプリとコネクテッド テレビ デバイスから送信するリクエストには、これらのパラメータを適用する必要があります。
iOS と tvOS ではアプリ名を人間が読める形式にする必要がある一方、IMA SDK はアプリ ID にアクセスできません。この場合、IMA SDK から msid
パラメータは送信されず、アプリバンドルが an
パラメータ経由で送信されます。
使用例
msid=com.package.publisher&an=sample%20app
アプリ ID の名前と形式は、アプリストアによって異なります。アプリの識別に関する IAB ガイドラインまたは一般的な一意の識別子の例をご覧ください。
アプリストアが存在しないプラットフォームの場合、IAB はストア ID として com.publisher.deviceplatform
の形式を使用することを推奨しています。
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプはありませんが、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でのプログラマティック収益化には推奨されます。
ブランド保護と購入者への透明性の確保のため、アプリ情報の提供を強くおすすめします。
SDK の使用
IMA SDK を使用する場合はこれらのパラメータが自動的に入力されますが、非 SDK 環境(VAST を直接呼び出す場合など)や、Programmatic Access Library(PAL)またはパブリッシャー認証済み広告枠(PAI)を使用する場合は手動で指定する必要があります。
注: HTML5 IMA SDK を使用している場合、アプリ情報は使用されません。
説明
OMID パートナー名パラメータ(omid_p
)には、OMID 測定を統合するパートナーの名前とパートナー バージョンを示す変数値を指定します。
サポートされている SDK API パラメータ(sdk_apis
)には、サポートされている API の単一の値またはカンマ区切りのリストの変数値を指定します。
これらのパラメータは、視認性と広告の検証に使用される一連のパラメータの一部です。
使用例
PAL を使用しない場合:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
API フレームワークの値のリストをご確認ください。
PAL を使用する場合:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプはありませんが、ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告のプログラマティック収益化には推奨されます。
SDK の使用
- このパラメータは、Open Measurement SDK(OM SDK)の使用時にアクティブ ビューの測定を必要とするパブリッシャーにのみ適用されます。
- Programmatic Access Library(PAL)の使用時に OMID のサポートを指定するには、
omidPartnerName
とomidPartnerVersion
を使用してパートナーの名前とバージョンを設定する必要があります。PAL または IMA SDK を使用しない場合は、omid_p
パラメータとsdk_apis
パラメータを設定する必要があります。 - IMA SDK を使用するときは自動的に設定されるため、使用しないでください。
説明
リセット可能なデバイス識別子(rdid
、idtype
、is_lat
)パラメータには、変数値を設定します。この値は広告識別子(IFA)とも呼ばれます。
Android または iOS 向け IMA SDK を使用しているモバイルアプリでは、IMA SDK によって、ユーザー ターゲティングに使用できるリセット可能なデバイス識別子が rdid
、idtype
、is_lat
のパラメータとともにストリーム リクエストに渡されます。
IMA SDK を使用していない場合、またはサーバーサイド ビーコン処理(SSB)を使用している場合は、これらのパラメータを明示的に渡す必要があります。詳しくは、デバイス識別子に関する説明をご覧ください。
これらの値は、ほぼすべてのプログラマティック動画広告の配信で必要となります。
iOS 14.5 以降、Apple は |
使用例
リセット可能なデバイス識別子の詳細な例をご確認ください。
要件と推奨事項
これらのパラメータが広告の配信に必要となる実装タイプはありませんが、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でプログラマティックな収益化を行う場合は必須です。
ウェブの実装環境では、リセット可能なデバイス識別子は使用されません。
SDK の使用
IMA SDK ではこのフィールドは自動的に渡されますが、PAL SDK を使用している場合は手動でこれらのパラメータを渡します。
説明
セッション ID(sid
)パラメータには、フリークエンシー キャップにのみ使用できる、プライバシーに配慮した広告 ID の変数値を設定します。
セッション ID は、コネクテッド テレビのインストリーム動画リクエストと、モバイルアプリ デバイスのインストリーム動画広告枠でサポートされています。現在のところ、ウェブではサポートされていません。
セッション ID を渡さないようにするには、sid=0
を設定します。
使用例
sid=123e4567-e89b-12d3-a456-426614174000
IAB の IFA ガイドラインで規定されているとおり、このパラメータは UUID 形式で指定する必要があります。詳しくは、ユーザー ターゲティングで使用できるリセット可能なデバイス識別子についての説明をご覧ください。
要件と推奨事項
このパラメータが広告の配信に必要となる実装タイプはありませんが、デジタル屋外広告でプログラマティックな収益化を行う場合は必須です。
モバイルアプリ、コネクテッド テレビ、オーディオでプログラマティックな収益化を行う場合、このパラメータは推奨されます。
SDK の使用
このパラメータは IMA SDK によって自動的に送信されます。
説明
動画の連続再生(vconp
)パラメータには、プレーヤーが動画コンテンツを(テレビ放送のように)連続再生するかどうかを示す定数値を設定します。
使用例
連続再生をオンにする場合:
vconp=2
連続再生をオフにする場合:
vconp=1
不明な場合はこのパラメータを未設定のままにします。
要件と推奨事項
このパラメータが広告の配信に必要となる実装タイプはありませんが、ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオでプログラマティックな収益化を行う場合は推奨されます。
このパラメータは、Media Rating Council(MRC)の動画測定ガイドラインでも推奨されています。
説明
動画再生時間(vid_d
)パラメータには、コンテンツの再生時間を秒単位で示す変数値を設定します。
vid_d
とallcues
のパラメータは、コンテンツの取り込みを行わずにミッドロール広告を配信する場合に使用します。- ミッドロールを返すには、広告ルールを使用する必要があります。広告ルールで時間ベースのキューを使用している場合(「等間隔(秒数)」や「固定秒数」など)は、広告ルールで設定したキューが使用され、
allcues
に渡されるキューは無視されます。この場合も、ミッドロールでは再生時間が必要なため、vid_d
を渡す必要があります。
使用例
動画コンテンツの再生時間が 90,000 秒(25 時間)の場合:
vid_d=90000
説明
「広告の表示について」(wta
)パラメータには、動画プレーヤーが広告のバッジのレンダリングをサポートしているかどうかを示す定数値を設定します。
使用例
VAST レスポンスで指定された AdChoices アイコンをプレーヤーで表示する場合は、次の値を使用します。
wta=1
(またはwta
パラメータを省略する、あるいは値を設定せずにwta
を渡す)VAST レスポンスで指定された AdChoices アイコンをコンパニオンに表示するか、別の方法でユーザーに表示する場合は、オーディオ広告リクエストで
wta=1
を使用します。
VAST レスポンスで指定された AdChoices アイコンをプレーヤーで表示しない場合は、次の値を使用します。
wta=0
要件と推奨事項
このパラメータが広告の配信に必要となる実装タイプはありませんが、ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオでプログラマティックな収益化を行う場合は推奨されます。
このパラメータを使用した場合:
&wta=0
と指定されたトラフィックに対して、Google デマンドの特定の種類のパーソナライズは行われません。&wta=0
と指定された EEA からのトラフィックに対して、純広告とパブリッシャー管理のプログラマティック保証型広告申込情報で広告バッジが有効になっているクリエイティブは配信されません。
広告は、欧州経済領域(EEA)で配信される広告に適用される規制要件を遵守する必要があります。これには、ユーザーが違法なコンテンツを報告するためのメカニズムを提供することも含まれます。違法なコンテンツの報告があった場合は、「Google 上のコンテンツを報告」フォームを使用して Google に通知する必要があります。
SDK の使用
広告バッジ機能は、IMA SDK を使用している場合は自動的にサポートされます。IMA SDK を使用していない場合は、IAB VAST 規格ドキュメントに沿って動画プレーヤーに VAST のIcon
と IconClickFallbackImage
のサポートを実装する必要があります。その他のパラメータ
一般に、これらのパラメータは広告配信に明示的に必要となるものではありませんが、特定の機能を使用する場合や、特定の実装タイプでは必要となる場合があります。
説明
「広告ルール」パラメータ(ad_rule
)には、VAST クリエイティブと広告ルールのレスポンスのどちらを返すかを示す定数値を設定します。
広告ルールのデフォルト設定は、Google アド マネージャー ネットワーク設定ですべてのリクエストを広告ルールのリクエストとして有効にしているかどうかによって異なります。このネットワーク設定を使用している場合は、広告タグで ad_rule
を設定する必要はありません。広告リクエストごとに無効にする場合は、ad_rule=0
を渡してネットワーク設定をオーバーライドできます。また、デフォルトで広告ルールをオンにしていない場合は、ad_rule=1
または ad_rule=0
を渡すことで、それぞれ有効または無効にできます。
使用例
広告ルールの設定が無効になっている場合:
- VAST クリエイティブのリクエスト:
ad_rule=0
または設定しない
広告ルールの設定が有効になっている場合:
- VAST クリエイティブのリクエスト:
ad_rule=0
- 広告ルール(VMAP)のリクエスト:
ad_rule=1
または設定しない
広告ルールを使用しないように設定した場合は、広告タグパラメータ(pmnd
、pmxd
、pmad
)を使用して、VAST タグの広告ブレークと連続配信広告の再生時間を指定できます。
要件と推奨事項
このパラメータが広告配信に必須となる実装タイプはありませんが、動画広告ルールを正しく使用するためには必要です。
説明
「追加同意」パラメータ(addtl_consent
)には、変数値を設定します。このパラメータは、IAB TCF v2.0 と統合し、IAB ヨーロッパのグローバル ベンダー リストに未登録であるものの、Google の広告技術プロバイダ(ATP)リストに登録されているベンダーを利用するパブリッシャーが使用します。
このパラメータに渡される値の詳細については、追加同意モードの技術仕様をご覧ください。
使用例
addtl_consent=1~1.35.41.101
説明
バックフィル(非保証型)広告枠のテストに使用されるクエリが無効なトラフィックとして識別されるのを防ぎ、収益に影響が生じないようにするには、「広告テスト」パラメータ(adtest
)を使用する必要があります。
バックフィルをテストする場合は、このパラメータを on
に設定して、テスト中に発生した広告のインプレッションやクリックが記録されないようにします。テスト環境以外で通常どおり請求の対象とするには、off
に設定します。このパラメータを未設定のままにした場合は、デフォルトで off
になります。
注: 直接販売の広告申込情報をテストする場合は、収益に影響を与えないテスト広告申込情報を使用する必要があります。
使用例
オン:
adtest=on
オフ:
adtest=off
説明
「広告タイプ」パラメータ(ad_type
)には、リクエストに対して返される広告タイプを示す定数値を設定します。
ad_type
を audio
または audio_video
に設定した場合、vpmute パラメータを 0
に設定する必要があります。
使用例
オーディオ広告のみを許可:
ad_type=audio
スキップ可能な動画広告とスキップ不可の動画広告の両方を許可:
ad_type=video
オーディオ広告と動画広告の両方を許可:
ad_type=audio_video
audio_video
値を指定すると、両方の形式を競合させることができますが、配信されるのはどちらかの形式のみです。この値は、動画広告再生に対応したオーディオ コンテンツに動画クリエイティブを配信する場合、または本質的に「リスニング可能」にできるコンテンツのインストリーム動画プレーヤーにオーディオ クリエイティブを配信する場合にのみ使用します(スポーツ配信、動画キャスト、ニュースなど)。動画コンテンツ内のオーディオ広告について
スキップ可能な動画広告のみを許可:
ad_type=skippablevideo
スキップ不可の動画広告のみを許可:
ad_type=standardvideo
要件と推奨事項
- アプリに動画コンテンツが含まれている場合は、このパラメータを
video
またはaudio_video
に設定するか、未設定のままにします。 - アプリにオーディオ コンテンツのみが含まれている場合(ラジオアプリや音声アプリなど)は、このパラメータを
audio
に設定する必要があります。未設定のままにすると、オーディオ広告は返されません。
説明
「ノンリニア広告サイズ」パラメータ(afvsz
)には、定数値として、動画広告スロットに表示できるノンリニア広告サイズのカンマ区切りのリストを設定します。
サポートされているサイズ:
200×200
250×250
300×250
336×280
450x50
468×60
480x90
729x90
IMA SDK を使用している場合、このフィールドの値は、指定された nonLinearAdSlotWidth と nonLinearAdSlotHeight において表示可能なすべてのサイズで自動的に上書きされます。
ノンリニア サイズに対応していない場合、パラメータは未設定のままにするか、空白にすることができます。
使用例
すべてのサイズを表示できる場合:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
幅が最大 250 の場合:
afvsz=200x200,250x250
高さが最大 60 の場合:
afvsz=450x50,468x60
幅が最大 100 の場合:
//空白。対応する値なし
要件と推奨事項
このパラメータが広告配信に必須となる実装タイプや取引タイプはありませんが、IMA SDK を使用していない場合のノンリニア動画広告の配信では必須です。
説明
「すべてのキューポイント」パラメータ(allcues
)には、変数値として、キューポイント(ミリ秒単位)のカンマ区切りのリストを設定します。Google アド マネージャーは、各値の位置で広告ブレークを返します。
vid_d
とallcues
のパラメータは、コンテンツの取り込みを行わずにミッドロール広告を配信する場合に使用します。- ミッドロールを返すには、広告ルールも必要となります。広告ルールで時間ベースのキューを使用している場合(「等間隔(秒数)」や「固定秒数」など)は、広告ルールで設定したキューが使用され、
allcues
に渡されるキューは無視されます。この場合も、ミッドロールでは再生時間が必要なため、vid_d
を渡す必要があります。
使用例
キューポイントが 10 秒と 20 秒の位置にある場合:
allcues=10000,20000
説明
「コンテンツ ソース ID」パラメータ(cmsid
)と「動画 ID」パラメータ(vid
)には、変数値を設定します。
動画コンテンツを広告のターゲットにするには、この両方をマスター動画タグに含める必要があります。
cmsid
は、各コンテンツ ソースを識別する固有の番号です。Google アド マネージャーでこの番号を確認するには、[動画]、[コンテンツ ソース]、該当のコンテンツ ソース名の順にクリックします。vid
は、特定の動画を識別する文字列または番号です。この ID はコンテンツをホストする CMS によって割り当てられます。Google アド マネージャーでこの ID を確認するには、[動画]、[コンテンツ]、該当の動画コンテンツの順にクリックします。
使用例
cmsid=[value]&vid=[value]
ビデオ オンデマンド用にダイナミック広告挿入のタグを作成している場合は、正しいコンテンツ ソースと動画 ID を動的に挿入するマクロを使用する必要があります。
例: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
要件と推奨事項
これらのパラメータが広告配信に必須となる実装タイプや取引タイプはありませんが、動画コンテンツ ターゲティングを使用する場合は必須です。
説明
「カスタム Key-Value パラメータ」パラメータ(cust_params
)には、変数値を設定します。この値は、ユーザー属性、ウェブページ上の特定の位置、特定のトピックを扱うページなど、具体的なターゲットを設定できるようにするための Key-Value ペアです。
使用例
Key-Value ペアを追加する方法の例をご確認ください。
説明
「除外カテゴリ」パラメータ(excl_cat
)には、変数値を設定します。これを使用して、広告リクエストに除外ラベルを含む広告申込情報をブロックします。cust_params
パラメータを使用して、除外カテゴリと除外ラベルを設定します。
使用例
除外カテゴリで 2 つの除外ラベル(airline_excl_label
と train_excl_label
)を設定するには、パイプ文字(|
)を使用してラベルを区切ります。
excl_cat=airline_excl_label%7Ctrain_excl_label
次に、URL エンコードを適用し、エンコードされた文字列を cust_params
で使用します。
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
説明
「GDPR」パラメータ(gdpr
)には、定数値を設定します。このパラメータは、IAB TCF v2.0 と統合するパブリッシャーが使用します。VAST の直接呼び出しリクエストでは、値は自動的に読み取られず、広告タグに追加される際に設定されます。
このパラメータの有効な値は 0
と 1
のみです。0
は GDPR が適用されないこと、1
は GDPR が適用されることを意味します。GDPR が適用される場合は、gdpr_consent パラメータを使用して有効な TC 文字列も指定する必要があります。
このパラメータに渡される値の詳細については、フレームワークの実装に関する一般的なガイドラインまたは IAB TCF v2.0 仕様の TC 文字列セクション(英語)をご覧ください。
使用例
GDPR が適用される:
gdpr=1
GDPR が適用されない:
gdpr=0
説明
「GDPR 同意」パラメータ(gdpr_consent
)には、変数値を設定します。このパラメータは、IAB TCF v2.0 と統合するパブリッシャーが使用します。VAST の直接呼び出しリクエストでは、値は自動的に読み取られず、広告タグに追加される際に設定されます。
このパラメータに渡される値の詳細については、フレームワークの実装に関する一般的なガイドラインまたは IAB TCF v2.0 仕様の TC 文字列セクション(英語)をご覧ください。
使用例
gdpr_consent=GDPR_CONSENT_123
説明
「IAB 除外 URL」パラメータ(iabexcl
)には、変数値として、カテゴリのカンマ区切りのリストを設定します。
説明
リセット可能なデバイス識別子(rdid
、idtype
、is_lat
)パラメータには、変数値を設定します。この値は広告識別子(IFA)とも呼ばれます。
Android または iOS 向け IMA SDK を使用しているモバイルアプリでは、IMA SDK によって、ユーザー ターゲティングに使用できるリセット可能なデバイス識別子が rdid
、idtype
、is_lat
のパラメータとともにストリーム リクエストに渡されます。
IMA SDK を使用していない場合、またはサーバーサイド ビーコン処理(SSB)を使用している場合は、これらのパラメータを明示的に渡す必要があります。詳しくは、デバイス識別子に関する説明をご覧ください。
これらの値は、ほぼすべてのプログラマティック動画広告の配信で必要となります。
iOS 14.5 以降、Apple は |
使用例
リセット可能なデバイス識別子の詳細な例をご確認ください。
要件と推奨事項
これらのパラメータが広告の配信に必要となる実装タイプはありませんが、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でプログラマティックな収益化を行う場合は必須です。
ウェブの実装環境では、リセット可能なデバイス識別子は使用されません。
SDK の使用
IMA SDK ではこのフィールドは自動的に渡されますが、PAL SDK を使用している場合は手動でこれらのパラメータを渡します。
説明
「広告枠パートナー ドメイン」パラメータ(ipd
)には、変数値を設定します。この値は、パブリッシャーの app-ads.txt
(または ads.txt
)ファイルで宣言される inventorypartnerdomain
に設定されます。
inventorypartnerdomain
パラメータは IAB 仕様で定義されており、ads.txt / app-ads.txt
の検証目的で広告枠共有パートナーのドメインを指定する場合に使用します。
IPD の宣言は、リクエストの送信元の広告枠を別のパートナー(広告枠共有パートナー)が所有する、広告枠共有のユースケースで特に重要です。
詳しくは、ads.txt / app-ads.txt と広告枠共有パートナーをご覧ください。
使用例
inventorypartnerdomain
は、広告枠を収益化できるパートナーの .txt ファイルを指定する app-ads.txt ファイルに含まれます。ipd
パラメータの値は、app-ads.txt ファイルの inventorypartnerdomain
アイテムのいずれかの値と一致する必要があります。要件と推奨事項
パブリッシャーが所有していない広告枠で収益化を行う場合、このパラメータは必須です。
説明
リセット可能なデバイス識別子(rdid
、idtype
、is_lat
)パラメータには、変数値を設定します。この値は広告識別子(IFA)とも呼ばれます。
Android または iOS 向け IMA SDK を使用しているモバイルアプリでは、IMA SDK によって、ユーザー ターゲティングに使用できるリセット可能なデバイス識別子が rdid
、idtype
、is_lat
のパラメータとともにストリーム リクエストに渡されます。
IMA SDK を使用していない場合、またはサーバーサイド ビーコン処理(SSB)を使用している場合は、これらのパラメータを明示的に渡す必要があります。詳しくは、デバイス識別子に関する説明をご覧ください。
これらの値は、ほぼすべてのプログラマティック動画広告の配信で必要となります。
iOS 14.5 以降、Apple は |
使用例
リセット可能なデバイス識別子の詳細な例をご確認ください。
要件と推奨事項
これらのパラメータが広告の配信に必要となる実装タイプはありませんが、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告でプログラマティックな収益化を行う場合は必須です。
ウェブの実装環境では、リセット可能なデバイス識別子は使用されません。
SDK の使用
IMA SDK ではこのフィールドは自動的に渡されますが、PAL SDK を使用している場合は手動でこれらのパラメータを渡します。
説明
「連続配信広告の最後の位置」パラメータ(lip
)には、ターゲティングまたはレポート用に連続配信広告の最後の位置からのリクエストであることを示す定数値を指定します。
注: このパラメータは最適化された連続配信広告には適用されず、使用した場合は無視されます。
使用例
lip=1
説明
「制限付きの広告」パラメータ(ltd
)には、定数値を指定します。これにより、Cookie などローカルに保存される ID の使用についてユーザーの同意を得ていない場合に、制限された方法で広告を配信するかどうかを示します。
このパラメータは、制限付き広告リクエストを示すために使用します。is_lat
パラメータとは異なります。パーソナライズと、そのような目的での識別子の使用が無効になります。
ltd=1
と設定すると、IMA SDK の動作が変更され、リクエストを ID なしとして扱い、保存できないようにします。使用例
ltd=1
説明
「パーソナライズされていない広告」パラメータ(npa
)には、広告リクエストがパーソナライズされていないものとして扱われることを示す定数値を指定します。
リクエストをパーソナライズされていない広告としてタグ設定する場合、npa=1
と明示的に指定するか、npa
(設定値なし)と指定します。広告リクエストでこのパラメータが見つからないか、npa=0
と指定されている場合は、デフォルトのパーソナライズド広告が返されます。
使用例
非パーソナライズド広告(NPA):
npa=1
要件と推奨事項
このパラメータは、ユーザーがパーソナライズを無効にしている場合にのみ必要です。パブリッシャーは、状態を制御する際に、ユーザーの正確な状態を反映していることを確認する必要があります。
説明
OTT プレースメント パラメータ(ott_placement
)には、インストリーム以外の OTT プレースメントのリクエストを示す定数値を設定します。
下の例のプレースメントの定義:
- 一時停止: ユーザーがコンテンツの再生を一時停止したときに、動画コンテンツの上にオーバーレイで表示されるアウトストリーム フォーマット。
- ホーム画面: コネクテッド テレビ デバイスまたは OTT アプリのホーム画面に表示される広告。ホーム画面上のマストヘッド、バナー、タイルの実装などがあります。
- ピクチャー イン ピクチャー: 動画コンテンツの横にある別の広告動画プレーヤーで再生されるインストリーム動画広告。通常、動画コンテンツを縮小して 2 つ目の動画プレーヤーを読み込む必要があります。
- L バナー: 動画コンテンツを縮小して、動画の周囲に広告を配置するインストリーム ディスプレイ広告。通常は L 字型の広告コンテンツ ボックスですが、これに限定されません。
- オーバーレイ: 動画コンテンツの上に表示され、全画面を占有しないインストリーム広告フォーマット。ディスプレイ広告または動画広告のいずれかです。
使用例
サポートされている形式とそれに対応する値は次のとおりです。
一時停止:
ott_placement=1
ホーム画面:
ott_placement=2
ピクチャー イン ピクチャー:
ott_placement=3
L バナー:
ott_placement=4
オーバーレイ:
ott_placement=5
カスタム / その他:
ott_placement=99
要件と推奨事項
このパラメータは、OTT ストリーミング環境で標準以外のプレースメントを収益化しているパブリッシャーが、ウェブ、モバイルアプリ、コネクテッド テレビでプログラマティックな収益化を行う場合にのみ必須です。
説明
Programmatic Access Library(PAL)を使用する統合の場合、video nonce パラメータには変数の文字列値を指定します。
ノンスは URL セーフです。URL エンコードする必要はありません。
注: 以前に従来の paln
パラメータを使用してノンスを指定していた場合は、givn
パラメータに移行して paln
の送信を停止することを強くおすすめします。両方のパラメータを指定しないでください。
使用例
このパラメータに渡される値の詳細については、PAL のスタートガイドをご覧ください。
説明
「連続配信広告内の広告の最大数」パラメータ(pmad
)には、連続配信広告内の広告の最大数を示す変数値を指定します。
このパラメータは、最適化された連続配信広告内の広告の合計数を制限します。この機能は、拡張版の動画パッケージをご利用のパブリッシャーが利用できます。
VMAP(ad_rule=1
)の場合は使用できません。
使用例
pmad=4
説明
連続配信広告の最小再生時間パラメータ(pmnd
)と連続配信広告の最大再生時間パラメータ(pmxd
)には、変数値を指定します。両方のパラメータを設定し、連続配信広告の再生時間の範囲をミリ秒単位で指定します。
これらのパラメータは、最適化された連続配信広告で複数の広告をリクエストするために使用します。この機能は、拡張版の動画パッケージをご利用の場合に利用できます。広告ルールを使用すると、この情報は Google アド マネージャーによって自動的に追加されます。
VMAP(ad_rule=1
)の場合は使用できません。
使用例
pmnd=0&pmxd=60000
説明
連続配信広告の最小再生時間パラメータ(pmnd
)と連続配信広告の最大再生時間パラメータ(pmxd
)には、変数値を指定します。両方のパラメータを設定し、連続配信広告の再生時間の範囲をミリ秒単位で指定します。
これらのパラメータは、最適化された連続配信広告で複数の広告をリクエストするために使用します。この機能は、拡張版の動画パッケージをご利用の場合に利用できます。広告ルールを使用すると、この情報は Google アド マネージャーによって自動的に追加されます。
VMAP(ad_rule=1
)の場合は使用できません。
使用例
pmnd=0&pmxd=60000
説明
連続配信広告の最大強制視聴時間パラメータ(pmxfwt
)は、連続配信広告内のスキップ不可広告の最大再生時間をミリ秒単位で指定した変数値を受け取ります。
スキップ不可の動画広告とスキップ可能な動画広告を組み合わせた連続配信広告をサポートしていて、ユーザーに対する広告表示時間を制限したい場合は、このパラメータを使用して、ユーザーがスキップ不可の広告を視聴する必要がある最大時間を定義します。
注: 連続配信広告の合計最大再生時間(スキップ可能な広告の終了までの再生時間を含む)の定義では、このパラメータよりも連続配信広告の最大再生時間パラメータ(pmxd
)が優先されます。
使用例
pmxfwt=30000
説明
「連続配信広告の番号」パラメータ(pod
)には、動画内での連続配信広告の順番を表す変数値(たとえば、pod 1、pod 2 など)を指定します。
使用例
pod=3
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプや取引タイプはありませんが、同じ広告を異なる連続配信広告に配信する場合や、競合相手の除外、フリークエンシー キャップ、関連機能を正しく使用する場合、必須となります。
説明
「クリエイティブ プロファイル」パラメータ(pp
)には、変数値を指定します。これにより、動画とオーディオ クリエイティブのプロファイルに設定した内容に基づいて、配信対象のクリエイティブを選択できます。
使用例
pp=creative_profile
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプはありませんが、動画クリエイティブとオーディオ クリエイティブのプロファイルを使用して Google アド マネージャーでホストされているクリエイティブのメディア ファイルを制限する場合は必要です。リダイレクトまたはプログラマティック広告の場合、この設定は要件が満たされていることを確認するために使用されますが、クリエイティブ プロファイルで選択されたメディア ファイルに限定されるわけではありません。
説明
「パブリッシャーのプライバシーに関する取り扱い」パラメータ(ppt
)には、広告リクエストの広告パーソナライズをオフにするかどうかを示す定数値を指定します。
このパラメータを使用すると、npa=1
や rdp=1
とは異なる非パーソナライズド広告を適用できます。これは、予約広告とプログラマティック デマンドの両方に影響します。
詳しくは、パブリッシャーのプライバシーに関する取り扱いをご覧ください。
使用例
広告のパーソナライズをオフにする:
ppt=1
説明
「パブリッシャー指定の識別子(PPID
)」パラメータには、フリークエンシー キャップ、オーディエンス セグメンテーションとターゲティング、広告の順次ローテーションなど、オーディエンスに基づいて各種デバイスに広告を配信する機能で使用する識別子の変数値を指定します。
詳しくは、パブリッシャー指定の識別子をご覧ください。
使用例
ppid=12JD92JD8078S8J29SDOAKC0EF230337
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプや取引タイプはありませんが、プラットフォームに依存しない一貫した ID を使用するには必要です。他の識別子が存在せず、購入者に提供できる場合に使用できます。
説明
「連続配信広告内の位置」(ppos
)パラメータには、連続配信広告内の位置を表す変数値(たとえば、position 1、position 2 など)を指定します。
このパラメータは標準の連続配信広告にのみ使用するもので、コンパニオンの自動入力に必要です。広告ルールを使用すると、この情報は Google アド マネージャーによって自動的に追加されます。
使用例
ppos=2
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプや取引タイプはありませんが、位置情報ターゲティングが必要な場合や、標準連続配信広告の予測とレポート作成には必要です。また、競合相手の除外、フリークエンシー キャップ、関連機能を正しく使用するためにも必要です。
説明
パブリッシャー提供のシグナルの JSON パラメータ(ppsj
)には、変数値を指定します。これは、パブリッシャーから提供されたオーディエンスとコンテキスト データを含む Base64 エンコードの JSON オブジェクトで、プログラマティックな収益化の機会を増やすことができます。
このパラメータを使用すると、購入者と入札者に特定のシグナルを送信できます。
詳しくは、パブリッシャー提供のシグナルとサポートされている分類をご覧ください。
使用例
JSON オブジェクト:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Base64 でエンコードされた値を適用します。
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
有効な JSON Key-Value ペアの詳細については、
HTML5 IMA SDK のサンプルをご覧ください。
説明
広告ブレーク テンプレートの ID パラメータ(ptpl
)と名前パラメータ(ptpln
)には、最適化された連続配信広告のリクエストに適用する広告ブレーク テンプレートを示す変数値を指定します。
広告ブレーク テンプレートでは、どの広告スポットまたはカスタム広告スポットを広告ブレークに含めて、どの順序で配信するかを設定できます。
広告ブレーク テンプレートをリクエストするには、これらのパラメータのいずれか 1 つが必要です。
使用例
詳しくは、広告ブレーク テンプレートの設定とリクエストの方法をご覧ください。
要件と推奨事項
これらのパラメータは、広告ブレーク テンプレートを直接リクエストする場合にのみ必要です。
説明
広告ブレーク テンプレートの ID パラメータ(ptpl
)と名前パラメータ(ptpln
)には、最適化された連続配信広告のリクエストに適用する広告ブレーク テンプレートを示す変数値を指定します。
広告ブレーク テンプレートでは、どの広告スポットまたはカスタム広告スポットを広告ブレークに含めて、どの順序で配信するかを設定できます。
広告ブレーク テンプレートをリクエストするには、これらのパラメータのいずれか 1 つが必要です。
使用例
詳しくは、広告ブレーク テンプレートの設定とリクエストの方法をご覧ください。
要件と推奨事項
これらのパラメータは、広告ブレーク テンプレートを直接リクエストする場合にのみ必要です。
説明
Ad Exchange の公開最小価格パラメータ(pubf
)と Ad Exchange の非公開最小価格パラメータ(pvtf
)には、Ad Exchange タグに最小価格を追加する際に使用される変数値を指定します。
これらのパラメータは、google_ad_public_floor
と google_ad_private_floor
と同等です。
使用例
公開最小価格:
pubf=123
非公開最小価格:
pvtf=123
要件と推奨事項
これらのパラメータは、欧州経済領域(EEA)またはスイスに拠点を置き、「最小価格」機能の使用が承認されているパブリッシャー様のみが使用できます。
詳しくは、リクエストを送信する方法をご覧ください。
説明
アプリセット ID パラメータ(pvid
)には、Android アプリセット ID に設定される変数値を指定します。アプリセット スコープ パラメータ(pvid_s
)には、アプリセット ID の範囲を示す定数値(scope_app
または scope_developer
)を指定します。
アプリセット ID の取得方法については、Android のドキュメントをご確認ください。
使用例
pvid=[AppSetID_value]
pvid_s=scope_app
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプはありませんが、Android デバイスのモバイルアプリでプログラマティックな収益化を行う場合は使用することをおすすめします。
SDK の使用
IMA / PAL SDK ではこのフィールドは自動的に渡されますが、SDK を実装していないパブリッシャーは、アプリセット SDK を呼び出し、広告リクエストでこれらのパラメータを手動で渡す必要があります。
説明
アプリセット ID パラメータ(pvid
)には、Android アプリセット ID に設定される変数値を指定します。アプリセット スコープ パラメータ(pvid_s
)には、アプリセット ID の範囲を示す定数値(scope_app
または scope_developer
)を指定します。
アプリセット ID の取得方法については、Android のドキュメントをご確認ください。
使用例
pvid=[AppSetID_value]
pvid_s=scope_app
要件と推奨事項
広告配信にこのパラメータが必要となる実装タイプはありませんが、Android デバイスのモバイルアプリでプログラマティックな収益化を行う場合は使用することをおすすめします。
SDK の使用
IMA / PAL SDK ではこのフィールドは自動的に渡されますが、SDK を実装していないパブリッシャーは、アプリセット SDK を呼び出し、広告リクエストでこれらのパラメータを手動で渡す必要があります。
説明
Ad Exchange の公開最小価格パラメータ(pubf
)と Ad Exchange の非公開最小価格パラメータ(pvtf
)には、Ad Exchange タグに最小価格を追加する際に使用される変数値を指定します。
これらのパラメータは、google_ad_public_floor
と google_ad_private_floor
と同等です。
使用例
公開最小価格:
pubf=123
非公開最小価格:
pvtf=123
要件と推奨事項
これらのパラメータは、欧州経済領域(EEA)またはスイスに拠点を置き、「最小価格」機能の使用が承認されているパブリッシャー様のみが使用できます。
詳しくは、リクエストを送信する方法をご覧ください。
説明
制限付きデータ処理(rdp
)パラメータには、広告リクエストでデータ処理を制限する必要があることを示す定数値を設定します。
[データ処理を制限する] のネットワーク設定を有効にすると、ネットワーク レベルでデータ処理を制限できます。
使用例
データ処理を制限する:
rdp=1
または rdp
(値を設定しない)
データ処理を制限しない:
rdp=0
説明
サプライ チェーン(schain
)パラメータには、シリアル化された SupplyChain オブジェクトの変数値を設定します。このパラメータが含まれている場合は、購入者に送信される前に、受け取った schain
オブジェクトにノードが追加されます。
(OpenRTB ではなく)タグを介して SupplyChain の情報を送信する方法については、IAB の詳細なドキュメントをご覧ください。
IAB のドキュメントに基づき、次のように SupplyChain
オブジェクトのシリアル化を定義します。
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject
プロパティとSupplyChainNode
プロパティはカンマ区切りで、任意のフィールドを省略することができます。カンマ区切りは必要に応じて省略できます。- 各
SupplyChainNode
要素は「!
」で区切ります。 - プロパティの値に URL エンコードが必要な文字(「
,
」や「!
」など)が含まれている場合は、シリアル化の前に値を URL エンコードする必要があります。
シリアル化の順序
SupplyChainObject
プロパティは次の順序でシリアル化されます。
ver,complete
SupplyChainNode
プロパティは次の順序でシリアル化されます。
asi,sid,hp,rid,name,domain,ext
ext
の内容はエクスチェンジによって異なります。Google アド マネージャーでは、このプロパティは解析されません。SupplyChain オブジェクトをシリアル化する方法の例
上記の SupplyChain
オブジェクトをシリアル化する方法の 2 つの例を以下に示します。
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
使用例
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
asi
の値が exchange,1
の場合、エスケープ文字を使用したシリアル化は次のようになります。
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
要件と推奨事項
このパラメータが広告の配信に必要となる実装タイプや取引タイプはありませんが、Google アド マネージャーへのリクエストのアップストリームで支払い仲介販売者を利用しているパブリッシャーの場合は必須です。第三者広告サーバー技術を使用するパブリッシャーもこれに該当します。
説明
ストリーム相関値(scor
)パラメータには、動画ストリームごとに生成される整数の変数値を設定します。
scor
と correlator
パラメータが同じ整数値である必要はありませんが、ユニーク視聴セッションを識別するには、各動画ストリームの再生中はそれぞれの値を保持する必要があります。
使用例
scor=17
要件と推奨事項
このパラメータが広告の配信に必要となる実装タイプや取引タイプはありませんが、ウェブ、モバイルアプリ、コネクテッド テレビ、オーディオ、デジタル屋外広告の広告配信では推奨されます。
ユーザーが同じページで複数の動画を視聴している場合、このパラメータは競合相手の除外やフリークエンシー キャップなどの関連機能で使用されます。
説明
SDK API フレームワーク(sdk_apis
)パラメータには、プレーヤーが対応しているすべての API フレームワークを示す、整数の定数値のカンマ区切りリストを設定します。
要件と推奨事項
SDK の使用
プログラマティック アクセス ライブラリ(PAL)を使用している場合は、このパラメータを使用します。IMA SDK を使用している場合、このパラメータに設定した値は、IMA SDK でサポートされている値でオーバーライドされます。
説明
スキップ可能な広告の最大再生時間(sdmax
)パラメータには、パブリッシャーが許可するスキップ可能な広告の最大再生時間を示す変数値を設定します。
特定の広告リクエストでスキップ可能な動画またはオーディオ クリエイティブの再生時間として許可する上限をミリ秒単位で指定します。
sdmax
は、スキップ可能な広告で単体で使用できるほか、既存の max_ad_duration
パラメータと組み合わせて、スキップ可能な広告とスキップ不可の広告で異なる最大再生時間を指定することもできます。
使用例
次のように設定するとします。
max_ad_duration
= 15,000(15 秒)sdmax
= 45,000(45 秒)
次のクリエイティブがあるとします。
- クリエイティブ A: スキップ不可、30 秒
- クリエイティブ B: スキップ可能、30 秒
結果は次のようになります。
- クリエイティブ A はスキップ不可で、再生時間が(スキップ不可の広告の)上限を超えているため、除外されます。
- クリエイティブ B はスキップ可能で、再生時間が
max_ad_duration
を超えているものの、スキップ可能な広告の上限は超えていないため、除外されません。
説明
サーバーサイドの合成ソース(ssss
)パラメータには、Google が動画合成技術ベンダーに提供する、広く認識された値の定数値を設定します。
Google とのサーバー間統合を使用する動画合成技術ベンダーは、Google からこの値を受け取り、お客様に提供することができます。このパラメータに設定する値についてご不明な点がある場合は、Google アカウント マネージャーにお問い合わせください。
使用例:
ssss=mystitcher
要件と推奨事項
このパラメータが広告の配信に必要となる実装タイプはありませんが、サーバーサイドの実装を使用する場合は必須です。
説明
「コンテンツ ソース ID」パラメータ(cmsid
)と「動画 ID」パラメータ(vid
)には、変数値を設定します。
動画コンテンツを広告のターゲットにするには、この両方をマスター動画タグに含める必要があります。
cmsid
は、各コンテンツ ソースを識別する固有の番号です。Google アド マネージャーでこの番号を確認するには、[動画]、[コンテンツ ソース]、該当のコンテンツ ソース名の順にクリックします。vid
は、特定の動画を識別する文字列または番号です。この ID はコンテンツをホストする CMS によって割り当てられます。Google アド マネージャーでこの ID を確認するには、[動画]、[コンテンツ]、該当の動画コンテンツの順にクリックします。
使用例
cmsid=[value]&vid=[value]
ビデオ オンデマンド用にダイナミック広告挿入のタグを作成している場合は、正しいコンテンツ ソースと動画 ID を動的に挿入するマクロを使用する必要があります。
例: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
要件と推奨事項
これらのパラメータが広告配信に必須となる実装タイプや取引タイプはありませんが、動画コンテンツ ターゲティングを使用する場合は必須です。
説明
インライン動画再生リスト(vpi
)パラメータには、インライン VMAP を配信する(VMAP 内部の VAST を返す)かどうかを示す定数値を設定します。
このパラメータを使用すると、待ち時間が短縮されるとともに、動画ストリーム全体でフリークエンシー キャップと競合相手の除外を確実に適用できます。
使用例
VAST を返す場合:
vpi=1
リダイレクトを返す場合:
vpi=0