動画広告

動画広告のサポートの開始に伴い、購入者は認定バイヤーで動画広告枠を購入できるようになりました。 このドキュメントでは、認定バイヤー プロトコルを使用して 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

プレターゲティング設定

RTB 購入者は動画広告枠を受け取るには、動画広告枠を含む RTB のプレターゲティング設定が必要です。

入札リクエストとレスポンスの例

AdX 動画フォーマット

購入者様に動画を含める方法

次の表は、購入者がウェブとモバイルアプリで動画をクリエイティブとプレースメントに配信する方法を示したものです。

ウェブ

動画クリエイティブ インストリーム（すべて） インフィード、記事 ネイティブ インフィード/記事 インタースティシャル インバナー

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

カスタム JS

 

ネイティブ + VAST

 

モバイルアプリ

動画クリエイティブ インストリーム（すべて） インフィード、記事 ネイティブ インフィード/記事 インタースティシャル インバナー

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

カスタム JS

ネイティブ + VAST

キー 利用できる形式/テクノロジーがない

このプレースメントで承認された動画クリエイティブ（パブリッシャーによるブロックの対象）

このプレースメントでは使用できる動画クリエイティブがありません

OpenRTB の推奨シグナル

次の表は、パソコンとモバイルウェブ、モバイルアプリのすべての動画フォーマットで OpenRTB の推奨シグナルを示しています。

PC ウェブとモバイルウェブ

動画フォーマット 推奨シグナル（動画関連のシグナルのみ） 関連シグナル（動画の関連シグナルのみ）

インストリーム（VPAID）

VIDEO オブジェクトあり、
video.placement = INSTREAM   &

インストリーム（VPAID なし）

VIDEO オブジェクトあり、
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

アウトストリーム

VIDEO オブジェクトがあります

video.linearity: linear
プレースメントは実際の
プレースメントに依存します。値は下記のとおりです。
Video.startdelay = 0

インフィード

VIDEO オブジェクトあり、
video.placement = IN-FEED

記事内

VIDEO オブジェクトあり、
video.placement = IN-ARTICLE

ネイティブ

NATIVE オブジェクトが存在し、

インバナー

動画オブジェクトが存在しない &
banner.battr ≠ 6 インバナー動画（自動再生）と
banner.battr ≠ 7 インバナー動画（ユーザーが開始）

モバイルアプリ

動画フォーマット 入札リクエストの詳細（動画関連の詳細情報のみ）

インストリーム

VIDEO オブジェクトあり、
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 または 2: VPAID 2.0

アウトストリーム

VIDEO オブジェクトがあります

video.linearity: linear
プレースメントは実際の
プレースメントに依存します。値は下記のとおりです。
Video.startdelay = 0

インフィード

VIDEO オブジェクトあり、
video.placement = IN-FEED

記事内

VIDEO オブジェクトあり、
video.placement = IN-ARTICLE

ネイティブ

NATIVE オブジェクトが存在し、

インタースティシャル（VAST）

VIDEO オブジェクトあり、
video.placement = INTERSTITIAL

インタースティシャル（VAST なし）

VIDEO オブジェクトあり、
video.placement = INTERSTITIAL

フィルタ適用

インバナー（MRAID）

動画オブジェクトが存在しない &
banner.battr ≠ 6 インバナー動画（自動再生）と
banner.battr ≠ 7 インバナー動画（ユーザー開始）

インバナー

（MRAID なし）

動画オブジェクトが存在しない &
banner.battr ≠ 6 インバナー動画（自動再生）と
banner.battr ≠ 7 インバナー動画（ユーザー開始）

AdX プロトコル推奨シグナル

以下の表は、パソコンウェブとモバイルウェブ、モバイルアプリのすべての動画フォーマットを対象とした、認定バイヤーのプロトコルによる推奨シグナルを示しています。

PC ウェブとモバイルウェブ

動画フォーマット 推奨される動画関連のシグナル 関連動画関連のシグナル

インストリーム（VPAID）

動画メッセージありと
placement = INSTREAM    &
Allowed_video_formats = VPAID_JS

Allowed_video_formats = VIDEO_HTML5
Allowed_ad_types = VIDEO

インストリーム（VPAID なし）

動画メッセージありと
placement = INSTREAM    &
Allowed_video_formats ≠ VPAID_JS

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

インフィード

動画メッセージありと
placement = IN-FEED

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

記事内

動画メッセージありと
placement = IN-ARTICLE

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

ネイティブ

ネイティブ メッセージ内に NATIVE メッセージがあります   &
VIDEO = 000x000

Allowed_ad_types = NATIVE

インバナー

excluded_attribute ≠ 95 VideoType: インバナー動画（パブリッシャーがブロック可能）

Allowed_ad_types = BANNER

モバイルアプリ

次の表は、PC ウェブとモバイルウェブ、モバイルアプリのすべての動画フォーマット向けの AdX プロトコル推奨シグナルを示しています。

動画フォーマット 動画関連の入札リクエストの詳細 動画関連のシグナル

インストリーム

動画メッセージあり
placement = INSTREAM

Allowed_video_formats = VIDEO_HTML5
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

インフィード

動画メッセージありと
placement = IN-FEED

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

記事内

動画メッセージの表示   &placement = IN-ARTICLE

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

ネイティブ

ネイティブ メッセージ内に NATIVE メッセージがあります   &
VIDEO = 000x000

Allowed_ad_types = NATIVE

インタースティシャル

動画メッセージありと
placement = INTERSTITIAL   &

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = VIDEO

インバナー（MRAID）

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)  &
excluded_attribute ≠ 32 MraidType: MRAID

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = BANNER

インバナー

