يمكنك عرض أو تنزيل الملفات التي تتوافق مع بروتوكول RTB.
Protos
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| cookie-bulk-upload.proto | استخدِم هذه الرسالة لتحميل بيانات استهداف المستخدمين بشكل مجمّع. | v.25 | 27 مارس 2024 |
| openrtb.proto | تتيح Google استخدام بروتوكول OpenRTB، إما من خلال ترميز JSON أو Protobuf. هذا النموذج ضروري إذا كنت تستخدم OpenRTB/Protobuf. ويتضمّن أيضًا مستندات حول الحقول المتوافقة وربطها ببروتوكول Google الأصلي. | 2.6 | 15 أكتوبر 2026 |
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات المقدَّمة في ملف proto منفصل. | v.210 | 4 أغسطس 2026 |
| publisher-settings.proto | مجموعة من إعدادات الناشر الخاصة بشبكة عرض الأسعار في الوقت الفعلي. | v.14 | 5 فبراير 2024 |
النماذج الأولية للإصدار التجريبي المفتوح
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات المقدَّمة في ملف proto منفصل. | v.220 | 16 سبتمبر 2026 |
بيانات المرجع
القواميس (انقر لتنزيل ملف .txt) |
|
|---|---|
| فئات المنتجات الإعلانية | يُستخدَم في الحقل excluded_product_category من
BidRequest. يصف هذا الحقل فئات المنتجات والخدمات التي لا يسمح بها الناشر، على سبيل المثال، إذا كان الناشر لا يريد استضافة إعلانات مرتبطة بالخدمات المصرفية على الإنترنت. |
| الفئات الإعلانية المحظورة | يُستخدَم في حقل allowed_restricted_category في BidRequest وحقل restricted_category في BidResponse. يصف الحقل allowed_restricted_category الفئات التي تكون محظورة عادةً، ولكن يعلن الناشر صراحةً عن السماح بها، مثل الإعلانات التي تتضمّن محتوى مرتبطًا بالكحول. |
| الفئات الإعلانية الحساسة | يُستخدَم في الحقل excluded_sensitive_category ضمن BidRequest والحقل category ضمن BidResponse. يصف الحقل excluded_sensitive_category الفئات الحساسة التي لا يسمح بها الناشر، على سبيل المثال، إذا كان الناشر لا يريد استضافة إعلانات ذات صلة بالسياسة. |
| المعلنون | يتم استخدامها في حقل advertiser_id من SnippetStatusItem. يحدّد هذا الحقل المعلِن الذي يمثّله تصميم الإعلان المرتبط بالمقتطف. تعكس هذه القائمة المعلنين في جميع أنحاء سوق الإعلانات ولا تعكس المعلنين الذين يمثلهم أي مشترٍ واحد. |
| العلامات التجارية | قائمة بالعلامات التجارية المستخدَمة في Client Access API |
| سمات تصاميم الإعلانات التي يمكن للمشتري الإفصاح عنها | يُستخدَم للحقل attribute في BidResponse.
يصف هذا الحقل السمات التي يمكن للمشتري الإفصاح عنها في تصاميم الإعلانات والتي يجب
ألا تظهر في excluded_attribute في
BidRequest. |
| تصنيفات المحتوى | يتم استخدامها في حقل detected_content_labels في BidRequest. |
| رموز حالة مطابِق ملفات تعريف الارتباط | يُستخدَم في حقل cookieMatcherStatusRate في تقارير أداء بروتوكول عروض الأسعار في الوقت الفعلي. يتم وصف الرموز المتاحة في دليل مطابقة ملفات تعريف الارتباط. |
| رموز حالة تصميم الإعلان | مُستخدَمة في تم عرضcreative_status_code في الملاحظات الفورية.
|
| رموز حالة المباراة المستضافة | يُستخدَم في حقل hostedMatchStatusRate في تقارير أداء بروتوكول عروض الأسعار في الوقت الفعلي. |
| أسباب عدم تقديم عروض أسعار | قيم أسباب عدم تقديم عروض الأسعار العادية التي يجب تقديمها في الحقل BidResponse.no_bid_reason في بروتوكول عروض أسعار "الشراة المعتمَدون". |
| سمات تصميم الإعلان القابلة للاستهداف المسبق | يُستخدَم في الحقل supportedCreativeAttribute في مورد PretargetingConfig المعروض في واجهة برمجة تطبيقات REST للمشتري. يصف هذا الحقل سمات تصميم الإعلان التي يُتوقع توفّرها في جميع تصاميم الإعلانات التي تتوافق مع إعداد استهداف مسبق واحد. |
| سمات تصاميم الإعلانات التي يمكن للناشر استبعادها | يُستخدَم في الحقل excluded_attribute من
BidRequest. يصف هذا الحقل أنواع تصاميم الإعلانات التي لا يسمح بها الناشر. على سبيل المثال، قد يحدّدون قيودًا على ما إذا كان يُسمح باستخدام ملفات تعريف الارتباط أو ما إذا كان يُسمح بعرض إعلانات الوسائط و/أو الإعلانات النصية. |
| المورّدون | يُستخدَم في الحقل allowed_vendor_type من
BidRequest. يسرد هذا الحقل مورّدي الوسائط التفاعلية المتقدّمة المسموح لهم بعرض الإعلان، مثل Campaign Monitor وVoiceFive، كما يحدّده الناشر. تتضمّن هذه القائمة المورّدين من ملف قاموس |
| مقدّمو البيانات | يُستخدَم في الحقل SegmentData.id من
BidRequest. يحتوي هذا الحقل على معلومات عن الجهة التي قدّمت
الإشارات المقدَّمة من الناشر. |
الجداول المرجعية (انقر لتنزيل ملفات CSV) |
|
| التطبيقات المتوافقة مع الأجهزة الجوَّالة لنظام التشغيل Android | قائمة بالتطبيقات المتوافقة مع أجهزة Android الجوّالة التي يمكن استهدافها، مع معرّفات التطبيقات ومعرّفات الفئات وأسماء التطبيقات التي يمكن لشخص عادي قراءتها |
| الجداول الجغرافية | الجدول المستخدَم لفك ترميز الحقل geo_criteria_id في
BidRequest. لمزيد من المعلومات، يُرجى الاطّلاع على الاستهداف الجغرافي. |
| مزوّدو الخدمات الملتزمون بالقانون العام لحماية البيانات (LGPD) |
قائمة بمزوّدي خدمات تخصيص الإعلانات المسموح لهم بعرض الإعلانات على الزيارات الخاضعة للقانون البرازيلي لحماية البيانات (LGPD)، مع رقم تعريفهم واسم يمكن لشخص عادي قراءته وعنوان URL لسياسة الخصوصية وقائمة بالنطاقات التي يمكن أن تُنسب إلى المزوّد. تتم الإشارة إلى تنفيذ القانون العام لحماية البيانات (LGPD) في طلب عرض سعر معيّن من خلال الحقل BidRequest.adslot.regs_lgpd في بروتوكول عرض أسعار "الشراة المعتمَدون" والحقل BidRequest.regs.ext.lgpd في بروتوكول عرض أسعار OpenRTB.
|
| مشغّلو شبكة الجوّال | قائمة بمشغّلي شبكات الجوّال |
| الأجهزة الجوّالة | قائمة بالأجهزة الجوّالة |
| أنظمة تشغيل الأجهزة الجوّالة | قائمة بأنظمة تشغيل الأجهزة الجوّالة |
| مقدّمو الخدمات | تحدّد هذه السمة معرّفات مزوّدي خدمات تخصيص الإعلانات لاسم يمكن لشخص عادي قراءته، وعنوان URL لسياسة الخصوصية، وقائمة بالنطاقات التي يمكن أن تُنسب إلى المزوّد.
في الوقت الحالي، يتم استخدام مقدّمي الخدمات في حقل BidRequest.AdSlot.consented_providers_settings لبروتوكول AdX وBidRequest.User.UserExt.consented_providers_settings لبروتوكول OpenRTB. في هذه الحقول، يحصل المزوّدون المدرجون على موافقة المستخدمين كما يمررها الناشرون للمستخدمين في بلدان المنطقة الاقتصادية الأوروبية. |
إعدادات الناشر
اطلب ملف publisher-settings.pb.gz من ممثل حسابك.
مواضيع سياسات مراجعة تصاميم الإعلانات
يمكنك استخدام مواضيع السياسات في هذا الملف لفلترة تصاميم الإعلانات أثناء مراجعتها في Real-time Bidding API
نزِّل مواضيع السياسات كملف CSV.تاريخ آخر تعديل: 18 أبريل 2022