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

بناء الرد

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

إنشاء رسالة BidResponse

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

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

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

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

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

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

سمات الإعلان

يجب الإفصاح عن سمات تصميمات الإعلانات التي تصف بشكلٍ كامل سمات تصميم الإعلان. واستهدافه في BidResponse.Ad.attribute. تشير رسالة الأشكال البيانية التي يجب الإفصاح عنها هي (راجع أيضًا القائمة الكاملة للسمات السمات في buyer-declarable-creative-attributes.txt):

7 Tagging: IsTagged
يحتوي الإعلان على بكسل أو إشارة ويب لغرض إنشاء قائمة بأرقام تعريف ملفات تعريف الارتباط لعملية إعادة التسويق اللاحقة.
8 Remarketing: IsRemarketing
يستهدف الإعلان المستهلكين بناءً على معرّف ملف تعريف الارتباط أو رقم تعريف الجهاز حيث تمثل قائمة معرّفات ملفات تعريف الارتباط أو أرقام تعريف الأجهزة مجموعة من المستهلكين تفاعلت سابقًا مع موقع يمتلكه المشتري أو يمثله.
9 UserInterestTargeting: IsUserInterestTargeted
يستهدف الإعلان المستهلكين بناءً على معرّف ملف تعريف الارتباط أو رقم تعريف الجهاز حيث تمثل قائمة معرّفات ملفات تعريف الارتباط أو رقم تعريف الجهاز مجموعة من المستهلكين الذين محددة على أنها مجموعة اهتمام مشتركة.
30 InstreamVastVideoType: Vpaid
يتطلب الإعلان دعم VPAID حتى يتم عرضه.
32 MraidType: MRAID
يتطلب الإعلان عرض واجهة برمجة تطبيقات MRAID.

بالإضافة إلى ذلك، يمكن استخدام السمات التالية، إلا أنّ تعريفها غير مطلوب، لأنّ "الشراة المعتمَدون" يكتشفونه تلقائيًا، وسيحظرونه (أو تصاميم الإعلانات استنادًا إلى القيم المكتشفة، بدلاً من بيانك. عرض Creatives API للحصول على شرح حول كيفية الحصول على تعليقات حول الخصائص التي تم اكتشافها من الإبداعية.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
يتطلب عرض الإعلان دعم الفلاش.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
لا يتطلب الإعلان عرض Flash.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
يمكن عرض الإعلان على صفحة تستخدم طبقة المقابس الآمنة. تجدر الإشارة إلى أنّ "الشراة المعتمَدون" يتعاملون مع تصاميم الإعلانات. ذات قيم معرَّفة مختلفة لهذه السمة على أنّها مميّزة (ستتم مراجعتها بشكل منفصل ولها حالة موافقة مختلفة). وبالتالي، إذا قدّمت عرض أسعار باستخدام كلٍّ من طبقة المقابس الآمنة (SSL) للإصدارات غير المحمية بطبقة المقابس الآمنة (SSL) لتصميم الإعلان نفسه، يجب تعريف هذه السمة وفقًا لذلك، لكي ينعكس هذا الفارق بشكل صحيح في AdX.

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

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

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 2.5 أو إصدار أعلى، يتم عرض الحقل العادي لذلك هو BidResponse.seatbid[].bid[].burl.
حافظ على عدم استخدام رمز نظام عروض الأسعار في الحقول المتوقّفة نهائيًا، ما قد يؤدي إلى فشل عروض الأسعار مع حدوث أخطاء.
تضمين BidResponse.Ad.width و BidResponse.Ad.height في BidResponse. حاسمة يجب إدخال قيمة BidResponse إلى طلب يتضمن أحجام إعلانات متعددة تضمين القيمتين width وheight أو سيتم انخفاضها من المزاد.
يجب أن يكون حجم الردّ أقلّ من 8 آلاف. قد تزيد الردود الكبيرة جدًا وقت استجابة الشبكة ويتسبب في انتهاء المهلات.
اتبع إرشادات عروض الأسعار على مستودع iOS الإعلاني الذي يتطلّب تحديد مصدر SKAdNetwork.

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

تمثل الأمثلة التالية عينات يمكن للإنسان قراءتها من Protobuf طلبات JSON.

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

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

بروتوكول 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
}