（MRAID なし）

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)  &
excluded_attribute = 32 MraidType: MRAID

Allowed_video_formats = VIDEO_HTML5   &
excluded_attribute = 30 InstreamVastVideoType: Vpaid
Allowed_ad_types = BANNER

パブリッシャーが動画を許可または禁止する方法

次の表は、パブリッシャーがプレースメントで動画を許可または禁止する方法と、OpenRTB と AdX プロトコルの入札リクエストに反映される仕組みを示しています。

OpenRTB

パブリッシャー オプション 適用可能なフォーマット 入札リクエストでは次のように記述されます。

インストリーム動画の単位を指定する

インストリーム（すべて）

動画オブジェクトあり
video.placement = INSTREAM

VPAID を有効にする

インストリーム ウェブ

動画オブジェクトあり
video.api = 1（VPAID 1.0）または 2（VPAID 2.0）

IBV にオプトインする

インバナー

インタースティシャル

banner.battr ≠ 6 インバナー動画（自動再生）および 7 インバナー動画（ユーザー開始）

アウトストリームを有効にする（instructions）

インフィード

記事内

動画オブジェクトが存在し、
video.placement = IN-FEED または IN-ARTICLE

アウトストリームを有効にする（instructions）

ネイティブ

ネイティブ オブジェクトがあります

動画インタースティシャルをブロックする

インタースティシャル アプリ

VIDEO オブジェクトが存在しない

AdX プロトコル

パブリッシャー オプション 適用可能なフォーマット 入札リクエストでの記述（注: これらは、入札リクエストのパブリッシャー オプションを示すすべての指標です。推奨されるシグナルについては、以下の表を参照してください） デフォルト設定

インストリーム動画の単位を指定する

インストリーム（すべて）

動画メッセージあり &
placement = INSTREAM

なし

VPAID を有効にする

インストリーム ウェブ

動画メッセージあり &
Allowed_video_formats = VPAID_JS &

excluded_attribute ≠ 30 InstreamVastVideoType: Vpaid

オプトアウトしています

IBV にオプトインする

インバナー

インタースティシャル

excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)

オプトアウトしています

アウトストリームを有効にする（instructions）

インフィード

記事内

動画メッセージあり &
Allowed_video_formats = VIDEO_HTML5 &
placement = IN-FEED or IN-ARTICLE

オプトアウトしています

アウトストリームを有効にする（instructions）

ネイティブ

NATIVE メッセージあり

ネイティブ メッセージ内の VIDEO = 000x000

オプトアウトしています

動画インタースティシャルをブロックする

インタースティシャル アプリ

動画メッセージなし、
excluded_attribute = 30 InstreamVastVideoType: Vpaid

オプトインしています

エッジケース

# ケースの説明 コメント 入札リクエスト

1

MRAID を使用してカスタム クローズを遅らせる

インタースティシャルの場合、購入者がカスタム クローズを使用していない場合でも、広告を閉じると MRAID を使用して購入者に通知を送信できます。


AdX で適用された X は、カスタム終了が 5 秒後に表示される場合でも、常にカスタムの成約の上に表示される

用語集

認定バイヤーの動画用語集をご覧ください。

インストリームとアウトストリーム フォーマットの AdX および OpenRTB フィールド

AdX プロトコル

BidRequest.Video です。
Placement
インストリーム mWeb

0: UNKNOWN_PLACEMENT
1: INSTREAM

mApp

0: UNKNOWN_PLACEMENT
1: INSTREAM
アウトストリーム mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE

Rewarded

is_rewarded
videoad_start_delay
インストリーム mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
アウトストリーム Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

OpenRTB プロトコル

OpenRTB 2.5（47 ページ以降）をご覧ください。

BidRequest.Video です。
Placement
インストリーム mWeb

1: インストリーム
2: インバナー

mApp

1: インストリーム
2: インバナー
アウトストリーム mApp Interstitial

5: インタースティシャル

Native

3: 記事内
4: インフィード

Rewarded

is_rewarded_inventory: OpenRTB 拡張機能のブール値
linearity

インプレッションがリニア、ノンリニアなどでなければならないかどうかを示します。 何も指定しない場合、すべて許可されると見なされます。

インストリーム mWeb

1: LINEAR（インストリーム）

mApp

1: LINEAR（インストリーム）
アウトストリーム mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
インストリーム mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
アウトストリーム Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

入札リクエストの値のソース

OpenRTB
オブジェクト 		フィールド AdX
/エクスチェンジ
入札
アウトストリーム		 サンプル値 誰がそれを決定するか？
/この値の
の取得元は何ですか？
オブジェクト
動画 マイム はい ["application/javascript",
"video/mp4"]",		 Google
最小期間 × パブリッシャーが設定済み
最大再生時間 はい パブリッシャーが設定済み
Playbackmet
hod		 はい [6] 通常パブリッシャーの
設定済み
api（MRAID） はい [1、2]。 Google
protocols はい [2、3、5、6、7、8] Google
線形性 はい [1] Google
プレースメント はい [1] Google
プレーヤーの幅 はい 400,400,300 Google
プレーヤーの高さ はい 225,300,153 Google
開始遅延 はい 0 Google、デフォルトは 5 秒
スキップ はい 1 パブリッシャー/Google
- インタースティシャル => Google
- インストリーム => パブリッシャー
が、
スキップ可能、スキップ不可、またはその両方を許可するかどうかを決定します。
リワード広告（常にスキップ不可）
最小ビットレート × Google
最大ビットレート × Google
pos はい 1 Google
デバイス
Px 比率 はい 1 Google
インプレッション
安全 はい 1 Google の
デフォルトは true です
広告タグは常に
保護されているためです。