تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

بناء الرد

بعد أن يعالج تطبيقك طلب عروض الأسعار من Google، يجب أن ينشئ ويرسل ردًا. يوضّح هذا الدليل كيفية ترميز تطبيقك لإنشاء الاستجابة.

إنشاء رسالة BidResponse

لإرسال عرض سعر، يجب أن يستجيب تطبيق عروض الأسعار لطلب عرض سعر باستخدام BidResponse يحتوي على Bid بالتنسيق الذي تم ضبطه. إذا كنت تستخدم تنسيق JSON، يجب ضبط الرأس Content-Type على application/json; charset=utf-8 وتضمين ملف JSON BidResponse في النص. إذا كنت تستخدِم تنسيق Protobuf، يجب أن يضبط تطبيقك رأس Content-Type على application/octet-stream وأن يتضمّنBidResponse المتسلسل في النص الأساسي.

لإنشاء BidResponse وتحويله إلى سلسلة لتنسيق Protobuf، يجب إنشاء مكتبات Protobuf واستخدامها استنادًا إلى openrtb.proto وopenrtb-adx.proto، اللذان ينفِّذان حقول BidResponse العادية في OpenRTB وامتدادات Google في Protobuf على التوالي. ويمكن العثور عليها في النماذج الأولية والبيانات المرجعية.

إذا كنت لا تريد تقديم عروض أسعار لمشاهدة إعلان، يجب عرض استجابة HTTP 204 فارغة. يجب أن يعرض تطبيقك استجابة لكل BidRequest. إنّ حالات انتهاء المهلة والردود التي لا يمكن تحليلها تُعدّ أخطاء، وتعمل Google على خفض معدّل إرسال عروض الأسعار التي تسجّل معدّلات أخطاء عالية.

الرقم التعريفي لتصميم الإعلان

يحدّد BidResponse تصميم إعلان من خلال الحقل BidResponse.seatbid.bid.crid (الحدّ الأقصى 64 بايت). حتى مواد العرض المشابهة، يجب أن تحتوي على قيم فريدة لهذا الحقل إذا كانت تختلف في أي خصائص ملحوظة، بما في ذلك على سبيل المثال لا الحصر: الحجم وعنوان URL المُعلَن عنه وسمات مواد العرض وأنواع المورّدين. بعبارة أخرى، يجب منح معرّفات مواد إبداعية مختلفة لأي إعلانَين:

تبدو مختلفة أو تتصرف بشكل مختلف
عرض الصور بتنسيقات مختلفة
يتم عرضها بوسائل مختلفة (على سبيل المثال، يتألف أحد الإعلانات من صورة، بينما الآخر عبارة عن فيديو).

أثناء تصميم طلبك، عليك اختيار طريقة منهجية ل إنشاء معرّفات منطقية لأنواع تصميمات الإعلانات التي تخطّط لإرسالها.

سمات الإعلان

تنصح Google بتعريف سمات المواد الإبداعية لوصف سمات إعلانك واستهدافه باستخدام إما تركيبة من BidResponse.seatbid.bid.apis و BidResponse.seatbid.bid.attr أو إضافة BidResponse.seatbid.bid.ext.attribute. توضّح الخطوات التالية كيفية تحديد السمات:

VPAID
اضبط BidResponse.seatbid.bid.apis على VPAID_1 أو VPAID_2. بالنسبة إلى تنسيق JSON، يمكن ضبط هذا الخيار على 1 أو 2 على التوالي.
MRAID
اضبط BidResponse.seatbid.bid.apis على MRAID_1 أو 3 لتنسيق JSON.
SIZELESS
اضبط BidResponse.seatbid.bid.attr على RESPONSIVE أو 18 لتنسيق JSON.
PLAYABLE
ويُشار إلى ذلك من خلال ضبط BidResponse.seatbid.bid.attr على USER_INTERACTIVE أو 13 لتنسيق JSON.

ملاحظة: إذا كنت تستخدِم الإضافة BidResponse.seatbid.bid.ext.attribute، يمكنك استخدام القيم المتوفّرة فيملف buyer-declarable-creative-attributes.txt للإفصاح عن هذه السمات.

اطّلِع على مرجع تصميمات الإعلانات للاطّلاع على شرح حول كيفية الحصول على ملاحظات بشأن السمات التي تم رصدها في تصاميم إعلاناتك.

حقول "عرض الأسعار المفتوح"

