動画広告

このガイドでは、統合の要件、構成、 動画に入札する際に使用できる、関連する OpenRTB プロトコル フィールド できます。Google RTB プロトコルは非推奨であるため、このガイドでは取り上げません。Google RTB プロトコルの動画広告については、Google RTB の動画広告ガイドをご覧ください。

Google は、インストリーム広告、ネイティブ動画広告、インタースティシャル動画広告をサポートしています。これらのフォーマットの詳細については、ネイティブ広告フォーマットとインタースティシャル広告フォーマットのガイドをご覧ください。

購入者の要件

RTB プロトコル

このガイドでは一般に Protobuf 形式について説明しますが、特に明記しない限り、フィールド名とパスは Protobuf 形式と JSON 形式で同じです。

OpenRTB プロトコルと Google 固有の OpenRTB 拡張機能については、プロトコルとリファレンス データのページをご覧ください。対象 ビッダーの作成について詳しくは リクエストを処理し、 レスポンスを作成する。

クリエイティブの審査

クリエイティブを使用して入札する前に、クリエイティブを送信して承認を受けることをおすすめします。審査プロセスを開始するには、Real-time Bidding API のクリエイティブ リソースを使用します。

プレターゲティング設定

動画広告枠を受け取るには、認定バイヤー アカウントで 作成 プレターゲティング設定 動画広告枠が含まれます

マクロ

マクロは、動画 URL リンクまたは BidResponse.seatbid.bid.adm。また、スペースに リンク先の VAST XML ドキュメント内にマクロを配置することもできます。動画クリエイティブでは、次のマクロがサポートされています。

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

次の理由により、クリックマクロ（CLICK_URL_ESC など）はサポートされていません 認定バイヤーでは、クリック トラッカーが VAST ラッパーに含まれています。詳細情報 マクロの詳細については、 マクロを指定します。

コールアウトの詳細

OpenRTB の BidRequest.imp.video フィールドを使用すると、受信した入札リクエストがインストリーム動画広告枠またはインタースティシャル動画広告枠を対象としているかどうかを特定し、リクエストに関する動画固有の追加情報を確認できます。また、ネイティブ広告枠では、BidRequest.imp.native.{request/request_native}.assets.video を使用して動画固有の類似情報を指定することもできます。

BidRequest.{app/site}.content.producer.domain

パラメータを削除した URL 動画コンテンツの説明ページ内の ID です。 ニュース メディアはこの URL を Google に送信します。例:

http://www.publisher.com/watchpagelink
banner.vcm
true に設定すると、コンパニオン広告を選択してレンダリングできます。 動画広告の終了後に動画スロットのエンドキャップ（情報カード）として表示される 再生します。それ以外の場合、コンパニオン広告はエンドキャップとしてレンダリングされません。
BidRequest.imp.rwdd
true に設定すると、動画広告を視聴したユーザーがリワードを受け取ることを示します。一般的な特典には、追加記事を無料で読む、ゲームで追加のライフを獲得する、スポンサー提供の広告なしの音楽セッションを利用するなどがあります。
BidRequest.imp.video.maxduration

返す広告の最大許容時間（秒）。 未設定の場合、最長時間はありません。日時 BidRequest.imp.video.skip は true です。 動作が異なります。スキップ可能な動画の最大再生時間をご覧ください をご覧ください。

BidRequest.imp.video.maxseq

動画連続配信広告内の広告の最大数。未設定の場合、広告スロットは動画ポッドの一部ではありません。

実際に表示される動画広告の数は、この値以下に抑えることができますが、この値を超えることはできません。

