VAST 広告タグ URL パラメータ

ウェブの場合の必須パラメータと推奨パラメータ

IMA SDK を使用しない Ad Exchange デマンド向けのタグ指定動画ソリューションの実装は、ベータ版として提供されており、ネットワークによってはご利用いただけない場合があります。詳しくは、アカウント マネージャーにお問い合わせください。

下記は、VAST 広告タグ URL パラメータの一部分です。以下のパラメータは、IMA SDK と統合していない場合の、ウェブ向けタグ指定動画ソリューション用です。

詳しくは、アプリの場合の必須パラメータプログラマティック収益化の場合の必須パラメータと推奨パラメータの一覧をご覧ください。

 ブックマークパラメータをクリックするとその詳細に移動します

correlator
description_url
env
gdfp_req

iu
output
plcmt
sz

unviewed_position_start
url
vpmute
wta

 
パラメータ 詳細
correlator

(相関値)

「相関値」パラメータには、同じページビューからの複数のリクエストに共有される変数値を設定します。競合相手の除外を実装するときに使用します。これには Cookie のない環境での実装も含まれます。

IMA SDK を使用している場合、correlator の値は自動的に設定されます。プレーヤーによってこの値が設定されたとしても、IMA SDK によって独自の値で上書きされます。

IMA SDK を使用していない場合は、複数のページビューで再利用されない、真にランダムな正の整数値を設定するようにしてください。

使用例

correlator=4345645667

必須かどうか

必須 ウェブアプリの場合、必須

おすすめ プログラマティック収益化の場合、推奨

description_url

(説明の URL)

「説明の URL」パラメータには、ページで再生される動画の説明となる変数値を設定します。通常は動画プレーヤーを含むページにしますが、動画の説明テキストを記載したページにする場合もあります。

description_url 値は、ウェブページの動画プレーヤーとコネクテッド TV / OTT デバイスの場合は URL エンコードし、モバイルアプリ内動画プレーヤーの場合はエンコードしません。

このパラメータは IMA SDK で自動的に設定されないため、手動で設定する必要があります。

使用例

URL エンコード:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html

エンコードなし:
description_url=
https://www.sample.com/golf.html

要件

必須 ウェブアプリAd Exchange の場合、必須

おすすめ プログラマティック収益化の場合、推奨

env

(環境)

「環境」パラメータには、インストリーム リクエスト、または特に動画プレーヤーからのリクエストであることを示す定数値を設定します。

有効な値は、動画広告とオーディオ広告に使用できる instream、または動画広告にのみ使用できる vp です。

使用例

動画、オーディオ:
env=instream

動画のみ:
env=vp

必須かどうか

必須 ウェブアプリの場合、必須

gdfp_req

(アド マネージャーのスキーマ インジケータ)

「アド マネージャーのスキーマ インジケータ」パラメータには、ユーザーがアド マネージャー スキーマ上に存在することを示す定数値を設定します。

使用例

gdfp_req=1

必須かどうか

必須 ウェブアプリの場合、必須

iu

(広告ユニット)

「広告ユニット」パラメータには、現在の広告ユニットを示す変数値を、次の形式で設定します。

/network_id/.../ad_unit

使用例

iu=/6062/videodemo

必須かどうか

必須 ウェブアプリの場合、必須

output

(広告の出力形式)

「広告の出力形式」パラメータには、広告の出力形式を示す定数値を設定します。

ネットワークに設定したデフォルト VAST バージョンの場合は output=vast を使用します。広告タグやサイトの箇所が特定されている場合は、VAST または VMAP のバージョンを具体的にリクエストできます。

VAST については、動画プレーヤーで IMA SDK を使用している場合、動画広告リクエストの output パラメータは常に output=xml_vast4 に設定されます。IMA SDK は第三者広告サーバーが配信するすべての VAST バージョンと下位互換性があるため、信頼性に関する問題が発生することはありません。

ネットワークで有効にしているデフォルトの VMAP バージョン(VMAP 1 など)を返す場合は、output=vmap を使用します。VMAP 内部の VAST を返す場合は、xml_vmap1_vast3 または xml_vmap1_vast4 を使用して、返す VAST バージョンを指定できます。

使用例

ネットワークのデフォルトの VAST 設定:
output=vast

VAST 4:
output=xml_vast4

