動画広告のサポートの開始に伴い、購入者は認定バイヤーで動画広告枠を購入できるようになりました。 このドキュメントでは、認定バイヤー プロトコルを使用して RTB で購入するための統合要件について概説します。使用可能なプロトコルについては、スタートガイドのプロトコルの選択のセクションをご覧ください。
購入者は、さまざまなプレースメント(現在はインストリームとインタースティシャル)の動画広告枠を購入できます。詳しくは、 インタースティシャル広告をご覧ください。
購入者の要件
新しい RTB 購入者は、最新のプロトコル バッファと次のセクションで説明する情報を使用して、ビッダーを開発する必要があります。プロトコルをダウンロードするには、リアルタイム ビッダーのリファレンス データのページをご覧ください。ビッダーの開発については、リクエストを処理するとレスポンスを作成するをご覧ください。
サポートされるマクロ
インストリーム動画クリエイティブでは、以下のマクロがサポートされています。
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
認定バイヤーでは VAST ラッパーにクリック トラッカーが組み込まれているため、CLICK_URL_ESC
などのクリックマクロは必要ありません。そのため、インストリーム動画広告ではクリックマクロはサポートされていません。
サポートされているマクロについて詳しくは、レスポンスを作成するのマクロを指定するをご覧ください。
コールアウトの詳細
リアルタイム ビッダー プロトコルは、 リアルタイム ビッダー proto.txt ファイルで定義された動画メッセージを使用して動画リクエストを特定し、そのリクエストに関する動画固有の追加情報を提供します。
ネストされた動画メッセージの次のフィールドのリストでも、詳細な説明と例を確認できます。
description_url
-
動画コンテンツを説明しているページの URL(パラメータを削除済み)。ニュース メディアはこの URL を Google に送信します。例:
http://www.publisher.com/watchpagelink
EndCapSupport
-
有効にすると、動画広告の再生終了後、動画スロットにエンドキャップ(情報カード)として表示されるコンパニオン広告を選択できます。
END_CAP_NOT_ENABLED
コンパニオン広告はエンドキャップとして表示されません。 END_CAP_OPTIONAL
レスポンスに有効なコンパニオン バナーが含まれている場合、エンドキャップが表示されますが、コンパニオン バナーは必須ではありません。 END_CAP_FORBIDDEN
コンパニオン広告を含むレスポンスがフィルタされました。 END_CAP_REQUIRED
コンパニオン広告のないレスポンスは除外されます。 is_embedded_offsite
true
に設定した場合、動画はパブリッシャーのドメイン外のページに埋め込まれます。is_rewarded
-
true
に設定されている場合、ユーザーが動画広告を視聴して報酬を受け取ったことを示します。特典の一般的な例としては、追加の記事を無料で読む、ゲーム内で追加ライフを獲得、スポンサー広告なしの音楽セッションを受ける、などがあります。 max_ad_duration
-
返された広告の最大再生時間(ミリ秒単位)。
0
に設定した場合、最大期間はありません。 max_ads_in_pod
- 認定バイヤーの動画連続配信広告内の広告の最大数。 ゼロ以外の値は、現在の広告スロットが、複数の動画広告を表示できる動画連続配信広告であることを示します。 表示される動画広告の実際の数は、この値と同等か、それ以下にする必要があります。この数を超えることはできません。
min_ad_duration
- 返す広告の最小再生時間(ミリ秒単位)。 この値が設定されていない場合、または値が 0 以下の場合、最小期間はありません。
Placement
-
動画を再生する場所を表します。
UNKNOWN_PLACEMENT
プレースメントが不明であるか、特定できません。 INSTREAM
インストリームとは、他の動画コンテンツの前、途中、または後に広告が再生されることを意味します。これは従来のテレビ コマーシャルに似ています。 広告の再生中は、ユーザーが視聴している動画コンテンツが再生されない。 INTERSTITIAL
インタースティシャルは、動画以外のコンテンツ(ニュース記事やビデオゲームなど)の前に動画広告が再生されることを意味します。広告がコンテンツによって占有される画面上の全体またはほぼすべてのスペースを占め、ユーザーは、広告が終了するかスキップされるまでコンテンツに移動できません。 IN_FEED
インフィード動画フォーマットは、ユーザーがコンテンツのフィード(通常はソーシャル アプリのフィードやニュース記事など)をスクロールしているときに表示される動画クリエイティブです。動画はメインフィードと、ユーザーのビジョンや読書フローに表示されます。動画は、インバナー動画のように横にはレンダリングされません。 skippable_max_ad_duration
- 広告がスキップ可能な場合に返される、広告の最大再生時間(ミリ秒単位)。 これは通常、スキップ不可の広告に許容される最大再生時間とは異なります。このフィールドが設定されていない場合、または値が 0 以下の場合は、任意の期間を使用できます。
VideoPlaybackMethod
-
動画広告の再生方法について説明します。
再生方法は、利用可能な最適な測定値に基づいて、自動再生または Click-to-Play に決定されます。
AUTO_PLAY_SOUND_ON
音声がオンの状態で広告が自動的に再生されることを意味します。 AUTO_PLAY_SOUND_OFF
音声はオフの状態で広告が自動的に再生されることを意味します。 CLICK_TO_PLAY
クリックされるまで再生されないことを意味します video_ad_skippable
SkippableBidRequestType
の値で、次のいずれかの値が含まれます。ALLOW_SKIPPABLE
スキップ可能広告とスキップ不可広告の両方が許可されていることを意味します。 REQUIRE_SKIPPABLE
スキップ可能な広告のみが返されることを意味します。 BLOCK_SKIPPABLE
スキップ不可の広告のみが返される場合があります。 このフィールドが設定されていない場合、デフォルトでスキップ可能な広告が許可されます。
videoad_start_delay
-
動画の開始から広告が表示されるまでの時間(ミリ秒単位)。 0 はプレロール、-1 はポストロールを示します。 その他の正の値は、スロットが動画の真ん中にあることを示します。
この値は、このパラメータが設定されている場合にのみ有効です。設定しない場合、表示位置は不明です。
これらのシグナルは動画クリエイティブに固有のものではありませんが、ビッダーにとっては次のような情報を読み取る価値があります。
advertising_id
- このフィールドは、SSL を使用する場合にのみ設定される 16 バイトの UUID です。これは
encrypted_advertising_id
の暗号化されていないバージョンです。iOS デバイスの場合、広告主向け識別子(IDFA)が含まれています。Android デバイスの場合、Android 識別子(ADID)が含まれます。 コネクテッド テレビ デバイスの場合、一意の識別子(Roku の RIDA など)が含まれます。 device_type
- デバイスのタイプを指定します。
UNKNOWN_DEVICE
このフィールドのデフォルト値です。 HIGHEND_PHONE
動画機能を備えたスマートフォンを含む。 TABLET
タブレット デバイスを含みます。 PERSONAL_COMPUTER
デスクトップ デバイスとノートパソコンが含まれます。 CONNECTED_TV
コネクテッド テレビ(スマートテレビ)とコネクテッド デバイス(Roku、Apple TV など)の両方が含まれます。 GAME_CONSOLE
専用のゲーミング デバイスを含む。 brand
- デバイスのブランド(Nokia、Samsung など)を指定します。 このフィールドは省略可能です。デフォルトでは指定されません。
model
- デバイスの正確なモデル(N70、Galaxy など)を指定します。 このフィールドは省略可能です。デフォルトでは指定されません。
screen_orientation
-
広告リクエストが送信されるときのデバイスの向きを指定します。
有効な値は
LANDSCAPE
、PORTRAIT
、UNKNOWN_ORIENTATION
です。 viewability
-
過去の表示頻度に基づいて、このスロットがエンドユーザーに表示される可能性を予測します。割合で [0, 100] の範囲で指定します。デフォルト値
-1
は、過去の視認性データが利用できないことを示します。 content_attributes.duration_seconds
-
動画が何秒再生されたか(200 など)。これは
ContentAttributes
メッセージで宣言されます。 動画パブリッシャーから提供された動画メタデータで指定された値に設定されます。
動画の入札リクエストには、広告枠に関する情報(業種、許可されたベンダー、チャンネル情報など)も含まれます。入札リクエストのその他の既存のフィールドはすべて、動画にも適用されます。
動画リクエストの AdSlot メッセージの幅と高さのフィールドは、動画広告プレーヤーのサイズに対応します。
allowed_vendor_type
- 許可されたベンダー。ID のリストについては、技術ドキュメントの vendors.txt ファイルをご覧ください。たとえば、309 は キャンペーン マネージャー 動画ユニットです。
allowed_video_formats
-
このリクエストに応じて配信される広告で許可されている動画技術を示します。レスポンスでは、そのうちの少なくとも 1 つに対するサポートを示す必要があります。この繰り返しフィールドの値は、VideoFormat 列挙型から取得されます。
VIDEO_FLASH
Flash 動画(FLV)形式を使用する動画を許可します。 VIDEO_HTML5
HTML5 動画形式を使用する動画を許可します。 VPAID_FLASH
Video Player Ad-Serving Interface Definition(VPAID)の Flash 動画形式を使用する動画を許可します。 VPAID_JS
VPAID JavaScript 動画形式を使用する動画を許可します。 companion_slot
- このフィールドは、次のフィールドを含む CompanionSlot メッセージを表します。
height
このスロットで使用可能な高さ。 width
このスロットで使用可能な幅。 CreativeFormat
クリエイティブ フォーマットは、このコンパニオン スロットのクリエイティブに使用できるフォーマットを表します。 url
-
動画再生ページの URL、または動画が埋め込まれているページの URL。例:
http://www.publisher.com/watchpagelink
ビッダーは、動画リクエストに応答する際に video_url
フィールドで VAST リダイレクト URL を返す必要があります。入札レスポンスには、動画広告に関する適切な宣言も含まれている必要があります。
以下は、適切な動画の入札レスポンスの例です。
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
動画の入札レスポンスで重要となるフィールドは次のとおりです。
attribute
-
このスニペットから表示できる広告のすべての属性です。ID のリストについては、
buyer-declarable-creative-attributes.txt ファイルをご覧ください。
Google では、入札リクエストの
excluded_attribute
リストに上記の属性が含まれていないことを確認します。このフィールドは、HTML スニペットまたは動画広告が返される場合にのみ設定します。 たとえば、このフィールドを30
に設定すると、広告のレンダリングに VPAID 対応が必要であることを示します。 protocol
- 動画広告リクエストにおいてパブリッシャーがサポートしている VAST バージョンを表します。そのバージョンまでの VAST 広告を許可します。サポートされている動画広告プロトコルの配列が格納されます。
これは OpenRTB 2.4 の動作と一致します。
可能な値は、
VAST_2_0
、VAST_3_0
、VAST_2_0_WRAPPER
、VAST_3_0_WRAPPER
、VAST_4_0
、VAST_4_0_WRAPPER
です。 video_url
-
動画広告の VAST リダイレクト URL。次に例を示します。
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
- 購入者が動画広告を含める方法
- すべての動画フォーマット向けの OpenRTB の推奨シグナル
- 認定バイヤー プロトコルの推奨シグナル(すべての動画フォーマット向け)
- パブリッシャーが動画を許可または禁止する方法
- エッジケース
プレターゲティング設定
RTB 購入者は動画広告枠を受け取るには、動画広告枠を含む RTB のプレターゲティング設定が必要です。
入札リクエストとレスポンスの例
AdX 動画フォーマット
購入者様に動画を含める方法
次の表は、購入者がウェブとモバイルアプリで動画をクリエイティブとプレースメントに配信する方法を示したものです。
ウェブ
動画クリエイティブ | インストリーム(すべて) | インフィード、記事 | ネイティブ インフィード/記事 | インタースティシャル | インバナー |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
カスタム JS |
|
||||
ネイティブ + VAST |
|
モバイルアプリ
動画クリエイティブ | インストリーム(すべて) | インフィード、記事 | ネイティブ インフィード/記事 | インタースティシャル | インバナー |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
カスタム JS |
|||||
ネイティブ + VAST |
キー | 利用できる形式/テクノロジーがない | このプレースメントで承認された動画クリエイティブ(パブリッシャーによるブロックの対象) |
このプレースメントでは使用できる動画クリエイティブがありません |
---|
OpenRTB の推奨シグナル
次の表は、パソコンとモバイルウェブ、モバイルアプリのすべての動画フォーマットで OpenRTB の推奨シグナルを示しています。
PC ウェブとモバイルウェブ
動画フォーマット | 推奨シグナル(動画関連のシグナルのみ) | 関連シグナル(動画の関連シグナルのみ) |
---|---|---|
インストリーム(VPAID) |
VIDEO オブジェクトあり、 |
|
インストリーム(VPAID なし) |
VIDEO オブジェクトあり、 |
|
アウトストリーム |
VIDEO オブジェクトがあります
|
|
インフィード |
VIDEO オブジェクトあり、 |
|
記事内 |
VIDEO オブジェクトあり、 |
|
ネイティブ |
NATIVE オブジェクトが存在し、 |
|
インバナー |
動画オブジェクトが存在しない & |
モバイルアプリ
動画フォーマット | 入札リクエストの詳細(動画関連の詳細情報のみ) | |
---|---|---|
インストリーム |
VIDEO オブジェクトあり、 |
|
アウトストリーム |
VIDEO オブジェクトがあります
|
|
インフィード |
VIDEO オブジェクトあり、 |
|
記事内 |
VIDEO オブジェクトあり、 |
|
ネイティブ |
NATIVE オブジェクトが存在し、 |
|
インタースティシャル(VAST) |
VIDEO オブジェクトあり、 |
|
インタースティシャル(VAST なし) |
VIDEO オブジェクトあり、 |
フィルタ適用 |
インバナー(MRAID) |
動画オブジェクトが存在しない & |
|
インバナー (MRAID なし) |
動画オブジェクトが存在しない & |
AdX プロトコル推奨シグナル
以下の表は、パソコンウェブとモバイルウェブ、モバイルアプリのすべての動画フォーマットを対象とした、認定バイヤーのプロトコルによる推奨シグナルを示しています。
PC ウェブとモバイルウェブ
動画フォーマット | 推奨される動画関連のシグナル | 関連動画関連のシグナル |
---|---|---|
インストリーム(VPAID) |
動画メッセージありと |
|
インストリーム(VPAID なし) |
動画メッセージありと |
Allowed_video_formats = VIDEO_HTML5 & |
インフィード |
動画メッセージありと |
Allowed_video_formats = VIDEO_HTML5 & |
記事内 |
動画メッセージありと |
|
ネイティブ |
ネイティブ メッセージ内に NATIVE メッセージがあります & |
|
インバナー |
|
|
モバイルアプリ
次の表は、PC ウェブとモバイルウェブ、モバイルアプリのすべての動画フォーマット向けの AdX プロトコル推奨シグナルを示しています。
動画フォーマット | 動画関連の入札リクエストの詳細 | 動画関連のシグナル |
---|---|---|
インストリーム |
動画メッセージあり |
|
インフィード |
動画メッセージありと |
|
記事内 |
動画メッセージの表示 & |
|
ネイティブ |
ネイティブ メッセージ内に NATIVE メッセージがあります & |
|
インタースティシャル |
動画メッセージありと |
|
インバナー(MRAID) |
|
|
インバナー (MRAID なし) |
|
|
パブリッシャーが動画を許可または禁止する方法
次の表は、パブリッシャーがプレースメントで動画を許可または禁止する方法と、OpenRTB と AdX プロトコルの入札リクエストに反映される仕組みを示しています。
OpenRTB
パブリッシャー オプション | 適用可能なフォーマット | 入札リクエストでは次のように記述されます。 |
---|---|---|
インストリーム動画の単位を指定する |
インストリーム(すべて) |
動画オブジェクトあり |
VPAID を有効にする |
インストリーム ウェブ |
動画オブジェクトあり |
IBV にオプトインする |
インバナー インタースティシャル |
|
アウトストリームを有効にする(instructions) |
インフィード 記事内 |
動画オブジェクトが存在し、 |
アウトストリームを有効にする(instructions) |
ネイティブ |
ネイティブ オブジェクトがあります |
動画インタースティシャルをブロックする |
インタースティシャル アプリ |
VIDEO オブジェクトが存在しない |
AdX プロトコル
パブリッシャー オプション | 適用可能なフォーマット | 入札リクエストでの記述(注: これらは、入札リクエストのパブリッシャー オプションを示すすべての指標です。推奨されるシグナルについては、以下の表を参照してください) | デフォルト設定 |
---|---|---|---|
インストリーム動画の単位を指定する |
インストリーム(すべて) |
動画メッセージあり & |
なし |
VPAID を有効にする |
インストリーム ウェブ |
動画メッセージあり &
|
オプトアウトしています |
IBV にオプトインする |
インバナー インタースティシャル |
|
オプトアウトしています |
アウトストリームを有効にする(instructions) |
インフィード 記事内 |
動画メッセージあり & |
オプトアウトしています |
アウトストリームを有効にする(instructions) |
ネイティブ |
NATIVE メッセージあり ネイティブ メッセージ内の |
オプトアウトしています |
動画インタースティシャルをブロックする |
インタースティシャル アプリ |
動画メッセージなし、 |
オプトインしています |
エッジケース
# | ケースの説明 | コメント | 入札リクエスト |
---|---|---|---|
1 |
MRAID を使用してカスタム クローズを遅らせる |
インタースティシャルの場合、購入者がカスタム クローズを使用していない場合でも、広告を閉じると MRAID を使用して購入者に通知を送信できます。 AdX で適用された X は、カスタム終了が 5 秒後に表示される場合でも、常にカスタムの成約の上に表示される |
用語集
認定バイヤーの動画用語集をご覧ください。
インストリームとアウトストリーム フォーマットの AdX および OpenRTB フィールド
AdX プロトコル
BidRequest.Video です。 | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
OpenRTB プロトコル
OpenRTB 2.5(47 ページ以降)をご覧ください。
BidRequest.Video です。 | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
インプレッションがリニア、ノンリニアなどでなければならないかどうかを示します。 何も指定しない場合、すべて許可されると見なされます。
|
||||
videoad_start_delay
|
|
入札リクエストの値のソース
OpenRTB オブジェクト | フィールド | AdX /エクスチェンジ 入札 アウトストリーム |
サンプル値 | 誰がそれを決定するか? /この値の の取得元は何ですか? |
---|---|---|---|---|
オブジェクト | ||||
動画 | マイム | はい | ["application/javascript", "video/mp4"]", |
|
最小期間 | × | パブリッシャーが設定済み | ||
最大再生時間 | はい | パブリッシャーが設定済み | ||
Playbackmet hod |
はい | [6] | 通常パブリッシャーの 設定済み |
|
api(MRAID) | はい | [1、2]。 | ||
protocols | はい | [2、3、5、6、7、8] | ||
線形性 | はい | [1] | ||
プレースメント | はい | [1] | ||
プレーヤーの幅 | はい | 400,400,300 | ||
プレーヤーの高さ | はい | 225,300,153 | ||
開始遅延 | はい | 0 | Google、デフォルトは 5 秒 | |
スキップ | はい | 1 | パブリッシャー/Google - インタースティシャル => Google - インストリーム => パブリッシャー が、 スキップ可能、スキップ不可、またはその両方を許可するかどうかを決定します。 リワード広告(常にスキップ不可) |
|
最小ビットレート | × | |||
最大ビットレート | × | |||
pos | はい | 1 | ||
デバイス | ||||
Px 比率 | はい | 1 | ||
インプレッション | ||||
安全 | はい | 1 | Google の デフォルトは true です 広告タグは常に 保護されているためです。 |