OpenRTB 動画広告

このガイドでは、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 の購入者は動画広告枠を含むプレターゲティング設定が必要です。

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

入札リクエスト

表示

{
  id: "XIsz9QAHfAYKj3oDMQ3QOg",
  imp: [{
    id: "1",
    banner: {
      w: 300,
      h: 250,
      format:     [{
        w: 300,
        h: 250
      },{
        w: 250,
        h: 250
      }],
      battr:     [5]
    },
    video: {
      mimes:     [video/mp4],
      linearity: 1,
      protocols:     [2,3,5,6],
      w: 300,
      h: 250,
      skip: 1,
      battr:     [5],
      playbackmethod:     [6],
      plcmt: 3
    },
    displaymanager: "GOOGLE",
    tagid: "2111189154",
    bidfloor: 0.01,
    bidfloorcur: "USD",
    secure: 1,
    native: {
      request_native: {
        ver: "1.2",
        assets:       [{
          id: 1,
          required: 1,
          title: {
            len: 25
          }
        },{
          id: 2,
          data: {
            type: 2,
            len: 90
          }
        },{
          id: 3,
          data: {
            type: 12,
            len: 15
          }
        },{
          id: 4,
          data: {
            type: 1,
            len: 25
          }
        },{
          id: 5,
          img: {
            type: 3,
            wmin: 1200,
            hmin: 627
          }
        },{
          id: 6,
          img: {
            type: 2,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 7,
          img: {
            type: 1,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 8,
          data: {
            type: 3,
            len: 5
          }
        },{
          id: 9,
          video: {
            mimes:           [video/mp4]
          }
        }],
        eventtrackers:       [{
          event: 1,
          methods:         [1]
        }],
        adx_ext: {
          style_id: 188961,
          style_height: 250,
          style_width: 300
        }
      },
      ver: "1.2",
      battr:     [5]
    },
    metric:   [{
      type: "click_through_rate",
      value: 0.0006341254338622093,
      vendor: "EXCHANGE"
    },{
      type: "video_completion_rate",
      value: 0.017279919236898422,
      vendor: "EXCHANGE"
    },{
      type: "viewability",
      value: 0.7,
      vendor: "EXCHANGE"
    },{
      type: "session_depth",
      value: 1,
      vendor: "EXCHANGE"
    }],
    adx_ext: {
      billing_id:     [12345567890],
      publisher_settings_list_id:     [5509324247698256194,14109776396365339331],
      allowed_vendor_type:     [3,42,79,4463,4513,4538,4625],
      ampad: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED"
    }
  }],
  site: {
    page: "https:/example.com/school",
    publisher: {
      id: "pub-783270600012345",
      adx_ext: {
        country: "IN"
      }
    },
    content: {
      contentrating: "DV-G",
      language: "en"
    },
    mobile: 1,
    adx_ext: {
      amp: "DIALECT_HTML"
    }
  },
  device: {
    ua: "Mozilla/5.0 (iPad; CPU OS 12_1_4 like Mac OS X) FBOP/5;FBRV/0]",
    ip: "121.222.242.0",
    geo: {
      lat: -26.487831115722656,
      lon: 153.0424346923828,
      country: "AUS",
      region: "AU-QLD",
      zip: "4562",
      utcoffset: 600
    },
    make: "apple",
    model: "ipad",
    os: "iOS",
    osv: "12.1.1",
    w: 768,
    h: 1024,
    pxratio: 2,
    devicetype: 5
  },
  user: {
    id: "CAESEK6jGeddIeo_opp-WrY",
    buyeruid: "anFTbmRJMVF3VXy0",
    customdata: "anFTbmRJMVVXy0",
    data:   [{
      id: "DetectedVerticals",
      name: "DoubleClick",
      segment:     [{
        id: "1263",
        value: "0.5"
      },{
        id: "625",
        value: "0.1"
      }]
    }]
  },
  at: 2,
  tmax: 122,
  cur: [USD],
  bcat: [IAB7-39],
  adx_ext: {
    google_query_id: "ANy-zJFcyG8sUO0_hYbujPqNXbB3bPA"
  }
}

入札レスポンス

表示

{
  "id": "AB1abcDEfghijklMno2pqr",
  "seatbid": [
    {
      "seat": "Example Seat",
      "bid": [
        {
          "id": "12345678901234567890",
          "impid": "1",
          "price": 15,
          "adid": "AB1234-1234",
          "adm": "https://example.com/AdX/win?tag=AbcdEfGhIJ0kLMN2OPQ2RST3UVXyZAB2Cde114eF
          "cid": "12345678901",
          "crid": "1234",
          "adomain": [
            "www.example.com"
          ]
        }
      ]
    }
  ],
  "cur": "USD",
  "bidid": "1234567890123456789"
}

用語集

認定バイヤーの動画用語集をご覧ください。