โฆษณาวิดีโอ OpenRTB

คู่มือนี้สรุปข้อกำหนดในการผสานรวมสำหรับการซื้อ RTB โดยใช้โปรโตคอล OpenRTB คู่มือนี้ควรใช้ร่วมกับคู่มือการผสานรวม OpenRTB ซึ่งมีการอธิบายรายละเอียดเกี่ยวกับช่องที่กล่าวถึงในที่นี้

หากซื้อในแอป iOS ที่มีข้อมูลโค้ด HTML ที่มีแท็ก <video> คุณต้องใส่แอตทริบิวต์ playsinline ในแท็กวิดีโอ มิเช่นนั้นผู้ใช้ได้รับประสบการณ์ที่ไม่ดีซึ่งโฆษณาวิดีโอที่ควรเล่นภายในครีเอทีฟโฆษณาจะแสดงขึ้นมาแบบเต็มหน้าจอ โฆษณาที่ไม่ดำเนินการตามแนวทางนี้จะถูกบล็อก

ข้อกำหนดสำหรับผู้ซื้อ

ผู้ซื้อ RTB รายใหม่ควรพัฒนาผู้เสนอราคาโดยใช้บัฟเฟอร์โปรโตคอลล่าสุดและข้อมูลที่ระบุไว้ในส่วนต่อไปนี้ หากต้องการดาวน์โหลดโปรโตคอล โปรดดูหน้าข้อมูลอ้างอิง สำหรับข้อมูลเกี่ยวกับการพัฒนาผู้เสนอราคา โปรดดูประมวลผลคำขอและสร้างการตอบกลับ

มาโครที่สนับสนุน

ครีเอทีฟโฆษณาวิดีโอในสตรีมรองรับมาโครต่อไปนี้

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

โปรดทราบว่าการแทนที่มาโครสามารถทำได้ใน URL ของวิดีโอ แต่ไม่ใช่ใน VAST XML จริง

มาโครการคลิก (เช่น CLICK_URL_ESC) ไม่จำเป็นเนื่องจาก Authorized Buyers รวมเครื่องมือติดตามคลิกไว้ใน VAST Wrapper ดังนั้น โฆษณาวิดีโอในสตรีมจึงไม่รองรับมาโครการคลิก สำหรับข้อมูลเพิ่มเติมเกี่ยวกับมาโครที่รองรับ โปรดดูระบุมาโครในส่วนสร้างการตอบกลับ

รายละเอียดออบเจ็กต์วิดีโอ

โปรโตคอล OpenRTB ใช้ข้อความ Video ที่กำหนดไว้ในไฟล์ openrtb-proto.txt เพื่อระบุคำขอวิดีโอ และเพื่อให้ข้อมูลเพิ่มเติมเฉพาะเกี่ยวกับวิดีโอเกี่ยวกับคำขอ

ดูรายการช่องข้อความวิดีโอในคู่มือการผสานรวม OpenRTB สำหรับคำอธิบายและตัวอย่างโดยละเอียด

ช่องคำขอราคาเสนอวิดีโออื่นๆ

สัญญาณด้านล่างนี้ไม่ได้มีถึงครีเอทีฟโฆษณาวิดีโอเสมอไป แต่เป็นส่วนสำคัญของคำขอราคาเสนอ

ช่องออบเจ็กต์การแสดงผล

ออบเจ็กต์นี้อธิบายตำแหน่งโฆษณาหรือการแสดงผลที่กำลังประมูล

banner	ออบเจ็กต์แบนเนอร์ ซึ่งจำเป็นหากมีการเสนอการแสดงผลเป็นโอกาสโฆษณาแบนเนอร์
video	ระบุประเภทของการแสดงผลที่เสนอ ซึ่งในกรณีนี้เป็นวิดีโอ โปรดทราบว่าระบบจะอนุญาตวิดีโอในแบนเนอร์หากออบเจ็กต์ imp มีทั้งออบเจ็กต์ banner และ video
tagid	ตัวระบุสำหรับตำแหน่งโฆษณาหรือแท็กโฆษณาเฉพาะที่ใช้ในการเริ่มต้นการประมูล ซึ่งจะเป็นประโยชน์ต่อการแก้ไขข้อบกพร่องของปัญหาต่างๆ หรือเพิ่มประสิทธิภาพให้กับผู้ซื้อ
bidfloor	ราคาเสนอต่ำสุดสำหรับการแสดงผลนี้ซึ่งแสดงเป็น CPM
bidfloorcur	สกุลเงินเดียว ได้จาก billing_id. ที่รวมอยู่

