إنشاء الرد

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

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

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

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

سمات الإعلان

يجب الإعلان عن سمات تصاميم الإعلانات التي تصف سمات الإعلان واستهدافه بالكامل في BidResponse.Ad.attribute. السمات التي يجب الإعلان عنها هي (يمكنك أيضًا الاطّلاع على القائمة الكاملة بالسمات المتوافقة على الرابط owner-delarable-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
    لا يتطلب الإعلان عرض Flash.
  • 47 RichMediaCapabilityType: RichMediaCapabilitySSL
    يمكن عرض الإعلان على صفحة طبقة المقابس الآمنة. يُرجى العلم بأنّ الشراة المعتمَدين يتعاملون مع تصميمات الإعلانات التي تحمل قيمًا مختلفة مُعلَنة لهذه السمة على أنها مختلفة (ستتم مراجعتها بشكل منفصل وتكون لها حالة موافقة مختلفة). وبالتالي، إذا كنت تقدّم عرض سعر باستخدام كلٍّ من إصدار طبقة المقابس الآمنة (SSL) والإصدار الذي لا يستند إلى طبقة المقابس الآمنة (SSL) لتصميم الإعلان نفسه، يجب الإعلان عن هذه السمة وفقًا لذلك، حتى يظهر هذا التمييز بشكل صحيح في AdX.

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

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

عرض الأسعار في الوقت الفعلي (RTB) الشراة المعتمَدون التفاصيل
BidResponse.imp[].pmp.deals[].id BidResponse.ad[].adslot[].exchange_deal_id

رقم تعريف الصفقة من مساحة الاسم Exchange'المرتبطة بعرض السعر هذا ويتم إبلاغ الناشرين به.

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 المستمرة (المعروفة أيضًا باسم &"keep;abalive" أو &"إعادة استخدام الاتصال") على خوادمك. اضبط المهلة على 10 ثوانٍ على الأقل، وتكون القيم الأعلى مفيدة في العديد من الحالات. وتتحقّق Google من ذلك أثناء اختبارات وقت الاستجابة الأولية لتطبيقك، لأنّ الشراة المعتمَدين يرسلون الطلبات بمعدّل مرتفع ويحتاج إلى تجنُّب وقت الاستجابة الزائد لإنشاء اتصال منفصل عبر بروتوكول TCP لكل طلب.
  • أدرِج عنوان URL الاختياري لتتبّع مرات الظهور لتتبّع وقت عرض مرّة الظهور بدلاً من وقت فوز مقدّم عرض السعر. ونظرًا للانسحاب بين عمليات الفوز ومرات العرض، يؤدي ذلك إلى زيادة دقة إحصاءات التتبُّع.

  • حافظ على عدم خضوع رمز نظام عروض الأسعار للاعتماديات على الحقول المتوقّفة، ما يمكن أن يؤدي إلى إخفاق عروض أسعارك في حال حدوث أخطاء.
  • أدرِج BidResponse.Ad.width وBidResponse.Ad.height في BidResponse. ويجب أن تتضمّن السمة BidResponse في طلب يتضمّن أحجام إعلانات متعدّدة القيمتين width وheight، وإلا سيتم استبعادها من المزاد.
  • يجب أن يكون حجم الردود أقل من 8 آلاف. قد تؤدي الردود الكبيرة جدًا إلى زيادة وقت استجابة الشبكة ومهلة المهلة.
  • اتّبِع إرشادات عروض الأسعار على المستودع الإعلاني على أجهزة iOS التي تتطلّب إحالة SKAdNetwork.

مثال على ردّ عرض السعر

وتمثّل الأمثلة التالية نماذج يمكن للمستخدمين قراءتها حول طلبات Protobuf وJSON.

Google

ملف OpenRTB JSON

OpenRTB Protobuf

ملاحظة مهمة: يتم تمثيل رسائل 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 إحدى وحدات الماكرو المتوافقة المدرَجة في الجدول أدناه.

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

لاستخدام وحدة ماكرو، يمكنك تضمينها في الإعلان حتى يتم جلب عنوان URL عند نقر أحد المستخدمين عليه. إنّ قيمة العرض للاسترجاع هي إعادة توجيه إلى عنوان URL آخر تُلحقه بعنوان البريد الإلكتروني CLICK_URL.

وحدات الماكرو الوصف
ADVERTISING_IDENTIFIER يسمح هذا الإعداد للمشترين بالحصول على معرّف المعلِنين (IDFA) على نظام التشغيل iOS أو المعرِّف الإعلاني على أجهزة Android\u39s، عند عرض مرات الظهور. ولمزيد من التفاصيل، يمكنك الاطّلاع على فك تشفير معرّفات المعلِنين.
CACHEBUSTER تمثيل سلسلة لعدد صحيح عشوائي غير موقَّع من 4 بايت.
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 التي تم فك ترميزها في هذه الحالة 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
    لا يُسمح للإعلانات بإجراء طلبات غير طبقة المقابس الآمنة.

لذلك، إذا كان الحقل excluded_attribute يحتوي على القيمة 7، يجب ألا تعرض إعلانًا يستخدم بكسل أو إشارة ويب لإنشاء قائمة. تجدر الإشارة إلى أنه إذا أجرى الإعلان ذلك، يجب ضبط القيمة 7 في حقل السمة في BidResponse. وبالمثل، إذا تضمّن الحقل excluded_attribute القيمة 48، عليك فقط عرض الإعلانات التي يمكن عرضها على صفحة طبقة المقابس الآمنة (وبناءً على ذلك، يجب تحديد السمة 47richMediaCapabilityType: 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

ملف OpenRTB JSON

OpenRTB Protobuf

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

Google

ملف OpenRTB JSON

OpenRTB Protobuf

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

Google

ملف OpenRTB JSON

OpenRTB Protobuf

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

Google

ملف OpenRTB JSON

OpenRTB Protobuf

فيديو ويب

Google

ملف OpenRTB JSON

OpenRTB Protobuf

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

OpenRTB Protobuf