إنّ ردود عروض الأسعار التي يرسلها مقدّمو عروض الأسعار في الشبكة الإعلانية وشبكة التبادل الذين يشاركون في "عرض الأسعار المفتوح" مشابهة لتلك التي يرسلها "الشراة المعتمَدون" الذين يشاركون في "عرض أسعار الوقت الفعلي" العادي. يمكن لعملاء عروض الأسعار المفتوحة تحديد عدد صغير من الحقول الإضافية، وقد يكون لبعض الحقول الحالية استخدامات بديلة. وتشمل هذه التحسينات ما يلي:

الحقل	التفاصيل
`BidResponse.imp.pmp.deals.id`	معرّف الصفقة من مساحة اسم التبادل المرتبط بهذه المحاولة الإجرائية ويكون مُدرَجًا في التقارير المرسَلة إلى الناشرين. ملاحظة: لا يتم إرسال هذا الحقل إلا إلى المشاركين في الإصدار التجريبي المغلق.
`BidResponse.seatbid.bid.ext.exchange_deal_type`	نوع الصفقة التي يتم الإبلاغ عنها للناشرين، ما يؤثّر في كيفية التعامل مع الصفقة في المزاد ملاحظة: لا يتم إرسال هذا الحقل إلا إلى المشاركين في الإصدار التجريبي المغلق.
`BidResponse.seatbid.bid.ext.third_party_buyer_token`	الرمز المميّز المستخدَم لتحديد معلومات المشتري النهائي التابع لجهة خارجية إذا كان التبادل بصفته مقدّم عروض أسعار مفتوحة هو وسيط. يتم الحصول على هذه المعلومات من العميل التابع للجهة الخارجية ويجب تمريرها إلى Google بدون تغيير في ردّ عروض الأسعار.

اقتراحات

فعِّل اتصالات HTTPS المستمرة (المعروفة أيضًا باسم "الاستدامة" أو "إعادة استخدام الاتصال") على خوادمك. اضبط مهلة الانتظار على 10 ثوانٍ على الأقل، وتكون القيم الأعلى مفيدة في العديد من الحالات. تتحقّق Google من ذلك أثناء اختبارات وقت الاستجابة الأولية لتطبيقك، لأنّه يُرسِل "المشترون المعتمَدون" الطلبات بمعدّل مرتفع ويجب تجنُّب الوقت الإضافي الذي يستغرقه إنشاء اتصال TCP منفصل لكل طلب.
أدرِج عنوان URL الاختياري لتتبُّع مرّات الظهور من أجل تتبُّع مرّات الظهور بدلاً من تتبُّع وقت فوز مقدّم عروض الأسعار. ونظرًا للانخفاض في عدد مرات الفوز وعدد مرات العرض، يؤدّي ذلك إلى إحصاءات تتبُّع أكثر دقة.

ملاحظة: عند استخدام OpenRTB، يكون الحقل العادي لهذا هو BidResponse.seatbid.bid.burl.
يجب أن يكون رمز مقدّم عروض الأسعار خاليًا من الاعتماد على الحقول المتوقّفة نهائيًا، لأنّ ذلك قد يؤدي إلى تعذّر عرض أسعارك بسبب حدوث أخطاء.
أدرِج BidResponse.seatbid.bid.w و BidResponse.seatbid.bid.h في BidResponse. يجب أن يتضمّن BidResponse لطلب يتضمّن أحجام إعلانات متعددة هذه الحقول وإلا سيتم إسقاطه من المزاد.
يجب ألا يزيد حجم الردّ عن 8 كيلوبايت. قد تؤدي الردود الكبيرة جدًا إلى زيادة وقت استجابة الشبكة وتسبب في انتهاء المهلة.
اتّبِع الإرشادات المتعلقة بعروض الأسعار في مستودع iOS التي تتطلّب تحديد المصدر من خلال SKAdNetwork.

مثال على استجابة عرض السعر

تمثّل الأمثلة التالية عيّنات قابلة للقراءة من طلبات Protobuf و JSON.

OpenRTB Protobuf

عرض المثال

الاستجابة التسلسلية

id: "9u09jhHJXT2fbaDZ9V1x66"
seatbid {
  bid {
    id: "37Td8Gbw1Lr8161bA4B"
    impid: "1"
    price: 0.075
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    crid: "test_creative_id_156129"
    cat: "IAB22"
    w: 320
    h: 50
    language: "es"
    slotinpod: SLOT_POSITION_POD_ANY
    cattax: IAB_CONTENT_1_0
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      exchange_deal_type: OPEN_AUCTION
      event_notification_token {
        payload: "token"
      }
      billing_id: 61560909063
    }
  }
  seat: "4778:9251:780612"
}
cur: "USD"

