このガイドでは、OpenRTB プロトコルを使って RTB 購入を行う際の統合要件について説明します。このガイドは、OpenRTB 統合ガイドと併せて使用してください。このガイドでは、ここで説明するフィールドについて詳しく説明しています。
<video>
タグを含む HTML スニペットを使用する iOS アプリで購入する場合は、動画タグに playsinline
属性を含める必要があります。そうしないと、クリエイティブ内で再生されるはずの動画広告が全画面表示され、ユーザー エクスペリエンスが大幅に損なわれます。これに従わない広告はブロックされます。
購入者の要件
新しい RTB 購入者は、最新のプロトコル バッファと次のセクションで説明する情報を使用して、ビッダーを開発する必要があります。プロトコルをダウンロードするには、参照データのページをご覧ください。ビッダーの開発については、リクエストを処理するとレスポンスを作成するをご覧ください。
サポートされるマクロ
インストリーム動画クリエイティブでは、以下のマクロがサポートされています。
%%CACHEBUSTER%%
%%WINNING_PRICE%%
マクロの置換は動画の URL 内では可能ですが、実際の VAST XML 内では実行できません。
認定バイヤーでは VAST ラッパーにクリック トラッカーが含まれているため、クリックマクロ(CLICK_URL_ESC
など)は必要ありません。そのため、インストリーム動画広告ではクリックマクロはサポートされていません。
サポートされているマクロについて詳しくは、レスポンスを作成するのマクロを指定するをご覧ください。
動画オブジェクトの詳細
OpenRTB プロトコルは、
openrtb-proto.txt ファイルで定義した Video
メッセージを使用して、動画リクエストを特定し、そのリクエストに関する動画固有の追加情報を提供します。
詳細な説明と例については、OpenRTB 統合ガイドの動画メッセージ フィールドのリストをご覧ください。
動画の入札リクエストのその他のフィールド
以下のシグナルはすべて動画クリエイティブに固有のものではなく、入札リクエストの主要な部分です。
IMP オブジェクト フィールド
このオブジェクトは、オークション対象の広告プレースメントまたはインプレッションを表します。
banner |
バナー オブジェクト。インプレッションがバナー広告機会として提供される場合に必要です。 |
video |
提供されるインプレッションのタイプを示します。この例では動画です。なお、インバナー動画は、imp オブジェクトに banner オブジェクトと video オブジェクトの両方が含まれている場合に許可されます。 |
tagid |
オークションの開始に使用された特定の広告プレースメントまたは広告タグの識別子。 これは、問題のデバッグや、購入者による最適化に役立ちます。 |
bidfloor |
このインプレッションの最小入札単価(CPM 単位)。 |
bidfloorcur |
含まれている billing_id. から取得される単一の通貨。 |
詳しくは、OpenRTB ガイドのインプレッション オブジェクトのセクションをご覧ください。
デバイス オブジェクトのフィールド
Device
オブジェクトのフィールドでは、ターゲット デバイスに関する情報を提供します。
ua |
ブラウザのユーザー エージェント文字列。 |
ip |
デバイスに最も近い IPv4 アドレス。 |
geo |
デバイスの位置情報。Geo オブジェクトで定義されたユーザーの現在地と想定されます。 |
devicetype |
デバイスの一般的なタイプ。 |
ifa |
平文(ハッシュ化されていないなど)での使用を認められている ID。ifa は、Roku、Apple TV、Fire TV、Xbox などのコネクテッド テレビ デバイスでサポートされています。 |
詳しくは、OpenRTB ガイドのデバイス オブジェクトのセクションをご覧ください。
サイト オブジェクト
Site
オブジェクトのフィールドは、広告をサポートするコンテンツを含むサイトに関する情報を提供します。
page |
表示回数が表示されるページの URL。 |
publisher |
サイトの Publisher オブジェクトに関する詳細。 |
content |
サイト内の Content に関する詳細。 |
詳しくは、OpenRTB ガイドの Site オブジェクトに関するセクションをご覧ください。
ユーザー オブジェクト
User
オブジェクトのフィールドは、広告をサポートするコンテンツを含むサイトに関する情報を提供します。
id |
ユーザーのエクスチェンジ固有の ID。id または buyerid の少なくとも 1 つをおすすめします。 |
data |
サイトの Publisher オブジェクトに関する詳細。 |
詳しくは、OpenRTB ガイドのユーザー オブジェクトのセクションをご覧ください。
入札リクエストの広告枠フィールド
動画の入札リクエストには、コンテンツ タイプと指定したコンパニオン広告に関する情報も含まれます。
mimes
- サポートされているコンテンツ MIME タイプの許可リスト。
companionad
- Banner オブジェクトの配列(コンパニオン広告がある場合)。
id
- レスポンスとなる入札リクエストの ID。
seatbid
- Seatbid オブジェクトの配列。入札を行う場合は 1 つ以上必要です。
seat
-
Seatbid
オブジェクト。この入札の委任者シート(広告主、代理店など)の ID。 bid
- それぞれがインプレッションに関連付けられた 1 つ以上の Bid オブジェクトの配列。
入札レスポンスのフィールド
動画の入札レスポンスの主なフィールドは次のとおりです。
プレターゲティング設定
動画広告枠を受信するには、OpenRTB の購入者は動画広告枠を含むプレターゲティング設定が必要です。
入札リクエストとレスポンスの例
入札リクエスト
入札レスポンス
用語集
認定バイヤーの動画用語集をご覧ください。