動画広告

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

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

購入者の要件

RTB プロトコル

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

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

クリエイティブの審査

クリエイティブを使用して入札する前に、クリエイティブを承認のために送信することをおすすめします。リアルタイム ビッダー API のクリエイティブ リソースを使用して、審査プロセスを開始できます。

プレターゲティング設定

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

マクロ

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

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

Authorized Buyers ではクリック トラッカーが 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 は動的 Pod のみをサポートしています。

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

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. $10 での [16, 31) 秒を表す {"mindur": 16, "maxdur": 31, "bidfloor": 10}。
  3. $20 で [31, inf) 秒を表す {"mindur": 31, "bidfloor": 20}。

これらのシグナルは動画クリエイティブに固有のものではありませんが、入札者が読み取るうえで特に重要です。

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」や「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 バージョンを記述します。 VAST_2_0、VAST_3_0、VAST_2_0_WRAPPER、VAST_3_0_WRAPPER、VAST_4_0、VAST_4_0_WRAPPER などを含む Protocol 列挙型値の配列が含まれます。
BidRequest.imp.video.companionad
このフィールドには、コンパニオン広告が利用可能な場合に、コンパニオン広告を表す Banner オブジェクトの配列が含まれます。
BidRequest.site.page

動画再生ページの URL、または動画が埋め込まれているページの URL。次に例を示します。

http://www.publisher.com/watchpagelink

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

id: "n40G42d551UX18627ao8lt"
seatbid {
  bid {
    id: "17u6BnD62h88r5q7066"
    impid: "1"
    price: 0.797848
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_987914"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 55383762512
      skadn {
        version: "4.0"
        network: "306el65O"
        itunesitem: "832461214"
        sourceapp: "977150768"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
        }
        sourceidentifier: "8396"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 20
}

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

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 である場合もあります。

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

動画フォーマット

購入者が動画を追加する方法

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

ウェブ

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

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 ページから）を参照してください。

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
オブジェクト		 フィールド 認定バイヤー
/エクスチェンジ
入札
インストリーム以外		 サンプル値 誰が決定しますか？
/この値の導出元
はどこですか？
オブジェクト
動画 mimes はい ["application/javascript",
"video/mp4"]",		 Google
minduration × Publisher Configured
maxduration はい Publisher Configured
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
デバイス
Px 比率 はい 1 Google
インプレッション
安全 はい 1 Google
は、adtag が常に
安全であるため、デフォルトで true
になります