Google RTB プロトコルの動画広告

動画広告のサポート開始により 認定バイヤーを通じて動画広告枠を購入できます。 このドキュメントでは、RTB を利用した購入の統合要件について概説します。 認定バイヤーのプロトコルを使用して 使用可能なプロトコルについては、 プロトコルを選択 セクションをご覧ください。

購入者はプレースメント全体で動画広告枠を購入できます。 3 種類あります <ph type="x-smartling-placeholder"></ph>をご覧ください。 インタースティシャル広告をご覧ください。

購入者の要件

新規の RTB 購入者は、最新のプロトコル バッファを使用してビッダーを開発する必要があります 以下のセクションに記載されている情報をご覧ください。 プロトコルをダウンロードするには、リアルタイム ビッダーのリファレンス データのページをご覧ください。 ビッダーの作成について詳しくは リクエストの処理をご覧ください。 およびレスポンスの作成をご覧ください。

サポートされるマクロ

インストリーム動画クリエイティブでは、次のマクロがサポートされています。

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

クリックマクロ（CLICK_URL_ESC など）は不要です これは、認定バイヤーの VAST ラッパーにクリック トラッカーが含まれるためです。 そのため、クリックマクロはインストリーム動画広告ではサポートされていません。 サポートされているマクロについて詳しくは マクロを指定するを参照 （Build the Response）かを確認します。

コールアウトの詳細

リアルタイム ビッダー プロトコルでは、 <ph type="x-smartling-placeholder"></ph> Real-time-bidding-proto.txt ファイルを使用して、動画リクエストを特定します。 リクエストに関する動画固有の追加情報を入力できます。

ネストされた動画メッセージの次のフィールド リスト 詳細な説明と例も記載しています。

description_url

パラメータを削除した URL 動画コンテンツの説明ページ内の ID です。 ニュース メディアはこの 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）が含まれます。 コネクテッド テレビ デバイスの場合、一意の ID が含まれます。 （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
許可されたベンダー。詳しくは、 vendors.txt ファイルを参照してください。 たとえば、309 は キャンペーン マネージャー 動画ユニットです。
allowed_video_formats
許可される動画技術についての説明 リクエストに対するレスポンスで配信された広告に対する課金額です。 レスポンスでは、これらのうちの少なくとも 1 つがサポートされている必要があります。 この繰り返しフィールドの値は、列挙型 VideoFormat から取得されます。
VIDEO_FLASH Flash Video（FLV）形式を使用する動画を許可。
VIDEO_HTML5 HTML5 動画形式を使用する動画を許可します。
VPAID_FLASH 動画プレーヤーによる広告配信を使用する動画を許可する インターフェース定義（VPAID）の Flash 動画形式。
VPAID_JS 次を使った動画を許可する: VPAID JavaScript 動画形式。
companion_slot
このフィールドは、CompanionSlot メッセージを表します。 次のフィールドがあります。
height このスロットで利用可能な高さ。
width このスロットで使用可能な幅。
CreativeFormat クリエイティブ フォーマットは、配信可能なフォーマットを表します。 このコンパニオン スロットのクリエイティブの
url

動画再生ページの URL またはそのページの URL 動画を埋め込む場合もあります。例:

    http://www.publisher.com/watchpagelink

動画リクエストに応答する際 ビッダーから VAST リダイレクト URL が返されます video_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
このスニペットから表示できる広告のすべての属性。詳しくは、 <ph type="x-smartling-placeholder"></ph> 購入者の宣言可能な-creative-attributes.txt ファイルをご参照ください。 これらの属性がいずれも 入札リクエストの 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 購入者は プレターゲティング設定 動画広告枠もこれに含まれます

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

AdX 動画フォーマット

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

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

ウェブ

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

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

カスタム JS

 

ネイティブ + VAST

 

モバイルアプリ

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

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

カスタム JS

ネイティブ + VAST

凡例: 利用できる形式または技術がない

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

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

OpenRTB 推奨シグナル

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

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 ウェブとモバイルウェブ、モバイルアプリの 3 つのカテゴリに分類できます。

パソコンとモバイルウェブ

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

インストリーム（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

ネイティブ

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

Allowed_ad_types = NATIVE

インバナー

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

Allowed_ad_types = BANNER

モバイルアプリ

次の表は、すべての動画フォーマットで推奨される AdX プロトコルのシグナルを示した PC ウェブとモバイルウェブ、モバイルアプリの 3 つのカテゴリに分類できます。

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

インストリーム

動画メッセージがあります
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

ネイティブ

ネイティブ メッセージの表示、
ネイティブ メッセージ内の 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 Proto。

OpenRTB

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

インストリーム動画ユニットを指定する

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

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

AdX プロトコル

パブ オプション 適用可能な形式 入札リクエストでは次のように記述されます（注: これらは 推奨シグナルについては、以下の表を参照） デフォルト設定

インストリーム動画ユニットを指定する

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

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

なし

VPAID を有効にする

インストリーム ウェブ

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

excluded_attribute ≠ 30 InstreamVastVideoType: Vpaid

受け取らない

IBV を有効にする

インバナー

インタースティシャル

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

受け取らない

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

インフィード

記事内

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

受け取らない

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

ネイティブ

NATIVE メッセージと

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

受け取らない

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

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

動画メッセージがありません、
excluded_attribute = 30 InstreamVastVideoType: Vpaid

受け取る

エッジケース

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

1

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

インタースティシャルの場合は、広告を閉じると MRAID を使用して購入者に通知が送信されます。 すべてのアセットが表示されます


AdX で適用された「X」は、カスタムの「閉じる」があったとしても、常に 5 秒後に下部に表示されます

用語集

<ph type="x-smartling-placeholder"></ph>をご覧ください。 認定バイヤーの動画用語集をご覧ください。

インストリームおよびアウトストリーム フォーマットの 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 プロトコル

<ph type="x-smartling-placeholder"></ph>をご覧ください。 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
/エクスチェンジ（
） 入札
アウトストリーム		 サンプル値 誰が決定するのですか？
/この値の
の導出元 どこから？
オブジェクト
動画 マイム あり [&quot;application/javascript&quot;,
"video/mp4"]",		 Google
最小時間 × パブリッシャーによる設定
最長時間 あり パブリッシャーによる設定
再生メット
ホッド		 あり [6] 通常はニュース メディア
構成済み
API（MRAID） あり [1、2]。 Google
プロトコル あり [2、3、5、6、7、8] Google
線形性 あり [1] Google
プレースメント あり [1] Google
プレーヤーの幅 あり 40,040,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 は常に
であるため 安全