ملاحظة مهمة: رسائل 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.Ad.sdk_rendered_ad
تنسيق AMP
- BidResponse.Ad.amp_ad_url
الفيديوهات
- BidResponse.Ad.video_url أو
- BidResponse.Ad.video_vast_xml
مدمج مع المحتوى
- BidResponse.Ad.native_ad

تحديد إعلان مستضاف على خادمك(خوادمك) باستخدام مقتطف HTML في الحقل html_snippet من BidResponse. تشير رسالة الأشكال البيانية يتم تضمين المقتطف في إطار iFrame مُدرج في صفحة الويب، مما يؤدي إلى ظهور يتم استردادها وعرضها عند تحميل الصفحة. يجب عليك صياغة HTML بحيث يتم عرض الإعلان (بانر أو بيني) بشكل صحيح داخل إطار iframe، بحجم مناسب للخانة الإعلانية التي تقدّم عرض سعر لها.

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

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

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

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

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

يمكن أن يتضمن مقتطف HTML الذي يحدد تصميم الإعلان عنصرًا خاصًا أو أكثر إنشاءات تسمى وحدات الماكرو. وفي وقت عرض الإعلان، يتم استبدال القيم وحدات الماكرو. على سبيل المثال، يمكن أن يستخدم تطبيق عروض أسعار العملاء WINNING_PRICE ماكرو لتحديد المبلغ الذي دفعه مقابل الإعلان، إذا فازت بالمزاد لتحليل وحدة الماكرو هذه، ستحتاج إلى تنفيذ يفك تشفير تأكيدات الأسعار. مراجعة مقالة سعر فك التشفير التأكيدات للحصول على مزيد من المعلومات.

تحديد وحدة ماكرو كجزء من مقتطف HTML بالتنسيق %%MACRO%%، حيث يُعد MACRO أحد خيارات الدعم المتوافقة وحدات الماكرو المدرجة في الجدول أدناه.

ملاحظة: بالنسبة إلى الردود على عروض أسعار إعلانات AMP (amp_ad_url)، فقط تُعد WINNING_PRICE وWINNING_PRICE_ESC وحدة ماكرو

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

لاستخدام وحدة ماكرو، يجب تضمينها في الإعلان بحيث يتم جلب عنوان URL عند ينقر فوقه شخص ما. القيمة التي تعرضها الجلب هي إعادة توجيه إلى صفحة أخرى تمثّل هذه السمة عنوان URL الذي تُلحقه بالسمة CLICK_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:` إذا كان طلب عرض السعر يتطلب طبقة المقابس الآمنة.
`SITE`	نطاق يتضمن حروف إلغاء عنوان URL لعنوان 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` في هذه الحالة ستكون 5000. ويتم تحديد السعر الفائز في التكلفة لكل تثبيت.
`WINNING_PRICE_ESC`	`WINNING_PRICE` الذي يتضمن حروف إلغاء عنوان URL

تستخدم ميزة إلغاء عنوان URL في وحدات الماكرو النظام التالي:

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

قيود الناشر

يستخدم الناشرون BidRequest لفرض قيود على أنواع الإعلانات. التي ستسمح بها. يجب فرض القيود في هذه الحقول:

allowed_vendor_type
excluded_attribute
excluded_sensitive_category

يحدّد أحد الحقول الميزات المسموح بها للإعلان والحقل الآخر غير مسموح بها. عدم عرض إعلان يحتوي على ميزة غير مسموح بها مطلقًا. مسموح به مثل نوع المورد، لا تعرض إعلانًا إلا إذا كان نوع المورد في قائمة "allowed_vendor_type" في BidRequest يمكنك الاطّلاع على تعليقات على هذه الحقول في المخزن المؤقت لبروتوكول BidRequest تعريف للحصول على مزيد من التفاصيل.

