動画広告

このガイドでは、動画広告枠に入札する際に使用する統合要件、構成、関連フィールドについて説明します。

Google では、個別の広告機会またはダイナミック動画連続配信広告として表されるインストリーム動画広告、ネイティブ動画広告、インタースティシャル動画広告をサポートしています。ダイナミック連続配信広告は、連続して表示される動画広告のグループです。連続配信広告の最大再生時間が、長さの異なる 1 つ以上の動画に分割されます。これらのフォーマットの詳細については、ネイティブ広告フォーマットとインタースティシャル広告フォーマットのガイドをご覧ください。

購入者の要件

RTB プロトコル

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

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

広告の審査

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

プレターゲティング設定

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

マクロ

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

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

認定バイヤーでは VAST ラッパーにクリック トラッカーが含まれているため、CLICK_URL_ESC などのクリックマクロはサポートされていません。サポートされているマクロの詳細については、マクロを指定するをご覧ください。

コールアウトの詳細

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

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

動画コンテンツを説明するページの URL(パラメータは削除されています)。 ニュース メディアはこの 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

動的動画連続配信広告に配信される広告の最大数。poddur が設定されているが、maxseq が未設定または 0 の場合、動画連続配信広告に配信できる広告の数に制限はありません。Google は動的連続配信広告のみをサポートしています。

実際に表示される動画広告の数は、この値以下になります。

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.imp.video.durfloors、BidRequest.imp.audio.durfloors

DurFloors オブジェクトの配列。購入者が入札する可能性のあるさまざまな再生時間の動画クリエイティブまたはオーディオ クリエイティブのそれぞれの最小価格を示します。

Google が指定した durfloors の例を次に示します。

  1. $5 で (0, 16) 秒を表す {"maxdur": 16, "bidfloor": 5}。
  2. {"mindur": 16, "maxdur": 31, "bidfloor": 10} は、$10 での [16, 31) 秒を表します。
  3. $20 で [31, inf) 秒を表す {"mindur": 31, "bidfloor": 20}。

これらのシグナルは動画クリエイティブに固有のものではありませんが、ビッダーが読み取るうえで特に価値があります。

BidRequest.device.ifa
このフィールドは、SSL を使用する場合にのみ設定される 36 文字の UUID で、ハッシュ化されません。これは、BidRequest.device.dpidm5 の暗号化されていないバージョンです。iOS デバイスの場合、広告主向け識別子(IDFA)がすべて大文字で含まれます。Android デバイスの場合、すべて小文字の Android 識別子(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」や「ipad」などの一般的なモデルが指定されます。
BidRequest.imp.metric
Metric.type が completion_rate に設定されている場合、Metric.value は [0.0, 1.0] の範囲の小数で、広告スロットに配信された動画広告の過去の完全再生率を表します。デフォルト値の -1.0 は、過去の完了率データが利用できないことを示します。
BidRequest.imp.video.poddur
動的動画連続配信広告で埋めることができる時間(秒)。 このフィールドは、ミッドロール挿入点全体の長さを表します。設定されていない場合、広告スロットは連続配信広告の一部ではありません。

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

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

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 リダイレクト URL、または BidResponse.seatbid.bid.adm フィールドの VAST XML を返す必要があります。入札レスポンスには、動画広告の適切な宣言も含める必要があります。適切な動画入札レスポンスの抜粋を次に示します。

id: "eW3q768m3k93fv93a80tGQ"
seatbid {
  bid {
    id: "0uMc95E6ClImM3p5FSe"
    impid: "1"
    price: 0.034745
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_168019"
    cat: "7"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 61170857882
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 30
}

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

BidResponse.seatbid.bid.ext.attribute
このスニペットから表示される可能性のある広告の属性。ID のリストについては、buyer-declarable-creative-attributes.txt ファイルをご覧ください。これらの属性が、入札リクエストでパブリッシャーによって不許可とされた属性と一致しないことを確認します。 たとえば、いずれかのフィールドに 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 の場合もあります。

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

スキップ可能補正

Google は、動画広告枠のリアルタイム ビッダー入札にスキップ可能補正を自動的に適用します。これにより、入札リクエストでリクエストされたスキップ可能性と、入札レスポンスで返されるクリエイティブのスキップ可能性の違いにより、入札がオークションから除外されるのを防ぐことができます。スキップ可能補正は、次の場合には適用されません。

  • 入札レスポンスで指定したクリエイティブは、VPAID を使用して実装されています。VPAID を使用して実装されている動画クリエイティブは、Real-time Bidding API の Creative.video.videoMetadata.isVpaid フィールドで確認できます。
  • パブリッシャーがクリエイティブをレンダリングします。これは、BidRequest.imp.displaymanager フィールドに基づいて判断できます。パブリッシャーがクリエイティブをレンダリングする場合は、'PUBLISHER' になります。

スキップ可能補正が適用される仕組みの例を以下に示します。

  • シナリオ 1:
    • JSON 形式の場合は BidRequest.imp.video.skip フィールドが 0 に設定され、Protobuf 形式の場合は false に設定された入札リクエストを受け取ります。
    • スキップ可能なクリエイティブで入札します。
    • 結果: 入札単価がオークションにかけられます。入札が落札され、動画クリエイティブがレンダリングされると、スキップ不可としてレンダリングされます。
  • シナリオ 2:
    • JSON 形式の場合は BidRequest.imp.video.skip フィールドが 1 に設定され、Protobuf 形式の場合は true に設定された入札リクエストを受け取ります。
    • BidRequest.imp.video.skipmin フィールドで指定された再生時間よりも長い再生時間のスキップ不可のクリエイティブで入札した場合。
    • 結果: 入札単価がオークションにかけられます。入札が落札され、動画クリエイティブがレンダリングされると、スキップ可能としてレンダリングされます。

動画フォーマット

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

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

ウェブ

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

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


ネイティブ

ネイティブ オブジェクトが存在し、


インバナー

動画オブジェクトが存在しない &
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


ネイティブ

ネイティブ オブジェクトが存在し、


インタースティシャル(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 ページ以降)をご覧ください。

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

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

mApp

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

インストリーム以外 mApp Interstitial

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

Native

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

Rewarded

rwdd: bool

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
オブジェクト
フィールド 認定バイヤー
/ エクスチェンジ
入札
インストリーム以外
サンプル値 誰が決定するのですか?
/この値の取得元
オブジェクト
動画 マイム はい ["application/javascript",
"video/mp4"]",
Google
minduration × パブリッシャーが設定
maxduration はい パブリッシャーが設定
playbackmet
hod
はい [6] 通常はパブリッシャー
構成済み
api(MRAID) はい [1,2] Google
プロトコル はい [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
デバイス
ピクセル比 はい 1 Google
インプレッション
安全 はい 1 Google
デフォルトは true
adtag は常に
安全であるため