BidRequest.imp.video.minduration
返される広告の最小再生時間（秒）。設定されていない場合、最小時間は設定されません。
BidRequest.imp.video.plcmt
動画が再生される場所を表します。
PLCMT_UNKNOWN 配置が不明であるか、決定できません。
PLCMT_INSTREAM 広告の前に再生されるプレロール広告、ミッドロール広告、ポストロール広告 ストリーミング動画コンテンツの再生中や再生後に 渡されます。インストリーム動画は、プレーヤーの開始時にデフォルトで「音声オン」に設定されているか、動画コンテンツを視聴する明確なユーザーの意図がなければなりません。プレーヤーの周囲に他のコンテンツがあっても、ユーザーがアクセスした目的が動画コンテンツである必要があります。ページのメイン コンテンツであり、再生時に音声を再生できる唯一の動画プレーヤーである必要があります。プレーヤーがフローティング / スティッキーに変換された場合、その後の広告呼び出しで、更新されたプレーヤーのサイズを正確に伝える必要があります。
PLCMT_ACCOMPANYING_CONTENT ストリーミング動画コンテンツの再生前、再生中、再生後に再生されるプレロール広告、ミッドロール広告、ポストロール広告。動画プレーヤーは、テキストまたはグラフィック コンテンツの段落の前、途中、または後に読み込まれて再生され、ビューポートに入った場合にのみ再生が開始されます。付随するコンテンツは、 表示されなくなります。ページからスクロールして外れた場合は、フローティング プレーヤーまたは追尾型プレーヤーに変換される場合があります。
PLCMT_INTERSTITIAL 動画コンテンツなしで再生される動画広告。再生中は、ページのメイン要素となり、ビューポートの大部分を占める必要があります。また、スクロールして表示範囲から外すことはできません。たとえば、アプリ内動画やスライドショーなどのプレースメントに表示できます。
PLCMT_NO_CONTENT_STANDALONE 動画コンテンツのストリーミングなしで再生される動画広告。スライドショー、ネイティブ フィード、コンテンツ内、固定 / フローティングなどのプレースメントに表示できます。
BidRequest.imp.video.playbackmethod
動画広告の再生方法について説明します。 再生方法は、利用可能な最適な測定に基づいて、自動再生またはクリックして再生のいずれかに決定されます。
AUTO_PLAY_SOUND_ON ページの読み込み時に音声がオンで開始されます。
AUTO_PLAY_SOUND_OFF ページの読み込み時に音声をオフにして開始します。
CLICK_TO_PLAY クリックで開始し、音声がオン。
MOUSE_OVER マウスオーバーで音声オンで開始します。
ENTER_SOUND_ON 音声がオンの状態でビューポートに表示されると開始されます。
ENTER_SOUND_OFF ビューポートに入ると開始し、デフォルトで音声オフ。
BidRequest.imp.video.skip
true の場合、プレーヤーが動画を許可することを示します。 許可するかを設定できますそれ以外の場合は、スキップ可能な広告が許可されていないことを示します。
BidRequest.imp.video.startdelay

0 はプレロール、-1 はミッドロール、-2 はミッドロール はポストロールです。

その他の正の値は、イベントの開始からの 広告が表示される位置まで動画が表示されます。

これらのシグナルは動画クリエイティブに固有のものではなく 特に次の点を確認します

BidRequest.device.ifa
このフィールドは、SSL を使用する場合にのみ設定される 36 文字の UUID です。 ハッシュ化されませんこれは、BidRequest.device.dpidm5 の暗号化されていないバージョンです。iOS デバイスの場合は、 広告主識別子（IDFA）すべて大文字。Android デバイスの場合、Android ID（ADID）が小文字で含まれています。コネクテッド テレビ デバイスの場合、固有の識別子が含まれます。 （Roku の RIDA など）。
BidRequest.device.devicetype
デバイスのタイプを指定します。
MOBILE HIGHEND_PHONE または TABLET の廃止されたエイリアス。
PERSONAL_COMPUTER デスクトップ デバイスとノートパソコン デバイスが含まれます。
CONNECTED_TV コネクテッド テレビ（スマートテレビ）とコネクテッド デバイス（Roku、Apple TV など）の両方が含まれます。
HIGHEND_PHONE ハイエンド スマートフォン デバイスが含まれます。
TABLET タブレット デバイスも含まれます。
CONNECTED_DEVICE 専用のゲームデバイスが含まれます。
SET_TOP_BOX セットトップ ボックス デバイスも含まれます。
OOH_DEVICE 屋外広告デバイスを含む例: デジタル 掲示できます
BidRequest.device.make
デバイスのブランド（Nokia、Samsung など）を指定します。
BidRequest.device.model
次の場合にデバイスの正確なモデル（N70、Galaxy など）を指定します。 それ以外の場合は、「iphone」などの汎用モデルが含まれます。
BidRequest.imp.metric
Metric.type が completion_rate に設定されている場合は、 Metric.value は [0.0, 1.0] の範囲の小数になります 広告で配信された動画広告の過去の完全再生率 あります。デフォルト値の -1.0 は、 完了率データは利用できません。
BidRequest.imp.video.poddur
すべてのスロットを含む広告ブレーク全体の時間（秒） Pod が構成されていることがわかります。これは、動画パブリッシャーが提供する動画メタデータで指定された値に設定されます。

動画入札リクエストには、カテゴリ、許可されたベンダー、チャンネル情報など、広告枠に関する情報も含まれます。すべて 入札リクエストのその他の既存のフィールドも動画に適用されます。

