Iklan Video OpenRTB

Panduan ini menguraikan persyaratan integrasi untuk pembelian RTB menggunakan protokol OpenRTB. Panduan ini harus digunakan bersama dengan panduan Integrasi OpenRTB yang menjelaskan kolom yang dibahas di sini secara mendetail.

Jika membeli di aplikasi iOS dengan cuplikan HTML yang menyertakan tag <video>, Anda harus menyertakan atribut playsinline di tag video. Jika tidak, pengguna akan mengalami pengalaman yang sangat buruk, ketika iklan video yang seharusnya diputar dalam materi iklan tampak muncul dalam layar penuh. Iklan yang tidak mematuhi persyaratan ini akan diblokir.

Persyaratan pembeli

Pembeli RTB baru harus mengembangkan bidder mereka menggunakan buffering protokol terbaru dan informasi yang diuraikan di bagian berikut. Untuk mendownload protokol, lihat halaman data referensi. Untuk mengetahui informasi tentang cara mengembangkan bidder, lihat Memproses Permintaan dan Membuat Respons.

Makro yang didukung

Makro berikut didukung di materi iklan video in-stream:

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

Perlu diperhatikan bahwa penggantian makro diizinkan di URL video, tetapi tidak dalam XML VAST yang sebenarnya.

Makro klik (seperti CLICK_URL_ESC) tidak diperlukan karena Authorized Buyers menyertakan pelacak kliknya di kode wrapper VAST. Oleh karena itu, makro klik tidak didukung untuk iklan video in-stream. Untuk informasi selengkapnya tentang makro yang didukung, lihat Menentukan makro di bagian Membuat Respons.

Detail objek video

Protokol OpenRTB menggunakan pesan Video, yang ditentukan dalam file openrtb-proto.txt untuk mengidentifikasi permintaan video dan memberikan informasi khusus video tambahan tentang permintaan tersebut.

Lihat daftar kolom pesan Video dalam panduan Integrasi OpenRTB untuk deskripsi dan contoh mendetail.

Kolom permintaan bid video lainnya

Sinyal di bawah ini tidak semuanya unik untuk materi iklan video, tetapi merupakan bagian penting dari permintaan bid.

Kolom objek imp

Objek ini menjelaskan penempatan iklan atau tayangan yang dilelang.

banner	Objek Banner; diperlukan jika tayangan ditawarkan sebagai peluang iklan banner.
video	Menunjukkan jenis tayangan yang ditawarkan, dalam hal ini video. Perhatikan bahwa video dalam banner diizinkan jika objek imp menyertakan objek banner dan video.
tagid	ID untuk penempatan iklan atau tag iklan tertentu yang digunakan untuk memulai lelang. Hal ini dapat berguna untuk proses debug masalah apa pun, atau untuk pengoptimalan oleh pembeli.
bidfloor	Bid minimum untuk tayangan ini yang dinyatakan dalam CPM.
bidfloorcur	Mata uang tunggal, yang diperoleh dari billing_id. yang disertakan

Lihat bagian Objek Imp dalam panduan OpenRTB untuk detail tambahan.

Kolom objek perangkat

Kolom dalam objek Device memberikan informasi tentang perangkat yang ditargetkan.

ua	String agen pengguna browser.
ip	Alamat IPv4 yang paling dekat dengan perangkat.
geo	Lokasi perangkat diasumsikan sebagai lokasi pengguna saat ini yang ditentukan oleh objek Geo.
devicetype	Jenis perangkat umum.
ifa	Tanda pengenal diberi sanksi jika digunakan oleh pengiklan secara jelas (misalnya, tidak di-hash). ifa didukung untuk perangkat TV yang terhubung seperti Roku, Apple TV, Fire TV, Xbox.

Lihat bagian Objek perangkat di panduan OpenRTB untuk detail tambahan.

Objek situs

Kolom dalam objek Site memberikan informasi tentang situs dengan konten yang didukung iklan.

page	URL halaman tempat tayangan akan ditampilkan.
publisher	Detail tentang objek Publisher situs.
content	Detail tentang Content dalam situs.

Lihat bagian objek Situs di panduan OpenRTB untuk detail selengkapnya.

Objek pengguna

Kolom dalam objek User memberikan informasi tentang situs dengan konten yang didukung iklan.

id	ID khusus bursa untuk pengguna. Sebaiknya pilih salah satu dari id atau buyerid.
data	Detail tentang objek Publisher situs.

Lihat bagian Objek pengguna di panduan OpenRTB untuk detail tambahan.

Kolom inventaris permintaan bid

Permintaan bid video juga berisi informasi tentang jenis konten dan iklan pengiring tertentu.

mimes

Daftar jenis MIME konten yang diizinkan didukung.

companionad

Array objek Banner jika iklan pengiring tersedia.

Kolom respons bid

Kolom utama dalam respons bid video mencakup hal berikut:

id

ID permintaan bid yang menjadi respons.

seatbid

Array objek Seatbid; satu atau beberapa diperlukan jika bid akan dibuat.

seat

Objek Seatbid; ID slot pembeli (misalnya, pengiklan, agensi) yang diatasnamakan untuk bid ini.

bid

Array yang berisi satu atau beberapa objek Bid yang masing-masing terkait dengan tayangan.

Pra-penargetan

Untuk menerima inventaris video, pembeli OpenRTB harus memiliki konfigurasi pra-penargetan yang menyertakan inventaris video.

Contoh permintaan bid dan respons

Permintaan bid

Tampilkan

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

Respons bid

Tampilkan

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

Glosarium

Lihat Glosarium video Authorized Buyers.