ملف JSON في OpenRTB

عرض المثال

{
  "id": "9u09jhHJXT2fbaDZ9V1x66",
  "seatbid": [
    {
      "bid": [
        {
          "id": "37Td8Gbw1Lr8161bA4B",
          "impid": "1",
          "price": 0.075,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com",
            "google.com"
          ],
          "crid": "test_creative_id_156129",
          "cat": [
            "IAB22"
          ],
          "w": 320,
          "h": 50,
          "language": "es",
          "slotinpod": 0,
          "cattax": 1,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "exchange_deal_type": 0,
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "61560909063"
          }
        }
      ],
      "seat": "4778:9251:780612"
    }
  ],
  "cur": "USD"
}

ملاحظة مهمة: يتم عرض رسائل Protobuf المعروضة في المثالين أدناه كنص يمكن لشخص عادي قراءته. ومع ذلك، هذه ليست الطريقة التي يتم بها إرسال الرسائل عبر الشبكة. عند استخدام تنسيق OpenRTB Protobuf، لن يتم قبول سوى رسائل BidResponse التسلسلية.

يمكنك إنشاء رسالة BidResponse وتسلسلها باستخدام رمز C++ التالي:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

تحديد تصميم الإعلان

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

بدلاً من ذلك، يمكنك تحديد تصميم إعلانك باستخدام واحد من الحقول التالية، استنادًا إلى شكل الإعلان:

إعلان معروض باستخدام حزمة تطوير البرامج (SDK)
- BidResponse.seatbid.bid.ext.sdk_rendered_ad
صفحات AMP
- BidResponse.seatbid.bid.amp_ad_url
الفيديو
- BidResponse.seatbid.bid.adm
الإعلانات المدمَجة مع المحتوى
- BidResponse.seatbid.bid.adm_native

حدِّد إعلانًا مستضافًا على خوادمك باستخدام مقتطف HTML في حقل BidResponse.seatbid.bid.adm. يتم تضمين المقتطف في ملف iFrame مُدرَج في صفحة الويب، ما يؤدي إلى استرجاع الإعلان و عرضه عند تحميل الصفحة. يجب إنشاء مقتطف HTML لكي يتم عرض الإعلان (البانر أو الإعلان البيني) بشكل صحيح داخل إطار iframe وبحجم مناسب لموضع الإعلان الذي تقدّم عروض أسعار له.

بالإضافة إلى ذلك، يجب أن يتطابق حجم الإعلان الذي تمّ الإعلان عنه في ردّ عرض السعر مع أحد تركيبات الحجم بالضبط في طلب عرض السعر في الحالات التالية:

الإعلان هو بانر عادي (وليس فيديو أو إعلان مضمّن مع المحتوى أو إعلان بيني).
أعلن مقدّم العرض عن الحجم في استجابة عرض السعر. يجب تحديد المقاس في حال توفّر أكثر من مقاس واحد في الطلب.
يتمّ استثناء الإعلانات البينية. بالنسبة إلى الإعلانات البينية، يجب ألا يقلّ عرضها عن% 50 من عرض الشاشة، ويجب ألا يقلّ ارتفاعها عن% 40 من ارتفاع الشاشة.

يمكنك تحديد تصميم مقتطف HTML باستخدام أي رمز HTML صالح يتم عرضه بشكل صحيح، ولكن عليك مراعاة القيود المفروضة على تحديد الحقل crid في القسم إنشاء رسالة BidResponse. ومن بين استخدامات ذلك وضع معلومات إضافية في وسيطات عناوين URL التي يتم جلبها من خوادمك كجزء من عرض الإعلان. يتيح لك ذلك تمرير بيانات عشوائية عن مرّة الظهور إلى خوادمك.

إنّ معظم سياسات مقتطفات HTML التي يتم عرضها في ردود عروض الأسعار هي نفسها السياسات المتعلّقة بالإعلانات التابعة لجهات خارجية. للمزيد من المعلومات، يُرجى الاطّلاع على إرشادات البرنامج المتعلق بالشراة المعتمَدين ومتطلبات عرض الإعلانات التابعة لجهات خارجية والإفصاح عن عناوين URL التي تؤدي إلى النقر في الإعلانات.