ดูรายละเอียดเพิ่มเติมได้ที่ส่วนออบเจ็กต์การแสดงผลในคู่มือ OpenRTB

ช่องออบเจ็กต์ของอุปกรณ์

ช่องในออบเจ็กต์ Device ให้ข้อมูลเกี่ยวกับอุปกรณ์เป้าหมาย

ua	สตริง User Agent ของเบราว์เซอร์
ip	ที่อยู่ IPv4 ที่อยู่ใกล้อุปกรณ์มากที่สุด
geo	ตำแหน่งของอุปกรณ์ที่ถือว่าเป็นตำแหน่งปัจจุบันของผู้ใช้ที่กำหนดโดยออบเจ็กต์ Geo
devicetype	ประเภทอุปกรณ์ทั่วไป
ifa	รหัสที่ถูกคว่ำบาตรสำหรับการใช้งานของผู้ลงโฆษณาที่ชัดเจน (เช่น ไม่ได้แฮช) รองรับ ifa สำหรับอุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ต เช่น Roku, Apple TV, Fire TV, Xbox

ดูรายละเอียดเพิ่มเติมได้ที่ส่วนออบเจ็กต์อุปกรณ์ในคู่มือ OpenRTB

ออบเจ็กต์ของเว็บไซต์

ช่องในออบเจ็กต์ Site ให้ข้อมูลเกี่ยวกับเว็บไซต์ซึ่งมีเนื้อหาที่มีโฆษณาสนับสนุน

page	URL ของหน้าที่การแสดงผลจะปรากฏ
publisher	รายละเอียดเกี่ยวกับออบเจ็กต์ Publisher ของเว็บไซต์
content	รายละเอียดเกี่ยวกับ Content ภายในเว็บไซต์

ดูรายละเอียดเพิ่มเติมได้ที่ส่วนออบเจ็กต์ Site ในคู่มือ OpenRTB

ออบเจ็กต์ผู้ใช้

ช่องในออบเจ็กต์ User ให้ข้อมูลเกี่ยวกับเว็บไซต์ซึ่งมีเนื้อหาที่มีโฆษณาสนับสนุน

id	รหัสเฉพาะของ Exchange สำหรับผู้ใช้ ขอแนะนำให้ใช้ id หรือ buyerid อย่างน้อย 1 รายการ
data	รายละเอียดเกี่ยวกับออบเจ็กต์ Publisher ของเว็บไซต์

ดูรายละเอียดเพิ่มเติมได้ที่ส่วนออบเจ็กต์ผู้ใช้ในคู่มือ OpenRTB

ช่องพื้นที่โฆษณาของคำขอราคาเสนอ

คำขอราคาเสนอวิดีโอยังมีข้อมูลเกี่ยวกับประเภทเนื้อหาและโฆษณาที่แสดงร่วมที่ระบุอีกด้วย

mimes

รายการที่อนุญาตของประเภท MIME ของเนื้อหาที่รองรับ

companionad

อาร์เรย์ของออบเจ็กต์แบนเนอร์ หากมีโฆษณาที่แสดงร่วม

ช่องการเสนอราคาตอบ

ช่องหลักในการเสนอราคาตอบของวิดีโอประกอบด้วยข้อมูลต่อไปนี้

id

รหัสคำขอราคาเสนอที่เป็นการตอบกลับ

seatbid

อาร์เรย์ของออบเจ็กต์ Seatbid จำเป็นต้องมีอย่างน้อย 1 รายการหากเสนอราคา

seat

ออบเจ็กต์ Seatbid รหัสที่นั่งของผู้ซื้อ (เช่น ผู้ลงโฆษณา เอเจนซี) ในนามของผู้เสนอราคา

bid

อาร์เรย์ของออบเจ็กต์ Bid อย่างน้อย 1 รายการซึ่งแต่ละรายการเกี่ยวข้องกับการแสดงผล

การกำหนดเป้าหมายล่วงหน้า

หากต้องการรับพื้นที่โฆษณาวิดีโอ ผู้ซื้อ 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