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

بناء الرد

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

إنشاء رسالة BidResponse بتنسيق Protobuf

يرسل "الشراة المعتمَدون" BidRequest كنص لرسالة وهو HTTP من نوع POST. إذا تم ضبط نقطة نهاية عروض الأسعار على استخدام Protobuf، يجب أن يرسل تطبيقك ردًا تم ضبط عنوان Content-Type على application/octet-stream. ونص رسالة يتكون من مخزن بروتوكول مؤقت تسلسلي. البروتوكول المخزن المؤقت عبارة عن رسالة BidResponse كما هو محدد في openrtb.proto يجب أن يعرض التطبيق عنصرًا قابلاً للتحليل BidResponse ردًا على كل BidRequest. إنّ حالات انتهاء مهلة الانتظار والردود التي لا يمكن تحليلها تُعدّ أخطاء، وتعمل Google على الحدّ من عروض الأسعار التي تسجّل معدّلات أخطاء عالية.

إذا كنت لا تريد تقديم عرض سعر لمرة ظهور، يمكنك تحديد حقل واحد (BidResponse.ext.processing_time_ms) فقط، وإبقاء الكل الحقول الأخرى فارغة. يمكنك الحصول على openrtb.proto من البيانات المرجعية.

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

يحدد 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 للإعلان عن هذه السمات.

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

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

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

OpenRTB	الشراة المعتمَدون	التفاصيل
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	معرّف الصفقة من مساحة اسم تبادل الإعلانات المرتبط بهذه المحاولة الإجرائية ويكون مُدرَجًا في تقارير الناشرين. ملاحظة: يتم إرسال هذا الحقل فقط إلى المشاركين المغلقين في الإصدار التجريبي.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	نوع الصفقة التي يتم الإبلاغ عنها للناشرين، ما يؤثّر في كيفية التعامل مع الصفقة في المزاد ملاحظة: لا يتم إرسال هذا الحقل إلا إلى المشاركين في الإصدار التجريبي المغلق.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].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: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    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"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [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: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

OpenRTB JSON

عرض المثال

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "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"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

Google

عرض المثال

ad {
  html_snippet: "<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>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

ملاحظة مهمة: رسائل Protobuf الموضحة في يتم تمثيل العينات هنا كنص يمكن للإنسان قراءته. ومع ذلك، هذه ليست الطريقة يتم إرسال الرسائل عبر السلك. عند استخدام تنسيق Google أو 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عرضه بشكل صحيح، ولكن عليك مراعاة القيود المفروضة على تحديد الحقل crid في القسم إنشاء رسالة BidResponse. ومن بين استخدامات ذلك وضع معلومات إضافية في وسيطات عناوين URL التي يتم جلبها من خوادمك كجزء من عرض الإعلان يتيح لك هذا الإجراء بيانات عشوائية حول الظهور إلى خوادمك الخاصة.

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

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

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

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

BidResponse.seatbid.bid.adm

يمكن استخدام وحدات الماكرو لمقتطف HTML والإعلانات المدمجة مع المحتوى وعنوان URL للفيديو ونموذج عرض إعلانات الفيديو بتنسيقات XML:
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

وحدات ماكرو لعرض الأسعار في الوقت الفعلي (RTB) من Google

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

ماكرو	الوصف
`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`. هذا يفترض أن يغني `my.adserver.com` عن مَعلمة `google_click_url`. يمكنك إلحاق عنوان 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 إلى النظام السداسي العشري. رقم يمثل الحرف.

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

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

BidRequest.bcat
- يمكنك مقارنة الفئات المحظورة المحددة في هذا الحقل بتلك التي تم رصدها لتصاميم الإعلانات التي أرسلتها باستخدام واجهة برمجة تطبيقات "عرض الأسعار في الوقت الفعلي" detectedCategories.
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 تعريف للحصول على مزيد من التفاصيل.

إذا تم عرض إعلان في 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: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    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"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

OpenRTB JSON

عرض المثال

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "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"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

Google

عرض المثال

ad {
  html_snippet: "<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>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

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

بروتوكول OpenRTB Protobuf

عرض المثال

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    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"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

OpenRTB JSON

عرض المثال

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "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"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

Google

عرض المثال

ad {
  html_snippet: "<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>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

الفيديو البيني للتطبيق

OpenRTB Protobuf

عرض المثال

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Google

عرض المثال

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

إعلان مدمج مع المحتوى للتطبيق

OpenRTB Protobuf

عرض المثال

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

OpenRTB JSON

عرض المثال

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

Google

عرض المثال

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

فيديو ويب

Google

عرض المثال

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

بروتوكول OpenRTB Protobuf

عرض المثال

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    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"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    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: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

بناء الرد

إنشاء رسالة BidResponse بتنسيق Protobuf

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

سمات الإعلان

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

اقتراحات

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

بروتوكول OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

Google

عرض المثال

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

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

وحدات ماكرو لعرض الأسعار في الوقت الفعلي (RTB) من Google

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

فتح القياس

نماذج للردود على عروض الأسعار

بانر التطبيق

بروتوكول OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

Google

عرض المثال

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

بروتوكول OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

Google

عرض المثال

الفيديو البيني للتطبيق

OpenRTB Protobuf

عرض المثال

Google

عرض المثال

إعلان مدمج مع المحتوى للتطبيق

OpenRTB Protobuf

عرض المثال

OpenRTB JSON

عرض المثال

Google

عرض المثال

فيديو ويب

Google

عرض المثال

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

بروتوكول OpenRTB Protobuf

عرض المثال