تحديد وحدات الماكرو

وحدات الماكرو هي نص منسَّق مضمّن في بعض حقول استجابة عروض الأسعار التي تحتوي على عناوين URL يتم استبدالها بقيمة ذات صلة في وقت عرض الإعلان. على سبيل المثال، إذا كان عرض السعر الفائز يتضمّن وحدة الماكرو AUCTION_PRICE في مقتطف HTML الإعلاني المضمّن في عرض السعر، سيتم استبدال وحدة الماكرو بقيمة يمكنك فك تشفيرها لتحديد المبلغ الذي دفعته مقابل مرّة الظهور في المزاد.

يمكنك تضمين وحدات الماكرو في الحقول التالية:

BidResponse.seatbid.bid.adm

تتوفّر وحدات الماكرو لتنسيقات مقتطف HTML والإعلانات المدمجة وعنوان URL للفيديو وتنسيق XML لإعلانات VAST للفيديوهات.
BidResponse.seatbid.bid.adm_native.eventtrackers.url
BidResponse.seatbid.bid.adm_native.imptrackers
BidResponse.seatbid.bid.ext.amp_ad_url

لا تتوفّر سوى وحدات الماكرو WINNING_PRICE و WINNING_PRICE_ESC الخاصة بـ Google لتصميمات إعلانات AMP.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url

استخدِم هذا الرمز بدلاً من BidResponse.seatbid.bid.burl إذا كنت تحتاج إلى أكثر من عنوان URL واحد للفوترة.

على سبيل المثال، يمكنك تضمين وحدة ماكرو كجزء من مقتطف HTML من خلال تضمين ${MACRO} ضمن عنوان URL المستخدَم لجلب تصميم الإعلان، حيث يكون MACRO إحدى وحدات الماكرو المتوافقة الموضّحة في مواصفات OpenRTB.

وحدات الماكرو من Google

تتيح Google استخدام وحدات ماكرو إضافية إلى جانب تلك الوحدات الواردة في مواصفات OpenRTB. ويتم تنسيق هذه الوحدات بشكل مختلف، وستظهر على النحو التالي: %%MACRO%% في حال تضمينها في عنوان URL. يوضّح الجدول التالي وحدات الماكرو هذه:

