OpenRTB 视频广告

本指南概述了实时出价购买的集成要求 使用 OpenRTB 协议本指南应与 OpenRTB 集成指南 其中详细介绍了此处讨论的字段。

如果您在 iOS 应用中购买了包含 <video> 代码的 HTML 代码段， 必须在视频代码中添加 playsinline 属性。否则，用户会非常 本应播放的视频广告弹出显示 全屏。不遵守此政策的广告将会被屏蔽。

买方要求

新的实时出价买方应使用最新的协议缓冲区开发出价工具 以及下文所述信息。 如需下载协议，请参阅 参考数据页面。 如需了解如何开发出价工具 请参阅处理请求 和构建响应。

支持的宏

插播视频广告素材支持以下宏：

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

请注意，视频网址中允许替换宏，但不允许 实际的 VAST XML 内

Click 宏（例如 CLICK_URL_ESC）不是必需的 因为 Authorized Buyers 将点击跟踪广告代码包含在 VAST 封装容器中。 因此，插播视频广告不支持 Click 宏。 如需详细了解支持的宏 请参阅指定宏 在 Build the Response（构建响应）下方，

视频对象详情

OpenRTB 协议使用 Video 消息，该消息在 <ph type="x-smartling-placeholder"></ph> openrtb-proto.txt 文件来识别视频请求 并提供有关相应请求的其他视频专用信息。

请参阅视频消息字段列表 请查看 OpenRTB 集成指南，了解详细说明和示例。

其他视频广告出价请求字段

以下信号并非全部视频广告素材都独有， 但同时也是出价请求的关键部分

展示对象字段

此对象描述正在竞价的广告展示位置或展示。

banner	Banner 对象；如果相应展示是作为横幅广告机会提供的，则该字段为必需字段。
video	用于表示提供的展示类型，本例中为视频。请注意，横幅内嵌广告 如果 imp 对象同时包含 banner 和 video 对象。
tagid	用于发起竞价的特定广告展示位置或广告代码的标识符。 这对于调试任何问题或买方进行优化都很有用。
bidfloor	此展示的最低出价（以每千次展示费用表示）。
bidfloorcur	一种货币，从包含的 billing_id. 获取

如需了解更多详情，请参阅 OpenRTB 指南中的展示对象部分。

设备对象字段

Device 对象中的字段提供有关目标设备的信息。

ua	浏览器用户代理字符串。
ip	离设备最近的 IPv4 地址。
geo	假定设备的位置是由 Geo 对象定义的用户的当前位置。
devicetype	设备的常规类型。
ifa	明文准许广告客户使用的 ID（例如，未经过哈希处理）。ifa适用于联网电视设备，例如 Roku、Apple TV、Fire TV、Xbox。

如需了解更多详情，请参阅 OpenRTB 指南中的设备对象部分。

Site 对象

Site 对象中的字段提供了有关含广告内容的网站的信息。

page	将显示广告的网页的网址。
publisher	网站的 Publisher 对象的详细信息。
content	网站中有关Content的详细信息。

有关更多详情，请参阅 OpenRTB 指南中的 Site 对象部分。

User 对象

User 对象中的字段提供了有关含广告内容的网站的信息。

id	用户的广告交易平台特定 ID。建议至少使用 id 和 buyerid 中的一个。
data	网站的 Publisher 对象的详细信息。

请参阅用户对象部分 。

出价请求广告资源字段

视频广告出价请求还包含内容类型的相关信息 以及任何指定的随播广告

mimes

支持的内容 MIME 类型的许可名单。

companionad

一组 Banner 对象（如果有随播广告）。

出价响应字段

视频广告出价响应中的关键字段包括：

id

作为响应的出价请求的 ID。

seatbid

Seatbid 对象的数组；如果要进行出价，则该字段为一个或多个必需字段。

seat

一个 Seatbid 对象；买方参与此出价时所代表的买方（例如广告客户、代理机构）的 ID。

bid

由一个或多个 Bid 对象组成的数组，其中每个对象都与展示相关。

预定位

要接收视频广告资源，OpenRTB 买方必须拥有 预定位配置 包含视频广告资源的广告资源

出价请求和响应示例

出价请求

<ph type="x-smartling-placeholder">

</ph> 点击查看

{
  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"
  }
}

出价响应

<ph type="x-smartling-placeholder">

</ph> 点击查看

{
  "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"
}

术语库

请参阅 Authorized Buyers 视频术语表。