في حال عرض مقتطف HTML بلغة BidResponse، يعني ذلك أنّك: مطلوبة لضبط attribute وcategory بدقة وclick_through_url في BidResponse. في حال تضمّن الإعلان عدة قيم قابلة للتطبيق لهذه الحقول، يجب: تضمين كل قيمة. يمكنك الاطّلاع على التعليقات على هذه الحقول في تعريف المخزن المؤقت لبروتوكول BidResponse لمزيد من التفاصيل ويتم تجاهل الردود التي لم يتم ضبط هذه الحقول لها.

القيم المحتملة لـ BidRequest.excluded_attribute هي (اطّلِع على publisher-excludable-creative-attributes.txt):

7 Tagging: IsTagged
لا يُسمح بالإعلانات إذا كانت تحتوي على بكسل أو إشارة ويب لغرض إنشاء قائمة معرّفات ملفات تعريف الارتباط لعمليات إعادة التسويق اللاحقة.
8 CookieTargeting: IsCookieTargeted
لا يُسمح بالإعلانات إذا كانت تستهدف مستهلكين استنادًا إلى رقم تعريف ملفات تعريف الارتباط حيث تمثل قائمة أرقام تعريف ملفات تعريف الارتباط مجموعة من المستهلكين الذين سبق لهم التفاعل مع موقع يمتلكه المشتري أو يمثله.
9 UserInterestTargeting: IsUserInterestTargeted
لا يُسمح بالإعلانات إذا كانت تستهدف مستهلكين استنادًا إلى رقم تعريف ملفات تعريف الارتباط حيث تمثل قائمة أرقام تعريف ملفات تعريف الارتباط مجموعة من المستهلكين الذين عرّفهم المشتري بأنّهم مجموعة مصالح مشتركة.
21 CreativeType: Html
لا يُسمح للإعلانات باستخدام html_snippet أو snippet_template في BidResponse.Ad.
22 CreativeType: VastVideo
لا يُسمح للإعلانات باستخدام الحقل video_url في BidResponse.Ad.
30 InstreamVastVideoType: Vpaid
لا يُسمح للإعلانات بطلب دعم VPAID لعرضها.
32 MraidType: MRAID
لا يُسمح للإعلانات بطلب عرض واجهة برمجة تطبيقات MRAID.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
لا يجوز أن تتطلب الإعلانات دعم Flash لعرضها.
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
لا يُسمح للإعلانات بطلب ميزات HTML5 لعرضها.
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
غير مسموح للإعلانات بتقديم طلبات غير مستندة إلى طبقة المقابس الآمنة (SSL).

وبالتالي، إذا كان الحقل excluded_attribute يحتوي على القيمة 7، يجب ألا تعرض إعلانًا يستخدم وحدة بكسل أو إشارة ويب إنشاء قائمة. ويُرجى العلم بأنّه إذا أجرى أحد الإعلانات ذلك، يجب ضبط القيمة 7 في حقل السمة BidResponse. وبالمثل، إذا كان الحقل excluded_attribute يحتوي على القيمة 48، فيجب عليك أن تعرض فقط الإعلانات التي يمكن عرضها على صفحة طبقة المقابس الآمنة (وبالتالي)، تعريف السمة 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

وأيضًا لن يكون الحقل excluded_sensitive_category في يستخدم BidRequest الرموز من يتوفّر ملف ad-sensitive-categories.txt على صفحة البيانات المرجعية. تم تمديد الموعد النهائي أوصاف بعض هذه الرموز:

3 Politics
يتضمّن ذلك مسائل سياسية أو مسائل اجتماعية مثيرة للجدل. لا يتضمّن إعلانات لمؤسسات إخبارية لا ترتبط بشكل عام بوجهة نظر حزبية بشأن المسائل المطروحة.
4 Dating
تشمل خدمات المواعدة ومنتديات المواعدة على الإنترنت.
5 Religion
تتضمّن إعلانات دينية وإعلانات تدعم أو تناهض آراءً دينية لا يشمل التنجيم أو الروحانيات غير المذهبية.
7 Video Games (Casual & Online)
تتضمّن ألعاب الفيديو والألعاب على الإنترنت والألعاب القابلة للتنزيل عن وحدات التحكم بألعاب الفيديو.
8 Ringtones & Downloadables
إضافات الأجهزة الجوّالة، بما في ذلك نغمات الرنين وغيرها من التطبيقات الترفيهية الصغيرة القابلة للتنزيل كشاشات الاستراحة وخلفيات أجهزة الكمبيوتر المكتبية وتصاميم الملف الشخصي ورسومات الشبكات الاجتماعية
10 Get Rich Quick
خطط واعدة لتحقيق أرباح سريعة
18 Weight Loss
بما في ذلك منتجات إنقاص الوزن والحميات الغذائية والمنتجات والبرامج ذات الصلة لا تتضمّن إعلانات عن التغذية الصحية أو اللياقة البدنية العامة.
19 Cosmetic Procedures & Body Modification
يشمل ذلك شد أجزاء من الجسم وإزالة الشحوم والعلاج بأشعة الليزر وإزالة الشعر وزرعه والوشم وتعديل الجسم.
23 Drugs & Supplements:
يشمل ذلك المستحضرات الصيدلانية والفيتامينات والمكملات الغذائية وبائعي التجزئة ذوي الصلة. ولا يتضمّن المصادر التي تقدّم معلومات عن الأدوية.
24 Sexual & Reproductive Health
تتضمّن إعلانات الوظائف الجنسية والخصوبة ولا تتضمن موارد الحمل العادية.
35 Social Casino Games
تشمل هذه الفئة محاكاة ألعاب المقامرة (على سبيل المثال لا الحصر، البوكر، وماكينات القمار، والبنغو، واليانصيب، والمراهنات الرياضية، ومراهنات السباقات، بالإضافة إلى ألعاب البطاقات وألعاب أندية المقامرة الأخرى) حيث لا تتوفر فرصة الفوز بأي مكافأة لها قيمة (مثل الأموال أو الجوائز).
36 Significant Skin Exposure
صور إعلانات تُبرز عدم تغطية الملابس لأي جزء من جسم الإنسان بدءًا من عظم الصدر إلى منتصف الفخذ أو ملابس داخلية أو ملابس سباحة أو ملابس داخلية أو غيرها من الملابس الشفافة أو أي قطع غير ملابس، مثل منشفة أو ملاءة سرير
37 Sensationalism
الإعلانات التي تهدف إلى حث المستخدمين على النقر عليها من خلال إثارة فضولهم، وغالبًا ما يتم استخدام رسالة تشويقية تحتوي على لغة أو صور مبالغة. يتضمّن ذلك إعلانات تركّز على مواضيع مثيرة للمشاعر (مثل اعتقال المشاهير أو حالات الوفاة أو حالات الطلاق) أو التي تهدف إلى إحداث صدمة لدى المشاهدين.

فتح القياس

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

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

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

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

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

بروتوكول 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"

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

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

بروتوكول 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"

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

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

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

بروتوكول 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"

فيديو ويب

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

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

سمات الإعلان

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

اقتراحات

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

Google

عرض المثال

OpenRTB JSON

عرض المثال

بروتوكول OpenRTB Protobuf

عرض المثال

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

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

قيود الناشر

فتح القياس

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

بانر التطبيق

Google

عرض المثال

OpenRTB JSON

عرض المثال

بروتوكول OpenRTB Protobuf

عرض المثال

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

Google

عرض المثال

OpenRTB JSON

عرض المثال

بروتوكول OpenRTB Protobuf

عرض المثال

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

Google

عرض المثال

بروتوكول OpenRTB Protobuf

عرض المثال

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

Google

عرض المثال

OpenRTB JSON

عرض المثال

بروتوكول OpenRTB Protobuf

عرض المثال

فيديو ويب

Google

عرض المثال

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

بروتوكول OpenRTB Protobuf

عرض المثال