Macro	الوصف
`ADVERTISING_IDENTIFIER`	السماح للمشترين بتلقّي معرّف المعلِنين (IDFA) في نظام التشغيل iOS أو المعرّف الإعلاني في Android عند عرض مرات الظهور اطّلِع على فك تشفير معرّفات المعلِنين للاطّلاع على التفاصيل.
`CACHEBUSTER`	تمثيل سلسلة لعدد صحيح عشوائي غير موقَّع من أربعة بايت
`CLICK_URL_UNESC`	عنوان URL غير المشفَّر للنقرة على الإعلان. في المقتطف، يجب أن يتبع رمز برمجي واسِع النطاق لعنوان URL الخاص بالنقرة على الجهة الخارجية مباشرةً رمز برمجي الماكرو. على سبيل المثال، إذا كان عنوان URL للنقرة التابع لجهة خارجية هو `http://my.adserver.com/some/path/handleclick?click=clk`، يمكن استخدام الرمز التالي مع الإصدار الذي تم تشفيره مرة واحدة من عنوان URL للنقرة التابع لجهة خارجية بعد استدعاء الماكرو: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> في وقت عرض الإعلان، يتم توسيع هذا النطاق ليشمل ما يلي: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> سيسجّل عنوان URL النقرة أولاً مع Google، ثم سيعيد توجيهك إلى عنوان URL الخاص بالنقرة التابع للجهة الخارجية.
`CLICK_URL_ESC`	عنوان URL للنقرة على الإعلان الذي تمّ ترميزه استخدِم هذا الإجراء بدلاً من `CLICK_URL_UNESC` إذا كنت بحاجة إلى تمرير القيمة أولاً من خلال خادم آخر سيعرض بعد ذلك إعادة توجيه. على سبيل المثال، يمكن استخدام الرمز البرمجي التالي في مقتطف HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> في وقت عرض الإعلان، يتم توسيع هذا النطاق ليشمل ما يلي: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> سيؤدي ذلك إلى تسجيل النقرة باستخدام `my.adserver.com` التي ستكون مسؤولة بعد ذلك عن إعادة التوجيه إلى عنوان URL الذي تم تمريره في المَعلمة `google_click_url`. يفترض ذلك أنّه يتم إزالة ترميز المَعلمة `google_click_url` باستخدام الإجراء `my.adserver.com`. يمكنك إلحاق عنوان URL مُشفَّر مزدوجًا بعد `%%CLICK_URL_ESC%%`. بعد إزالة ترميز المحتوى من خلال `my.adserver.com`، يبقى إصدار واحد غير مشفَّر من عنوان URL مُلحَقًا بالعنصر `google_click_url`. عند جلب `google_click_url`، ستتم إزالة ترميزه مرة أخرى ثم إعادة التوجيه.
`CLICK_URL_ESC_ESC`	عنوان URL الذي تم تشفيره مرتين للإعلان. استخدِم هذا الإجراء بدلاً من `CLICK_URL_UNESC` إذا كنت بحاجة إلى تمرير القيمة أولاً عبر خادم آخر سيعرض بعد ذلك إعادة توجيه. على سبيل المثال، يمكن استخدام الرمز البرمجي التالي في مقتطف HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> في وقت عرض الإعلان، يتم توسيع هذا النطاق ليشمل ما يلي: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	يتم توسيعه إلى `http:` إذا كان طلب عروض الأسعار لا يتطلّب طبقة المقابس الآمنة (SSL) أو إلى `https:` إذا كان طلب عروض الأسعار يتطلّب طبقة المقابس الآمنة (SSL).
`SITE`	النطاق الذي تم ترميزه لعنوان URL للمحتوى أو المعرّف المجهول للمستودع الإعلاني المجهول
`SITE_URL`	تمّ الإيقاف. تم استبداله بالرمز الموسّع SITE الذي يقدّم وظيفة مماثلة.
`TZ_OFFSET`	معادلة المنطقة الزمنية
`VERIFICATION`	القيم المختلفة للإنتاج ووقت فحص تصميم الإعلان في مسار التحقّق التنسيق هو: `%%?VERIFICATION:true-val:false-val%%` حيث يمكن استخدام أي قيم باستثناء الوحدات النمطية لكل من `true-val` و `false-val`، بما في ذلك السلاسل الفارغة. بالنسبة إلى عروض الأسعار المفتوحة، ننصحك بأن تستخدم البورصات هذه الماكرو. وبعد إجراء ذلك، لن تحتاج منصات العميل إلى إجراء تغييرات. على سبيل المثال، إذا كان تصميم الإعلان يتضمّن `%%?VERIFICATION:-1:5000%%`، سيكون `5000` هو بديل النص عند عرض الإعلان و`-1` في مسار التحقّق. يهدف ذلك إلى المساعدة في التفريق بين هذين مجموعتَي الإشعارات.
`WINNING_PRICE`	تكلفة مرّة الظهور المشفّرة (أي التكلفة لكل تثبيت بدلاً من التكلفة لكل ألف ظهور) في الميكرو من عملة الحساب على سبيل المثال، التكلفة الفائزة لكل ألف ظهور التي تبلغ 5 دولار أمريكي تتوافق مع 5,000,000 تكلفة لكل ألف ظهور في الميكرو، أو 5,000 تكلفة لكل تثبيت في الميكرو. ستكون القيمة المرمّزة لرمز `WINNING_PRICE` في هذه الحالة 5,000. يتم تحديد السعر الفائز بوحدة التكلفة لكل تثبيت. لتحليل هذه الوحدات النمطية، عليك تنفيذ تطبيق يرمز ويفك ترميز تأكيدات الأسعار. يُرجى الرجوع إلى صفحة فك تشفير تأكيدات الأسعار للحصول على مزيد من المعلومات.
`WINNING_PRICE_ESC`	`WINNING_PRICE` التي تم ترميزها لتكون صالحة لعنوان URL

تشترط Google استخدام إحدى الوحدات النمطية CLICK_URL_UNESC أو CLICK_URL_ESC في تصميم الإعلان المعروض التابع لجهة خارجية. تستخدِم Google وحدات الماكرو CLICK_URL لتتبُّع النقرات.

يستخدم ترميز عنوان URL في وحدات الماكرو المخطط التالي:

