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

بناء الرد

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

إنشاء رسالة BidResponse

يرسل "الشراة المعتمَدون" BidRequest باعتباره نص رسالة POST لبروتوكول HTTP. يجب أن يتضمن الاستجابة التي يرسلها تطبيقك عنوان 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 المعلَن وسمات المواد الإبداعية وأنواع المورّدين. بعبارة أخرى، يجب توفير أرقام تعريفية مختلفة لتصميمات الإعلانات لأي إعلانين:

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

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

سمات الإعلان

يجب أن تذكر سمات تصميم الإعلان التي تصف خصائص الإعلان واستهدافه بالكامل في 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 ليتم عرضه.

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

34 RichMediaCapabilityType: RichMediaCapabilityFlash
يتطلّب الإعلان توافقًا مع Flash ليتم عرضه.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
ولا يتطلّب الإعلان فلاش لعرضه.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
يمكن عرض الإعلان على صفحة طبقة المقابس الآمنة (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 من ذلك خلال اختبارات وقت الاستجابة الأولية لتطبيقك، لأنّ "الشراة المعتمَدون" يرسلون الطلبات بمعدل عالٍ ويحتاجون إلى تجنُّب وقت الاستجابة الإضافي لإنشاء اتصال منفصل عبر بروتوكول التحكم بالنقل لكل طلب.
أدرِج عنوان 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: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

OpenRTB JSON

عرض المثال

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "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"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

نموذج OpenRTB Protobuf

عرض المثال

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    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: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

ملاحظة مهمّة: يتم هنا تمثيل رسائل 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:` إذا كان طلب عرض السعر لا يتطلّب طبقة المقابس الآمنة أو إلى `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` في هذه الحالة هي 5,000. يتم تحديد السعر الفائز في التكلفة لكل تثبيت.
`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 API.
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
الإعلانات التي تهدف إلى حث المستخدمين على النقر عليها من خلال إثارة فضولهم، وغالبًا ما تستخدم رسالة محفّزة تحتوي على لغة أو صور مبالغ فيه. يشمل ذلك الإعلانات التي ترتكز على مواضيع تثير المشاعر (مثل الاعتقالات والوفاة والطلاق التي تتعلق بالمشاهير) أو الإعلانات التي تهدف إلى إحداث صدمة.

فتح عملية القياس

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

تتضمن أشكال الإعلانات المتوافقة حاليًا إعلانات الفيديو وإعلانات البانر والإعلانات البينية. لمزيد من المعلومات عن كيفية استخدام Open Measurement في استجابة عرض أسعار تحتوي على هذه الأشكال، يُرجى الرجوع إلى مقالة فتح حزمة تطوير البرامج (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: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

OpenRTB JSON

عرض المثال

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "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>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

نموذج OpenRTB Protobuf

عرض المثال

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    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: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
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: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

OpenRTB JSON

عرض المثال

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "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": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

نموذج OpenRTB Protobuf

عرض المثال

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    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: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

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

Google

عرض المثال

ad {
  adslot {
    id: 1
    max_cpm_micros: 830000
    billing_id: 45806415189
    buyer_reporting_id: "T7f433l"
  }
  click_through_url: "google.com"
  attribute: 47
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_596030"
  width: 640
  height: 360
  event_notification_token: "token"
}
processing_time_ms: 9

نموذج 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: 80000
    billing_id: 52511964331
    deal_id: 1
  }
  click_through_url: "google.com"
  attribute: 70
  buyer_creative_id: "test_creative_id_287513"
  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: 1200
      height: 627
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 100
      height: 100
    }
    star_rating: 4.800000190734863
    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"
  event_notification_token: "token"
  skadn {
    version: "3.0"
    network: "Ft98iS7c"
    campaign: 31947859
    itunesitem: "305656909"
    sourceapp: "531025541"
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
    }
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
    }
  }
  click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
  advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57

OpenRTB JSON

عرض المثال

{
  "id": "w68lr2H3Q9S8mAc18QP2wp",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4VF8803Y5b4314j072f",
          "impid": "1",
          "price": 0.01575,
          "adm": "{\"ver\": \"1.2\", \"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\"}}, {\"id\": 4, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adid": "test_creative_id_546056",
          "adomain": [
            "google.com"
          ],
          "cid": "19851733647",
          "crid": "test_creative_id_546056",
          "cat": [
            "IAB9-25"
          ],
          "w": 1200,
          "h": 627,
          "ext": {
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "7859:5415:609992"
    }
  ],
  "bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
  "cur": "USD"
}

نموذج OpenRTB Protobuf

عرض المثال

id: "a504l3y62599Xv09173V2Z"
seatbid {
  bid {
    id: "jP1Ok7b46T9p789v6R2"
    impid: "1"
    price: 0.1680304792439826
    adid: "test_creative_id_620230"
    adomain: "google.com"
    cid: "74994669337"
    crid: "test_creative_id_620230"
    w: 1200
    h: 627
    adm_native {
      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
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/icon?id=123456"
          w: 128
          h: 128
        }
      }
      assets {
        id: 6
        data {
          value: "5"
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 74994669337
      skadn {
        version: "3.0"
        network: "46L6RQ79"
        campaign: "17432314"
        itunesitem: "782565581"
        nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
        sourceapp: "187789793"
        timestamp: ""
        signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
        }
      }
    }
  }
  seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
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: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    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: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}

بناء الرد

إنشاء رسالة 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

عرض المثال