تبلیغات ویدیویی OpenRTB

این راهنما الزامات یکپارچه سازی برای خرید RTB با استفاده از پروتکل OpenRTB را تشریح می کند. این راهنما باید همراه با راهنمای ادغام OpenRTB مورد استفاده قرار گیرد، جایی که فیلدهای مورد بحث در اینجا به تفصیل شرح داده شده است.

اگر از برنامه‌های iOS با قطعه‌های HTML که شامل برچسب‌های <video> هستند خرید می‌کنید، باید ویژگی playsinline را در تگ ویدیو قرار دهید. در غیر این صورت، کاربران تجربه بسیار ضعیفی دارند که در آن تبلیغات ویدیویی که قرار است در خلاقیت پخش شوند، به نظر می‌رسد به تمام صفحه نمایش داده می‌شوند. تبلیغاتی که این را رعایت نکنند مسدود خواهند شد.

الزامات خریدار

خریداران جدید RTB باید پیشنهاد دهندگان خود را با استفاده از آخرین بافر پروتکل و اطلاعات ذکر شده در بخش‌های زیر توسعه دهند. برای دانلود پروتکل به صفحه داده های مرجع مراجعه کنید. برای اطلاعات در مورد توسعه یک مناقصه، به پردازش درخواست و ایجاد پاسخ مراجعه کنید.

ماکروهای پشتیبانی شده

ماکروهای زیر در خلاقیت‌های ویدیویی در جریان پشتیبانی می‌شوند:

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

توجه داشته باشید که جایگزینی ماکرو در URL ویدیو مجاز است اما در VAST XML واقعی نیست.

ماکروهای کلیک (مانند CLICK_URL_ESC ) ضروری نیستند زیرا مجاز خریداران ردیاب های کلیک خود را در یک بسته بندی VAST قرار می دهند. بنابراین، ماکروهای کلیکی برای تبلیغات ویدیویی در جریان پشتیبانی نمی شوند. برای اطلاعات بیشتر در مورد ماکروهای پشتیبانی شده، به مشخص کردن ماکروها در بخش Build the Response مراجعه کنید.

جزئیات شی ویدیویی

پروتکل OpenRTB از یک پیام Video استفاده می کند که در فایل openrtb-proto.txt تعریف شده است تا درخواست های ویدیویی را شناسایی کند و اطلاعات بیشتری را در مورد درخواست ارائه دهد.

لیست فیلدهای پیام ویدیویی را در راهنمای ادغام OpenRTB برای توضیحات و مثال های دقیق ببینید.

سایر فیلدهای درخواست پیشنهاد ویدیو

سیگنال‌های زیر همگی مختص خلاقیت‌های ویدیویی نیستند، بلکه بخش‌های کلیدی درخواست پیشنهاد هستند.

فیلدهای شی Imp

این شی یک آگهی یا نمایشی را که در حراج گذاشته شده است را توصیف می کند.

banner	یک شیء بنر؛ اگر نمایش به عنوان یک فرصت تبلیغات بنری ارائه شود، ضروری است.
video	نوع نمایش ارائه شده را نشان می دهد، در این مورد ویدیو. توجه داشته باشید که اگر شی imp شامل هر دو banner و اشیاء video باشد، ویدیوی درون بنر مجاز است.
tagid	شناسه مکان یا برچسب تبلیغاتی خاص که برای شروع حراج استفاده شده است. این می تواند برای اشکال زدایی هر مشکلی یا برای بهینه سازی توسط خریدار مفید باشد.
bidfloor	حداقل پیشنهاد برای این نمایش در CPM بیان شده است.
bidfloorcur	یک ارز واحد که از billing_id . موجود به دست می آید billing_id .

برای جزئیات بیشتر به بخش Imp Object در راهنمای OpenRTB مراجعه کنید.

فیلدهای شیء دستگاه

فیلدهای موجود در شی Device اطلاعاتی در مورد دستگاه مورد نظر ارائه می دهند.

ua	رشته عامل کاربر مرورگر.
ip	آدرس IPv4 نزدیکترین به دستگاه
geo	مکان دستگاه فرض می شود مکان فعلی کاربر است که توسط یک شی Geo تعریف شده است.
devicetype	نوع کلی دستگاه
ifa	شناسه برای استفاده تبلیغ‌کننده در حالت شفاف (مثلاً هش نشده) تحریم شده است. ifa برای دستگاه های تلویزیون متصل مانند Roku، Apple TV، Fire TV، Xbox پشتیبانی می شود.

برای جزئیات بیشتر به بخش Device object در راهنمای OpenRTB مراجعه کنید.

شی سایت

فیلدهای موجود در شی Site اطلاعاتی در مورد سایت با محتوای تبلیغاتی ارائه می دهند.

page	نشانی وب صفحه ای که در آن نمایش نشان داده خواهد شد.
publisher	جزئیات مربوط به موضوع Publisher سایت.
content	جزئیات در مورد Content سایت

برای جزئیات بیشتر به بخش شیء سایت در راهنمای OpenRTB مراجعه کنید.

شی کاربر

فیلدهای موجود در شی User اطلاعاتی را در مورد سایت با محتوای پشتیبانی شده از آگهی ارائه می دهند.

id	شناسه مخصوص تبادل برای کاربر. حداقل یکی از id یا buyerid توصیه می شود.
data	جزئیات مربوط به موضوع Publisher سایت.

برای جزئیات بیشتر به بخش شی کاربر در راهنمای OpenRTB مراجعه کنید.

فیلدهای موجودی درخواست پیشنهاد

درخواست پیشنهاد پیشنهادی ویدیویی همچنین حاوی اطلاعاتی درباره انواع محتوا و هر گونه تبلیغات همراه مشخص شده است.

mimes

لیست مجاز از انواع MIME محتوا پشتیبانی می شود.

companionad

آرایه ای از اشیاء بنر در صورت موجود بودن تبلیغات همراه.

فیلدهای پاسخ پیشنهادی

فیلدهای کلیدی در یک پاسخ پیشنهادی ویدیویی شامل موارد زیر است:

id

شناسه درخواست پیشنهادی که این پاسخ به آن است.

seatbid

آرایه ای از اشیاء Seatbid . اگر قرار است پیشنهادی ارائه شود، یک یا چند مورد لازم است.

seat

یک شی Seatbid . شناسه صندلی خریدار (به عنوان مثال، آگهی‌دهنده، آژانس) که این پیشنهاد از طرف او انجام شده است.

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

پاسخ پیشنهاد

Show Me

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

واژه نامه

به واژه نامه ویدیویی خریداران مجاز مراجعه کنید.