OpenRTB 影片廣告

本指南說明使用 OpenRTB 通訊協定購買即時出價的整合規定。本指南應搭配 OpenRTB 整合指南使用，其中討論的欄位會詳細說明。

如果您透過含有 <video> 標記的 HTML 程式碼片段購買 iOS 應用程式，就必須在影片標記中加入 playsinline 屬性。否則，原本應以全螢幕播放的影片廣告原本預期會播放的影片廣告，導致使用者體驗不佳。凡是違反這項政策的廣告都會遭到封鎖。

買方相關規定

新的即時出價買方應使用最新的通訊協定緩衝區及下列各節所述資訊，開發出價工具。如要下載通訊協定，請參閱參考資料頁面。如要瞭解如何開發出價工具，請參閱「處理要求」和「建立回應」。

支援的巨集

串流內影片廣告素材支援下列巨集：

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

請注意，系統允許在影片網址中替換巨集，但在實際的 VAST XML 中則無法。

由於 Authorized Buyers 已將點擊追蹤程式納入 VAST 包裝函式中，因此不需要 Click 巨集 (例如 CLICK_URL_ESC)。因此，串流內影片廣告不支援 Click 巨集。 如要進一步瞭解支援的巨集，請參閱「建立回應」底下的「指定巨集」。

影片物件詳細資料

OpenRTB 通訊協定會使用 openrtb-proto.txt 檔案中定義的 Video 訊息，識別影片要求，並提供請求的其他影片專屬資訊。

如需詳細說明和範例，請參閱 OpenRTB 整合指南中的影片訊息欄位清單。

其他影片出價要求欄位

下列信號並非影片廣告素材專屬，而是出價要求的重要部分。

Imp 物件欄位

此物件說明正在進行競價的廣告刊登位置或曝光。

banner	橫幅物件；如果曝光是橫幅廣告商機，則為必要元素。
video	指出提供的曝光類型，在本範例中為影片。請注意，如果 imp 物件同時包含 banner 和 video 物件，就可以使用橫幅廣告內嵌影片。
tagid	啟動競價的特定廣告刊登位置或廣告代碼 ID。 這項功能可協助您偵錯任何問題，或希望買方進行最佳化。
bidfloor	這次曝光的最低千次曝光出價 (以千次曝光出價表示)。
bidfloorcur	單一貨幣，從隨附的 billing_id. 取得

詳情請參閱 OpenRTB 指南中的 Imp object 一節。

裝置物件欄位

Device 物件中的欄位提供指定裝置的相關資訊。

ua	瀏覽器使用者代理程式字串。
ip	最靠近裝置的 IPv4 位址。
geo	系統會假設裝置位置是由 Geo 物件定義的使用者目前位置。
devicetype	一般裝置類型。
ifa	完整且僅供廣告客戶使用的 ID (例如未經雜湊處理)。ifa 支援連網電視裝置，例如 Roku、Apple TV、Fire TV、Xbox。

詳情請參閱 OpenRTB 指南中的裝置物件一節。

網站物件

Site 物件中的欄位會針對含有廣告贊助內容的網站提供相關資訊。

page	廣告所在網頁的網址。
publisher	網站的 Publisher 物件詳細資料。
content	網站中 Content 的詳細資料。

詳情請參閱 OpenRTB 指南中的 Site 物件一節。

使用者物件

User 物件中的欄位會針對含有廣告贊助內容的網站提供相關資訊。

id	使用者的廣告交易平台專屬 ID。建議至少使用 id 或 buyerid 其中之一。
data	網站的 Publisher 物件詳細資料。

詳情請參閱 OpenRTB 指南中的使用者物件一節。

出價要求廣告空間欄位

影片出價要求也包含內容類型和任何指定隨播廣告的相關資訊。

mimes

支援 MIME 類型的內容許可清單。

companionad

可用的隨播廣告時，橫幅物件陣列。

出價回應欄位

影片出價回應中的主要欄位包括：

id

做為回應的出價要求 ID。

seatbid

Seatbid 物件陣列；如果要出價，就必須提供一或多個物件。

seat

Seatbid 物件；代表此出價的買方座位 ID (例如廣告客戶、代理商)。

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 影片詞彙一文。