動画リクエストの AdSlot メッセージの width フィールドと height フィールドは、動画広告プレーヤーのサイズに対応しています。

BidRequest.imp.ext.allowed_vendor_type
許可されるベンダー。ID の一覧については、技術ドキュメントの vendors.txt ファイルをご覧ください。たとえば、309 = DFA 動画ユニットです。
BidRequest.imp.video.mimes
入札リクエストに応答して配信される広告でサポートされているコンテンツの MIME タイプを記述する許可リスト（例:「video/mp4」）。入札レスポンス 少なくとも 1 つをサポートしていることを示します。
BidRequest.imp.video.protocols
動画広告リクエストでパブリッシャーがサポートしている VAST バージョンを記述します。 次のような Protocol 列挙値の配列が含まれます。 VAST_2_0、VAST_3_0、 VAST_2_0_WRAPPER、VAST_3_0_WRAPPER、 VAST_4_0、VAST_4_0_WRAPPER など。
BidRequest.imp.video.companionad
このフィールドには、Banner オブジェクトの配列 利用できる場合は
BidRequest.site.page

動画再生ページの URL または動画が埋め込まれているページの URL。例:

http://www.publisher.com/watchpagelink

動画リクエストに応答する際、ビッダーは VAST リダイレクトを返す必要がある BidResponse.seatbid.bid.adm フィールドには URL または VAST XML を指定する必要があります。「 入札レスポンスには動画広告に関する適切な宣言も含める必要があります。「 適切な動画入札レスポンスの抜粋を以下に示します。 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

動画入札レスポンスで重要なフィールドは次のとおりです。

BidResponse.seatbid.bid.ext.attribute
このスニペットから表示される広告の属性。詳しくは、 buyer-declarable-creative-attributes.txt ご覧ください。Google は、これらの属性がパブリッシャーが入札リクエストで禁止した属性と一致していないことを確認します。たとえば、いずれかのフィールドに 30 が含まれている場合は、広告のレンダリングに VPAID のサポートが必要であることを示します。
BidResponse.seatbid.bid.adm

動画広告の場合は、動画広告の VAST リダイレクト URL です。次に例を示します。

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

または、未加工の VAST XML を使用することもできます。

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

動画の形式

購入者が動画を含める方法

以下の表は、購入者がクリエイティブに動画を含める方法と、 ウェブアプリとモバイルアプリのそれぞれで配信可能なプレースメントです。

ウェブ

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

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 インバナー動画（ユーザー開始）

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

次の表に、パブリッシャーがプレースメントで動画を許可または禁止する方法を示します。

パブ オプション 適用される形式 入札リクエストで次のように記述

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

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

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

VPAID を有効にする

インストリーム ウェブ

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

IBV を有効にする

インバナー

インタースティシャル

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

オプトインする（手順）

インフィード

記事内

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

インストリーム以外を有効にする（手順）

ネイティブ

ネイティブ オブジェクトが存在する

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

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

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

エッジケース

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

1

MRAID を使用したカスタム クローズの遅延

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


適用された認定バイヤー X は、常に （カスタム クローズが 5 秒後に下部に表示される場合でも）

用語集

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

インストリーム フォーマットと非インストリーム フォーマットに関連するフィールド

OpenRTB 2.5（47 ページから）をご覧ください

動画。
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
オブジェクト		 フィールド 認定バイヤー
/エクスチェンジ（
） 入札
インストリーム以外		 サンプル値 誰が決定しますか？
/この値の
の導出場所 どこからですか？
オブジェクト
動画 mimes あり ["application/javascript",
"video/mp4"]",		 Google
minduration × パブリッシャーが設定
最長時間 あり パブリッシャーが設定
playbackmet
hod		 あり [6] 通常はパブリッシャー
が構成されている
API（MRAID） あり [1,2] Google
プロトコル あり [2、3、5、6、7、8] Google
線形性 あり [1] Google
プレースメント あり [1] Google
プレーヤーの幅 あり 400,400,300 Google
プレーヤーの高さ あり 2 億 2,530 万,153 Google
開始遅延 あり 0 Google、デフォルトは 5 秒
スキップ あり 1 パブリッシャー/Google
- インタースティシャル =>Google
- インストリーム =>パブリッシャー

を許可するかどうかを決定します いずれかを選択できます
リワード広告（常にスキップ不可）
最小ビットレート いいえ Google
最大ビットレート × Google
pos あり 1 Google
デバイス
Px 比 あり 1 Google
インプレッション
安全 あり 1 Google
デフォルトは true
（adtag は常に
安全であるため）