ネットワークのデフォルトの VMAP 設定:
output=vmap

VMAP 1:
output=xml_vmap1

VMAP 1(VAST 4 を返す):
output=xml_vmap1_vast4

必須かどうか

必須 ウェブアプリの場合、必須

plcmt

(プレースメント)

プレースメント パラメータでは、IAB 仕様のガイダンスにあるとおり、インストリーム広告枠をインストリームまたは不随として宣言するかどうかを示す定数値を受け取ります。

インストリーム以外のリクエストでは、このフィールドは宣言された広告枠のフォーマットに基づいて自動入力されて購入者に渡され、インストリームまたは付随するコンテンツの宣言がある場合はオーバーライドします。

使用例

インストリームのリクエスト:
plcmt=1

付随するコンテンツのリクエスト:
plcmt=2

要件

必須 ウェブプログラマティック収益化の場合に必須

sz

(サイズ)

「サイズ」パラメータには、マスター動画広告スロットのサイズを示す変数値を設定します。

複数のサイズを指定する場合は、パイプ文字(|)で区切ります。

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

使用例

sz=400x300

必須かどうか

必須 ウェブアプリの場合、必須

ad_type=audio のみをリクエストする場合は省略できます。

unviewed_position_start

(後発インプレッション)

「後発インプレッション」パラメータには、動画に後発インプレッションを指定する定数値を設定します。

使用例

unviewed_position_start=1

必須かどうか

必須 ウェブアプリの場合、必須

url

(URL)

「URL」パラメータには、リクエスト送信元の完全な URL を表す変数値を設定します。この値は、リクエストがどこから送信されているかを購入者が把握するために必要となります。可能な限り、この値は広告リクエストに動的に含めるようにしてください。

ウェブページの場合は、動画プレーヤーを表示しているページの URL になります。IMA SDK を使用している場合は、URL 値が自動的に設定されます。プレーヤーで値が設定された場合、IMA SDK では設定された値が優先されます。

アプリ(モバイルまたはコネクテッド テレビ)の場合は、収益化する動画またはオーディオ広告枠を最も正確に表す URL を値として設定する必要があります。たとえば、ユーザーがモバイルアプリで動画を視聴していて、デスクトップでも同じ URL で視聴できる場合などがこれに該当します*。

このパラメータの値はエンコードする必要があります。

使用例

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

*アプリの場合、このパラメータを変数の URL 値に設定できない場合は、次のパターンで設定することをおすすめします。
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com

要件

必須 ウェブアプリの場合、必須

おすすめ プログラマティック収益化の場合、推奨

vpmute

(ミュート時の動画再生)

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

「ミュート時の動画再生」パラメータには、動画プレーヤーがミュートされているときに広告の再生を開始するかどうかを示す定数値を設定します。

使用例

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

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

要件

必須 ウェブプログラマティック収益化の場合に必須

wta

(広告の表示について)

「広告の表示について」パラメータには、動画プレーヤーが広告の表示についてのレンダリングをサポートしているかどうかを示す定数値を設定します。

「広告の表示について」機能は、IMA SDK を使用している場合は自動的にサポートされます。IMA SDK を使用していない場合は、IAB VAST 規格ドキュメントに沿って動画プレーヤーに VAST の IconIconClickFallbackImage のサポートを実装する必要があります。

オーディオ広告リクエストでは、VAST レスポンスで指定された AdChoices アイコンをコンパニオンに表示するか、別の方法でユーザーに提示する場合は、wta=1 を送信する必要があります。

欧州経済領域で Google デマンドと Google がホストする純広告のトラフィックを配信できるようにするには、広告リクエストで wta=1 を送信して、VAST レスポンスで指定された AdChoices アイコンを動画広告やコンパニオン広告に表示するか、別の方法ですべての広告クリエイティブにおいてユーザーに提示することを示す必要があります。

使用例

サポートしている場合:
wta=1

サポートしていない場合:
wta=0

必須かどうか

必須 Ad Exchange の場合、必須

必須 ウェブアプリの EEA トラフィックの場合は必須

おすすめ プログラマティック収益化の場合、推奨

この情報は役に立ちましたか?

改善できる点がありましたらお聞かせください。
検索
検索をクリア
検索を終了
メインメニュー
8838479588521583606
true
ヘルプセンターを検索
true
true
true
true
true
148
false
false