يتم استبدال حرف المسافة بعلامة الجمع (+).
تظل الأحرف الأبجدية الرقمية (0-9 وa-z وA-Z) والأحرف من المجموعة !(*،-./:_~ بدون تغيير.
يتم استبدال جميع الأحرف الأخرى بـ %XX، حيث يكون XX هو الرقم السداسي الذي يمثّل الحرف.

القيود المفروضة على الناشرين والمتطلبات التي يجب استيفاؤها

يتضمّن طلب عرض السعر معلومات عن أنواع القيود وال requirements التي يفرضها الناشرون على تصميمات الإعلانات في المزاد.

BidRequest.bcat
- يمكنك مقارنة الفئات المحظورة المحدّدة في هذا الحقل بتلك التي تم رصدها لتصاميم الإعلانات التي تم إرسالها باستخدام حقل detectedCategories في واجهة برمجة التطبيقات Real-time Bidding API.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
- في الممارسة العملية، سيتم ضبط هذا الخيار دائمًا على true لأنّه تشترط Google توفُّر طبقة المقابس الآمنة (SSL) لجميع تصميمات الإعلانات.
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes

لا تقدِّم أبدًا عروض أسعار باستخدام إعلان يتضمّن ميزة محظورة. بالنسبة إلى الميزات المسموح بها، مثل نوع المورّد، لا تعرض إعلانًا إلا إذا كان نوع المورّد مُدرَجًا في قائمة allowed_vendor_type ضمن BidRequest. يجب عدم تضمين سوى التنسيقات الإعلانية المحدّدة في طلب عرض الأسعار من خلال تعبئة حقول مثل BidRequest.imp.banner في عرض أسعارك. اطّلِع على مزيد من التفاصيل في ملف تعريف BidRequest الخاص بحقل ملف تخزين بروتوكول BidRequest.

إذا تم عرض إعلان في BidResponse، عليك ضبط حقلَي BidResponse.seatbid.bid.attr و BidResponse.seatbid.bid.cat وأحد الحقلين BidResponse.seatbid.bid.adomain أو BidResponse.seatbid.bid.adm_native.link.url بدقة في BidResponse. إذا كان الإعلان يتضمّن قيمًا متعددة سارية لهؤلاء الحقول، يجب تضمين كل قيمة. اطّلِع على التعليقات لهذه الحقول في تعريف ملف تخزين بروتوكول BidResponse للحصول على مزيد من التفاصيل. ويتم تجاهل الردود التي لم يتم ضبط هذه الحقول فيها.

القياس المفتوح

تتيح لك ميزة "القياس المفتوح" تحديد مورّدين خارجيين يوفّرون خدمات مستقلة لقياس الأداء والتحقّق من المعلنين للإعلانات التي يتم عرضها في بيئات التطبيقات المتوافقة مع الأجهزة الجوّالة.

تشمل أشكال الإعلانات المتاحة إعلانات الفيديو وإعلانات البانر والإعلانات البينية. لمزيد من المعلومات عن كيفية استخدام "القياس المفتوح" في ردّ عرض سعر يحتوي على هذه التنسيقات، يُرجى الرجوع إلى مقالة مجموعة تطوير البرامج (SDK) لبرنامج "القياس المفتوح" في مركز المساعدة.

أمثلة على الاستجابات لعروض الأسعار

تعرض الأقسام التالية نماذج من ردود عروض الأسعار لأنواع الإعلانات المختلفة.

OpenRTB Protobuf

عرض المثال

الاستجابة التسلسلية

id: "4308k26S0C36XQ2z1dIo99"
seatbid {
  bid {
    id: "y2OcJw5j213rO95Gz78"
    impid: "1"
    price: 18.360865389304116
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    crid: "test_creative_id_391487"
    dealid: "1"
    w: 390
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      ad_choices_destination_url: "https://test.com/preferences"
      billing_id: 82364411103
      skadn {
        version: "4.0"
        network: "cF58w81X"
        itunesitem: "788729094"
        sourceapp: "1422994973"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "017e597c-3c7d-4a44-afeb-41cd9a17066f"
          timestamp: "1757235407882"
          signature: "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "017e597c-3c7d-4a44-afeb-41cd9a17066f"
          timestamp: "1757235407882"
          signature: "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
        }
        sourceidentifier: "5507"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
      clickurl: "example.com"
    }
  }
  seat: "2542:1534:245840"
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 3
}

ملف JSON في OpenRTB

عرض المثال

