OpenRTB 视频广告

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

如果您在 iOS 应用中购买的 HTML 代码段包含 <video> 标记，则必须在视频标记中添加 playsinline 属性。否则，用户的体验会非常糟糕，原本应在广告素材内播放的视频广告似乎弹出到全屏。不符合规定的广告将被屏蔽。

买方要求

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

Supported macros

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

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

请注意，视频网址中允许替换宏，但实际 VAST XML 中不允许这样做。

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

视频对象详细信息

OpenRTB 协议使用 Video 消息（在 openrtb-proto.txt 文件中定义）来识别视频请求，并提供有关请求的其他视频特定信息。

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

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

以下信号并非视频广告所独有，但它们却是出价请求的关键部分。

展示对象字段

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

banner	横幅广告对象；如果要将展示机会作为横幅广告机会提供，则必须提供此属性。
video	指明提供的展示类型，在本例中为视频。请注意，如果 imp 对象同时包含 banner 和 video 对象，则允许使用横幅内嵌视频广告。
tagid	用于发起竞价的特定广告展示位置或广告代码的标识符。 这有助于调试任何问题或进行买方优化。
bidfloor	此展示的最低出价，以每千次展示费用表示。
bidfloorcur	一种货币，可通过随附的 billing_id. 获取

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

设备对象字段

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

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

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

网站对象

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

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

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

User 对象

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

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

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

出价请求广告资源字段

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

mimes

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

companionad

一系列 Banner 对象（如果随播广告可用）。

出价响应字段

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

id

此响应是出价请求的 ID。

seatbid

一系列 Seatbid 对象；如需进行出价，则需要一个或多个对象。

seat

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

bid

一个或多个 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"
}

术语库

请参阅 Authorized Buyers 视频术语表。