البيانات الأولية والتجريبية

عرض أو تنزيل الملفات المتوافقة مع بروتوكول RTB

Protos

ملف الوصف الإصدار تاريخ التعديل الأخير
cookie-bulk-upload.proto استخدِم هذه الرسالة لتحميل بيانات استهداف المستخدمين بشكل مجمّع. v.24 ‫27 مارس 2024
openrtb.proto تتيح Google استخدام بروتوكول OpenRTB، مع ترميز JSON أو Protobuf. هذا النموذج الأوّلي ضروري إذا كنت تستخدم OpenRTB/Protobuf. ويتضمّن أيضًا مستندات حول الحقول المتوافقة وكيفية ربطها ببروتوكول Google الأصلي. 2.6 ‫6 أكتوبر 2025
openrtb-adx.proto يتضمّن بروتوكول OpenRTB من Google بعض الإضافات المتوفّرة في ملف proto منفصل. v.198 ‫20 أكتوبر 2025
publisher-settings.proto مجموعة من إعدادات الناشر الخاصة بشبكة عروض الأسعار في الوقت الفعلي v.14 ‫5 فبراير 2024

Open Beta Protos

ملف الوصف الإصدار تاريخ التعديل الأخير
openrtb-adx.proto يتضمّن بروتوكول OpenRTB من Google بعض الإضافات المتوفّرة في ملف proto منفصل. v.205 ‫20 أكتوبر 2025

بيانات المرجع

القواميس (انقر لتنزيل ملف ‎ .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.
رموز حالة وسائل الشرح رموز الحالة التي تعرضها استدعاءات الطريقة performancereport.
تصنيفات المحتوى يُستخدَم في الحقل detected_content_labels ضمن BidRequest.
رموز حالة أداة مطابقة ملفات تعريف الارتباط يتم استخدامها في الحقل cookieMatcherStatusRate ضمن تقارير الأداء الخاصة ببروتوكول عروض الأسعار في الوقت الفعلي. تم توضيح الرموز المتاحة في دليل مطابقة ملفات تعريف الارتباط.
رموز حالة تصميم الإعلان

مُستخدَمة في

تم إرجاع creative_status_code في ملاحظات في الوقت الفعلي.
رموز حالة المطابقة المستضافة يتم استخدامها في الحقل hostedMatchStatusRate ضمن تقارير الأداء الخاصة ببروتوكول عروض الأسعار في الوقت الفعلي.
أسباب عدم تقديم عروض أسعار قيم أسباب عدم تقديم عروض الأسعار العادية التي سيتم تقديمها في الحقل BidResponse.no_bid_reason في بروتوكول عروض الأسعار في Authorized Buyers
سمات المواد الإبداعية التي يمكن استهدافها مسبقًا يتم استخدامها في الحقل supportedCreativeAttribute ضمن مورد PretargetingConfig المعروض في Buyer REST API. يصف هذا الحقل سمات تصميم الإعلان التي من المتوقّع أن تكون متوفّرة في جميع تصاميم الإعلانات المتوافقة مع إعداد واحد للاستهداف المُسبَق.
سمات المواد الإبداعية التي يمكن للناشرين استبعادها مُستخدَمة في الحقل excluded_attribute الخاص بـ BidRequest يصف هذا الحقل أنواع التصاميم التي لا يسمح بها الناشر. على سبيل المثال، قد يحدّدون قيودًا بشأن ما إذا كان يُسمح باستخدام ملفات تعريف الارتباط، أو ما إذا كان يُسمح بعرض إعلانات وسائط و/أو إعلانات نصية.
المورّدون مُستخدَمة في الحقل allowed_vendor_type الخاص بـ BidRequest يسرد هذا الحقل مورّدي الوسائط التفاعلية المتقدّمة المسموح بهم، مثل Campaign Monitor وVoiceFive، بالنسبة إلى تصميم الإعلان المعروض، وذلك على النحو الذي يحدّده الناشر.

يتضمّن البائعين من ملف قاموس gdn-vendors.txt الذي تم إيقافه نهائيًا.
مقدّمو البيانات مُستخدَمة في الحقل SegmentData.id الخاص بـ BidRequest يحتوي هذا الحقل على معلومات حول الجهة التي قدّمت الإشارات المقدَّمة من الناشر.

جداول المراجع (انقر لتنزيل ملفات CSV)
التطبيقات المتوافقة مع الأجهزة الجوَّالة لنظام التشغيل Android قائمة بتطبيقات Android المتوافقة مع الأجهزة الجوّالة التي يمكن استهدافها، مع أرقام تعريف التطبيقات وأرقام تعريف الفئات وأسماء التطبيقات التي يمكن قراءتها.
جداول المواقع الجغرافية الجدول المستخدَم لفك ترميز الحقل geo_criteria_id الخاص بـ BidRequest يُرجى الرجوع إلى الاستهداف الجغرافي للحصول على مزيد من المعلومات.
مقدّمو الخدمات ضمن برنامج "الشراكة في الخلاصات المحلية" قائمة مزوّدي خدمة تخصيص الإعلانات المسموح لهم بعرض الإعلانات على زيارات المستخدمين من المناطق الخاضعة لقانون LGPD، مع أرقام التعريف والأسماء الواضحة وعناوين URL الخاصة بالخصوصية وقائمة بالنطاقات التي يمكن نسبها إلى مقدّم الخدمة يتم الإشارة إلى تنفيذ قانون حماية البيانات العام في البرازيل في طلب عرض سعر معيّن من خلال الحقل 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