{
  "id": "4308k26S0C36XQ2z1dIo99",
  "seatbid": [
    {
      "bid": [
        {
          "id": "y2OcJw5j213rO95Gz78",
          "impid": "1",
          "price": 18.360865389304116,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "crid": "test_creative_id_391487",
          "dealid": "1",
          "w": 390,
          "h": 60,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456"
            ],
            "ad_choices_destination_url": "https://test.com/preferences",
            "billing_id": "82364411103",
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1,
            "clickurl": [
              "google.com",
              "example.com"
            ]
          }
        }
      ],
      "seat": "2542:1534:245840"
    }
  ],
  "ext": {
    "processing_time_ms": 3
  }
}

إعلان بيني داخل التطبيق

OpenRTB Protobuf

عرض المثال

الاستجابة التسلسلية

id: "U0t6Une80802A28Mi98o1t"
seatbid {
  bid {
    id: "300z78I726nCP7u4sFp"
    impid: "1"
    price: 149.83914184570312
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    crid: "test_creative_id_732353"
    dealid: "0"
    w: 360
    h: 715
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 68640308112
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 10
}

ملف JSON في OpenRTB

عرض المثال

{
  "id": "U0t6Une80802A28Mi98o1t",
  "seatbid": [
    {
      "bid": [
        {
          "id": "300z78I726nCP7u4sFp",
          "impid": "1",
          "price": 149.83914184570312,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "crid": "test_creative_id_732353",
          "dealid": "0",
          "w": 360,
          "h": 715,
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "68640308112",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 10
  }
}

إعلان فيديو بيني داخل التطبيق

OpenRTB Protobuf

عرض المثال

الاستجابة التسلسلية

id: "n40G42d551UX18627ao8lt"
seatbid {
  bid {
    id: "17u6BnD62h88r5q7066"
    impid: "1"
    price: 0.797848
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_987914"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 55383762512
      skadn {
        version: "4.0"
        network: "306el65O"
        itunesitem: "832461214"
        sourceapp: "977150768"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
        }
        sourceidentifier: "8396"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 20
}

ملف JSON في OpenRTB

عرض المثال

{
  "id": "n40G42d551UX18627ao8lt",
  "seatbid": [
    {
      "bid": [
        {
          "id": "17u6BnD62h88r5q7066",
          "impid": "1",
          "price": 0.797848,
          "adm": "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_987914",
          "w": 320,
          "h": 480,
          "cattax": 500,
          "ext": {
            "attribute": [
              47,
              50
            ],
            "billing_id": "55383762512",
            "skadn": {
              "version": "4.0",
              "network": "306el65O",
              "itunesitem": "832461214",
              "sourceapp": "977150768",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0054e0b9-0b53-4426-99dd-a1eefeb45565",
                  "timestamp": "1757329316673",
                  "signature": "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
                },
                {
                  "fidelity": 1,
                  "nonce": "0054e0b9-0b53-4426-99dd-a1eefeb45565",
                  "timestamp": "1757329316673",
                  "signature": "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
                }
              ],
              "sourceidentifier": "8396"
            },
            "app_promotion_type": 1,
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "ext": {
    "processing_time_ms": 20
  }
}

التطبيق الأصلي

OpenRTB Protobuf

عرض المثال

الاستجابة التسلسلية

id: "96Z599PGNvp7Mr99138Fm0"
seatbid {
  bid {
    id: "NQb32Ge7Rtt84wFn2p8"
    impid: "1"
    price: 0.153584
    adid: "test_creative_id_272596"
    adomain: "google.com"
    crid: "test_creative_id_272596"
    cat: "IAB13-7"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      link {
        url: "https://www.google.com"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      ad_choices_destination_url: "https://test.com/preferences"
      billing_id: 29846056590
      dsa {
        behalf: "TEST_ADVERTISER"
        paid: "TEST_PAYING_ENTITY"
        adrender: false
      }
    }
  }
  bid {
    id: "4vwb23qm6iqU6w6G978"
    impid: "1"
    price: 0.153584
    adid: "test_creative_id_272596"
    adomain: "google.com"
    crid: "test_creative_id_272596"
    cat: "IAB21"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      link {
        url: "https://www.google.com"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      ad_choices_destination_url: "https://test.com/preferences"
      dsa {
        behalf: "TEST_ADVERTISER"
        paid: "TEST_PAYING_ENTITY"
        adrender: false
      }
    }
  }
  seat: "4528:1161:591635"
  group: false
}
bidid: "hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC"
cur: "USD"

ملف JSON في OpenRTB

عرض المثال

{
  "id": "96Z599PGNvp7Mr99138Fm0",
  "seatbid": [
    {
      "bid": [
        {
          "id": "NQb32Ge7Rtt84wFn2p8",
          "impid": "1",
          "price": 0.153584,
          "adid": "test_creative_id_272596",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_272596",
          "cat": [
            "IAB13-7"
          ],
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "ad_choices_destination_url": "https://test.com/preferences",
            "billing_id": "29846056590",
            "dsa": {
              "behalf": "TEST_ADVERTISER",
              "paid": "TEST_PAYING_ENTITY",
              "adrender": 0
            }
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        },
        {
          "id": "4vwb23qm6iqU6w6G978",
          "impid": "1",
          "price": 0.153584,
          "adid": "test_creative_id_272596",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_272596",
          "cat": [
            "IAB21"
          ],
          "burl": "https://test.com/imp?id=123456",
          "ext": {
            "ad_choices_destination_url": "https://test.com/preferences",
            "dsa": {
              "behalf": "TEST_ADVERTISER",
              "paid": "TEST_PAYING_ENTITY",
              "adrender": 0
            }
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        }
      ],
      "seat": "4528:1161:591635",
      "group": 0
    }
  ],
  "bidid": "hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC",
  "cur": "USD"
}

فيديو ويب

OpenRTB Protobuf

عرض المثال

الاستجابة التسلسلية

id: "04XK8XoQI227314y42h0LL"
seatbid {
  bid {
    id: "R9TtHE88cGu48FA4DuG"
    impid: "1"
    price: 1.0523000955581665
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    crid: "test_creative_id_400281"
    dealid: "45957820"
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 63495119434
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 11
}

ملف JSON في OpenRTB

عرض المثال

{
  "id": "04XK8XoQI227314y42h0LL",
  "seatbid": [
    {
      "bid": [
        {
          "id": "R9TtHE88cGu48FA4DuG",
          "impid": "1",
          "price": 1.0523000955581665,
          "adm": "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%",
          "crid": "test_creative_id_400281",
          "dealid": "45957820",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "63495119434",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          }
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 11
  }
}

OpenRTB Protobuf

عرض المثال

الاستجابة التسلسلية

id: "l30Zu42070Man1Z5u751yG"
seatbid {
  bid {
    id: "4X6uu65F9J3m467C571"
    impid: "1"
    price: 0.17
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    crid: "test_creative_id_941528"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 50962964480
    }
  }
  seat: "7632:7504:809671"
}
bidid: "II638Xkf-6432F06d-VGu8-27B4407D136w"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 70
}

ملف JSON في OpenRTB

عرض المثال

{
  "id": "l30Zu42070Man1Z5u751yG",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4X6uu65F9J3m467C571",
          "impid": "1",
          "price": 0.17,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_941528",
          "w": 320,
          "h": 50,
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ],
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "50962964480"
          }
        }
      ],
      "seat": "7632:7504:809671"
    }
  ],
  "bidid": "II638Xkf-6432F06d-VGu8-27B4407D136w",
  "ext": {
    "processing_time_ms": 70
  }
}

بناء الرد تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إنشاء رسالة BidResponse

الرقم التعريفي لتصميم الإعلان

سمات الإعلان

حقول "عرض الأسعار المفتوح"

اقتراحات

مثال على استجابة عرض السعر

OpenRTB Protobuf

عرض المثال

ملف JSON في OpenRTB

عرض المثال

تحديد تصميم الإعلان

تحديد وحدات الماكرو

وحدات الماكرو من Google

القيود المفروضة على الناشرين والمتطلبات التي يجب استيفاؤها

القياس المفتوح

أمثلة على الاستجابات لعروض الأسعار

بانر التطبيق

OpenRTB Protobuf

عرض المثال

ملف JSON في OpenRTB

عرض المثال

إعلان بيني داخل التطبيق

OpenRTB Protobuf

عرض المثال

ملف JSON في OpenRTB

عرض المثال

إعلان فيديو بيني داخل التطبيق

OpenRTB Protobuf

عرض المثال

ملف JSON في OpenRTB

عرض المثال

التطبيق الأصلي

OpenRTB Protobuf

عرض المثال

ملف JSON في OpenRTB

عرض المثال

فيديو ويب

OpenRTB Protobuf

عرض المثال

ملف JSON في OpenRTB

عرض المثال

إعلان بانر على الويب للأجهزة الجوّالة لمقدّم عروض الأسعار في التبادل

OpenRTB Protobuf

عرض المثال

ملف JSON في OpenRTB

عرض المثال

بناء الرد