Quảng cáo dạng video OpenRTB

Hướng dẫn này trình bày các yêu cầu tích hợp để mua RTB bằng giao thức OpenRTB. Bạn nên sử dụng hướng dẫn này cùng với hướng dẫn Tích hợp OpenRTB, trong đó mô tả chi tiết các trường đã thảo luận ở đây.

Nếu mua nội dung trên ứng dụng dành cho iOS có đoạn mã HTML chứa thẻ <video>, thì bạn phải thêm thuộc tính playsinline vào thẻ video này. Nếu không, người dùng sẽ có trải nghiệm rất kém, trong đó quảng cáo dạng video lẽ ra phải phát trong mẫu quảng cáo lại bật ra toàn màn hình. Những quảng cáo không tuân thủ điều này sẽ bị chặn.

Yêu cầu đối với người mua

Người mua RTB mới nên phát triển bên đặt giá thầu của họ bằng cách sử dụng vùng đệm giao thức mới nhất và thông tin được nêu trong các phần sau. Để tải giao thức xuống, hãy xem trang dữ liệu tham chiếu. Để biết thông tin về cách phát triển một bên đặt giá thầu, hãy xem Xử lý yêu cầu và Tạo phản hồi.

Macro được hỗ trợ

Các macro sau được hỗ trợ trên mẫu quảng cáo dạng video trong luồng phát:

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

Lưu ý rằng bạn được phép thay thế macro trong URL video nhưng không được phép trong XML VAST thực tế.

Bạn không cần các macro nhấp chuột (chẳng hạn như CLICK_URL_ESC) vì Authorized Buyers đưa trình theo dõi lượt nhấp vào một trình bao bọc VAST. Do đó, macro nhấp chuột không được hỗ trợ cho quảng cáo video trong luồng. Để biết thêm thông tin về các macro được hỗ trợ, hãy xem phần Chỉ định macro trong phần Tạo phản hồi.

Thông tin chi tiết về đối tượng video

Giao thức OpenRTB sử dụng thông báo Video, được xác định trong tệp openrtb-proto.txt để xác định các yêu cầu video và để cung cấp thêm thông tin cụ thể của video về yêu cầu.

Hãy xem danh sách các trường tin nhắn video trong hướng dẫn Tích hợp OpenRTB để biết nội dung mô tả và ví dụ chi tiết.

Các trường yêu cầu giá thầu video khác

Các tín hiệu bên dưới không phải là tất cả các tín hiệu dành riêng cho mẫu quảng cáo video, nhưng là những phần quan trọng của yêu cầu giá thầu.

Trường đối tượng Imp

Đối tượng này mô tả một vị trí đặt quảng cáo hoặc lượt hiển thị đang được đấu giá.

banner	Đối tượng Biểu ngữ; bắt buộc nếu lượt hiển thị được cung cấp dưới dạng cơ hội của quảng cáo biểu ngữ.
video	Cho biết loại lượt hiển thị được cung cấp, trong trường hợp này là video. Xin lưu ý rằng bạn được phép sử dụng video trong biểu ngữ nếu đối tượng imp bao gồm cả đối tượng banner và video.
tagid	Giá trị nhận dạng của vị trí đặt quảng cáo hoặc thẻ quảng cáo cụ thể đã được dùng để bắt đầu phiên đấu giá. Việc này có thể hữu ích khi gỡ lỗi mọi sự cố hoặc giúp người mua tối ưu hoá.
bidfloor	Giá thầu tối thiểu cho hiển thị này được thể hiện bằng CPM.
bidfloorcur	Một đơn vị tiền tệ duy nhất, lấy từ billing_id. đi kèm

Xem phần Đối tượng Imp trong hướng dẫn OpenRTB để biết thêm chi tiết.

Trường đối tượng thiết bị

Các trường trong đối tượng Device cung cấp thông tin về thiết bị mục tiêu.

ua	Chuỗi tác nhân người dùng của trình duyệt.
ip	Địa chỉ IPv4 gần thiết bị nhất.
geo	Vị trí của thiết bị được giả định là vị trí hiện tại của người dùng do đối tượng Geo xác định.
devicetype	Loại thiết bị chung.
ifa	Giấy tờ tuỳ thân bị chấp nhận do nhà quảng cáo sử dụng ở dạng dữ liệu rõ ràng (ví dụ: không được băm). ifa được hỗ trợ cho các thiết bị TV đã kết nối như Roku, Apple TV, Fire TV, Xbox.

Xem phần Đối tượng thiết bị trong hướng dẫn OpenRTB để biết thêm chi tiết.

Đối tượng trang web

Các trường trong đối tượng Site cung cấp thông tin về trang web có nội dung được quảng cáo hỗ trợ.

page	URL của trang sẽ hiển thị lượt hiển thị.
publisher	Thông tin chi tiết về đối tượng Publisher của trang web.
content	Thông tin chi tiết về Content trong trang web.

Xem phần đối tượng Trang web trong hướng dẫn OpenRTB để biết thêm chi tiết.

Đối tượng người dùng

Các trường trong đối tượng User cung cấp thông tin về trang web có nội dung được quảng cáo hỗ trợ.

id	Mã nhận dạng riêng của Exchange cho người dùng. Bạn nên cung cấp ít nhất một trong số id hoặc buyerid.
data	Thông tin chi tiết về đối tượng Publisher của trang web.

Xem phần Đối tượng người dùng trong hướng dẫn OpenRTB để biết thêm thông tin chi tiết.

Trường khoảng không quảng cáo yêu cầu giá thầu

Yêu cầu giá thầu video cũng chứa thông tin về các loại nội dung và mọi quảng cáo đồng hành cụ thể.

mimes

Danh sách cho phép các loại MIME nội dung được hỗ trợ.

companionad

Mảng các đối tượng Biểu ngữ nếu có quảng cáo đồng hành.

Trường phản hồi giá thầu

Các trường chính trong phản hồi giá thầu video bao gồm:

id

Mã của yêu cầu giá thầu mà phản hồi này là phản hồi.

seatbid

Loạt đối tượng Seatbid; một hoặc nhiều đối tượng bắt buộc nếu muốn đặt giá thầu.

seat

Đối tượng Seatbid; mã người mua (ví dụ: nhà quảng cáo, đại lý) mà giá thầu này được thực hiện thay mặt.

bid

Mảng gồm một hoặc nhiều đối tượng Giá thầu, mỗi đối tượng liên quan đến một lượt hiển thị.

Nhắm mục tiêu trước

Để nhận khoảng không quảng cáo video, người mua OpenRTB phải có cấu hình nhắm mục tiêu trước bao gồm khoảng không quảng cáo video.

Ví dụ về yêu cầu giá thầu và phản hồi

Yêu cầu giá thầu

Cho tôi xem

{
  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ản hồi giá thầu

Cho tôi xem

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

Bảng thuật ngữ

Xem Bảng thuật ngữ video trong Authorized Buyers.