إعلانات فيديو OpenRTB

يوضّح هذا الدليل متطلبات الدمج لشراء عروض الأسعار في الوقت الفعلي باستخدام بروتوكول OpenRTB. ويجب استخدام هذا الدليل إلى جانب دليل دمج OpenRTB حيث يتم وصف الحقول التي تمت مناقشتها هنا بالتفصيل.

إذا كنت تشتري على تطبيقات iOS باستخدام مقتطفات HTML التي تتضمّن علامات <video>، عليك تضمين السمة playsinline في علامة الفيديو. إذا لم يكن الأمر كذلك، ستكون تجربة المستخدمين سيئة للغاية حيث تظهر إعلانات الفيديو التي يُفترض أن يتم تشغيلها ضمن تصميم الإعلان في الظهور في وضع ملء الشاشة. وسيتم حظر الإعلانات التي لا تلتزم بهذا الإجراء.

متطلبات المشترين

على مشتري عروض الأسعار في الوقت الفعلي (RTB) الجدد إعداد أنظمة عروض الأسعار الخاصة بهم باستخدام أحدث احتياطي للبروتوكول والمعلومات الموضّحة في الأقسام التالية. لتنزيل البروتوكول، اطّلِع على صفحة البيانات المرجعية. للاطّلاع على معلومات عن كيفية إعداد نظام عروض أسعار، راجِع معالجة الطلب وكيفية تقديم الاستجابة.

وحدات ماكرو المتوافقة

تُستخدم وحدات الماكرو التالية في تصميمات الإعلانات ضمن بث الفيديو المباشر:

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

تجدر الإشارة إلى أنّ استبدال وحدة الماكرو مسموح به في عنوان URL للفيديو ولكن ليس ضمن تنسيق XML الخاص بنموذج عرض إعلانات الفيديو (VAST).

ولا تعتبر وحدات ماكرو للنقرات (مثل CLICK_URL_ESC) ضرورية لأن برنامج "الشراة المعتمَدون" يتضمّن برامج تتبُّع النقرات التابعة لها في برنامج تضمين نموذج عرض إعلانات فيديو (VAST). ولذلك، لا تتوفر وحدات ماكرو للنقرات للإعلانات ضمن بث الفيديو المباشر. لمزيد من المعلومات حول وحدات الماكرو المتوافقة، راجع تحديد وحدات الماكرو ضمن إنشاء الاستجابة.

تفاصيل عناصر الفيديو

يستخدم بروتوكول OpenRTB رسالة Video، يتم تحديدها في ملف openrtb-proto.txt لتحديد طلبات الفيديو وتقديم معلومات إضافية خاصة بالفيديو حول الطلب.

يمكنك الاطّلاع على قائمة حقول رسائل الفيديو في دليل الدمج OpenRTB للحصول على أوصاف وأمثلة تفصيلية.

حقول أخرى لطلب عرض سعر الفيديو

الإشارات الواردة أدناه ليست جميعها فريدة لتصميمات إعلانات الفيديو، ولكنها أجزاء رئيسية في طلب عرض السعر.

حقول عناصر الظهور

يصف هذا العنصر موضع إعلان أو مرة ظهور يتم عرضها في المزاد.

banner	عنصر بانر مطلوب إذا تم عرض مرة الظهور كفرصة لإعلانات البانر.
video	تشير هذه السمة إلى نوع مرات الظهور المقدَّمة، وهي في هذه الحالة الفيديو. ويُرجى العِلم بأنّه يُسمح باستخدام الفيديو داخل البانر إذا كان الكائن imp يتضمّن العنصرَين banner وvideo على حد سواء.
tagid	معرّف لموضع إعلان معيّن أو علامة إعلان معيّنة تم استخدامها لبدء المزاد. ويمكن أن يكون ذلك مفيدًا لتصحيح الأخطاء في أي مشكلات أو للتحسين من قِبل المشتري.
bidfloor	الحد الأدنى لعرض السعر لمرات الظهور هذه والذي يتم التعبير عنه للتكلفة لكل ألف ظهور.
bidfloorcur	عملة واحدة يتم الحصول عليها من billing_id. المضمّنة

راجِع قسم عنصر الظهور في دليل OpenRTB للحصول على تفاصيل إضافية.

حقول عناصر الجهاز

توفّر الحقول في العنصر Device معلومات عن الجهاز المستهدَف.

ua	سلسلة وكيل مستخدم المتصفّح
ip	عنوان IPv4 الأقرب إلى الجهاز.
geo	من المفترض أن يكون موقع الجهاز هو الموقع الجغرافي الحالي للمستخدم الذي حدّده عنصر Geo.
devicetype	تمثّل هذه السمة النوع العام للجهاز.
ifa	تم فرض عقوبة على استخدام المعلِن إذا كانت واضحة (مثلاً، غير مجزّأة). يتوافق ifa مع أجهزة التلفزيون المتصلة، مثل Roku وApple TV وFire TV وXbox.

راجِع قسم كائن الجهاز في دليل OpenRTB للحصول على تفاصيل إضافية.

كائن الموقع الإلكتروني

توفّر الحقول في العنصر Site معلومات حول الموقع الإلكتروني الذي يتضمن محتوى يتيح عرض الإعلانات.

page	عنوان URL للصفحة التي سيتم عرض مرّة الظهور فيها
publisher	تفاصيل حول العنصر Publisher في الموقع الإلكتروني
content	تفاصيل عن Content داخل الموقع الإلكتروني.

راجِع قسم عنصر الموقع الإلكتروني في دليل OpenRTB للحصول على تفاصيل إضافية.

كائن المستخدم

توفّر الحقول في العنصر User معلومات حول الموقع الإلكتروني الذي يتضمن محتوى يتيح عرض الإعلانات.

id	رقم التعريف الخاص بـ Exchange للمستخدم. يُنصح باستخدام سمة واحدة على الأقل من id أو buyerid.
data	تفاصيل حول العنصر Publisher في الموقع الإلكتروني

راجِع قسم كائن المستخدم في دليل OpenRTB للاطّلاع على تفاصيل إضافية.

حقول مستودع طلبات عروض الأسعار

يحتوي طلب عرض سعر الفيديو أيضًا على معلومات حول أنواع المحتوى وأي إعلانات مصاحبة محددة.

mimes

القائمة المسموح بها تضم أنواع MIME للمحتوى المسموح به.

companionad

مصفوفة من كائنات إعلان البانر في حال توفُّر إعلانات مصاحبة.

حقول الاستجابة لعرض السعر

تتضمن الحقول الرئيسية في استجابة عرض سعر الفيديو ما يلي:

id

رقم تعريف طلب عرض السعر الذي يكون هذا استجابة له.

seatbid

مصفوفة من عناصر Seatbid، ويجب إدخال مصفوفة واحدة أو أكثر إذا كان سيتم تقديم عرض سعر.

seat

عنصر Seatbid، ورقم تعريف مقعد المشتري (على سبيل المثال، المعلِن أو الوكالة) الذي يتم تقديم عرض السعر هذا نيابةً عنه.

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

مسرد المصطلحات

يُرجى الاطّلاع على مسرد مصطلحات فيديو "الشراة المعتمَدون".