このガイドでは、動画広告枠に入札する際に使用する統合要件、構成、関連フィールドについて説明します。
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.skiptrueの場合、プレーヤーで動画のスキップが許可されるか、スキップ可能な広告が許可されることを示します。それ以外の場合は、スキップ可能な広告が許可されていないことを示します。BidRequest.imp.video.startdelay-
値 0 はプレロール、-1 はミッドロール、-2 はポストロールを意味します。
その他の正の値は、動画の開始から広告が表示されるまでの秒数です。
BidRequest.imp.video.durfloors、BidRequest.imp.audio.durfloors-
DurFloorsオブジェクトの配列。購入者が入札する可能性のあるさまざまな再生時間の動画クリエイティブまたはオーディオ クリエイティブのそれぞれの最小価格を示します。Google が指定した
durfloorsの例を次に示します。$5で(0, 16)秒を表す{"maxdur": 16, "bidfloor": 5}。{"mindur": 16, "maxdur": 31, "bidfloor": 10}は、$10での[16, 31)秒を表します。$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- デバイスのタイプを指定します。
MOBILEHIGHEND_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フィールドで指定された再生時間よりも長い再生時間のスキップ不可のクリエイティブで入札した場合。 - 結果: 入札単価がオークションにかけられます。入札が落札され、動画クリエイティブがレンダリングされると、スキップ可能としてレンダリングされます。
動画フォーマット
- 購入者が動画を含める方法
- すべての動画フォーマットで推奨される OpenRTB シグナル
- すべての動画フォーマットで推奨される認定バイヤーの proto シグナル
- パブリッシャーが動画を許可 / 拒否する方法
- エッジケース
購入者が動画を含める方法
次の表は、購入者がクリエイティブに動画を含める方法と、ウェブとモバイルアプリでそれぞれ配信できるプレースメントを示しています。
ウェブ
| 動画クリエイティブ | インストリーム(すべて) | インフィード / 記事内 | ネイティブ インフィード / 記事内 | インタースティシャル | インバナー |
|---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
カスタム JS |
|
||||
ネイティブ + VAST |
|
モバイルアプリ
| 動画クリエイティブ | インストリーム(すべて) | インフィード / 記事内 | ネイティブ インフィード / 記事内 | インタースティシャル | インバナー |
|---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
カスタム JS |
|||||
ネイティブ + VAST |
| 凡例: | フォーマット / 技術が利用できない | このプレースメントで動画クリエイティブが承認されました(パブリッシャーによるブロックの対象) |
このプレースメントでは動画クリエイティブを使用できません |
|---|
OpenRTB の推奨シグナル
次の表は、パソコンとモバイルウェブ、モバイルアプリのすべての動画フォーマットで推奨される OpenRTB シグナルを示しています。
PC ウェブとモバイルウェブ
| 動画フォーマット | 推奨シグナル(動画関連のシグナルのみ) | 関連するシグナル(動画に関連するシグナルのみ) |
|---|---|---|
インストリーム(VPAID) |
VIDEO オブジェクトが存在する & |
|
インストリーム(VPAID なし) |
VIDEO オブジェクトが存在する & |
|
インストリーム以外 |
VIDEO オブジェクトが存在する
|
|
インフィード |
VIDEO オブジェクトが存在する & |
|
記事内 |
VIDEO オブジェクトが存在する & |
|
ネイティブ |
ネイティブ オブジェクトが存在し、 |
|
インバナー |
動画オブジェクトが存在しない & |
モバイルアプリ
| 動画フォーマット | 入札リクエストの詳細(動画に関連する詳細のみ) | |
|---|---|---|
インストリーム |
VIDEO オブジェクトが存在する & |
|
インストリーム以外 |
VIDEO オブジェクトが存在する
|
|
インフィード |
VIDEO オブジェクトが存在する & |
|
記事内 |
VIDEO オブジェクトが存在する & |
|
ネイティブ |
ネイティブ オブジェクトが存在し、 |
|
インタースティシャル(VAST) |
VIDEO オブジェクトが存在する & |
|
インタースティシャル(VAST なし) |
VIDEO オブジェクトが存在する & |
フィルタ適用 |
インバナー(MRAID) |
動画オブジェクトが存在しない & |
|
インバナー (MRAID なし) |
動画オブジェクトが存在しない & |
パブリッシャーが動画を許可 / 拒否する方法
次の表は、パブリッシャーがプレースメントで動画を許可または不許可にする方法を示しています。
| パブリッシャー オプション | 適用可能なフォーマット | 入札リクエストでの記述 |
|---|---|---|
インストリーム動画の単位を指定する |
インストリーム(すべて) |
動画オブジェクトが存在する & |
VPAID を有効にする |
インストリーム ウェブ |
動画オブジェクトが存在する & |
IBV にオプトインする |
インバナー インタースティシャル |
|
オプトインする(手順) |
インフィード 記事内 |
動画オブジェクトが存在する & |
インストリーム以外を有効にする(手順) |
ネイティブ |
ネイティブ オブジェクトが存在する |
動画インタースティシャルをブロック |
インタースティシャル アプリ |
VIDEO オブジェクトが存在しない |
エッジケース
| # | ケースの説明 | コメント | 入札リクエスト |
|---|---|---|---|
1 |
MRAID を使用した遅延カスタムクローズ |
インタースティシャルでは、カスタムの閉じるボタンを使用していなくても、広告を閉じると MRAID を使用して購入者に通知が送信されることがあります。 認定バイヤーの適用 X は、カスタムの閉じるボタンの上に常に表示されます。カスタムの閉じるボタンが 5 秒後に下に表示される場合でも同様です。 |
用語集
認定バイヤーの動画用語集をご覧ください。
インストリーム フォーマットとインストリーム以外のフォーマットに関連するフィールド
OpenRTB 2.5(47 ページ以降)をご覧ください。
| BidRequest.Video. | |||||
|---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
インプレッションがリニア、ノンリニアなどである必要があるかどうかを示します。何も指定されていない場合は、すべてが許可されていると見なされます。
|
||||
videoad_start_delay
|
|
||||
入札リクエストの値のソース
| OpenRTB オブジェクト |
フィールド | 認定バイヤー / エクスチェンジ 入札 インストリーム以外 |
サンプル値 | 誰が決定するのですか? /この値の取得元 |
|---|---|---|---|---|
| オブジェクト | ||||
| 動画 | マイム | はい | ["application/javascript", "video/mp4"]", |
|
| minduration | × | パブリッシャーが設定 | ||
| maxduration | はい | パブリッシャーが設定 | ||
| playbackmet hod |
はい | [6] | 通常はパブリッシャー 構成済み |
|
| api(MRAID) | はい | [1,2] | ||
| プロトコル | はい | [2,3,5,6,7,8] | ||
| リニアリティ | はい | [1] | ||
| プレースメント | はい | [1] | ||
| プレーヤーの幅 | はい | 400,400,300 | ||
| プレーヤーの高さ | はい | 225,300,153 | ||
| 開始遅延 | はい | 0 | Google、デフォルト 5 秒 | |
| スキップ | はい | 1 | パブリッシャー / Google - インタースティシャルの場合 => Google - インストリームの場合 => パブリッシャー スキップ可能、スキップ不可、またはその両方を許可するかどうかを決定します。 リワード広告(常にスキップ不可) |
|
| 最小ビットレート | いいえ | |||
| 最大ビットレート | × | |||
| pos | はい | 1 | ||
| デバイス | ||||
| ピクセル比 | はい | 1 | ||
| インプレッション | ||||
| 安全 | はい | 1 | Google デフォルトは true adtag は常に 安全であるため |