عرض أو تنزيل الملفات المتوافقة مع بروتوكول RTB
Protos
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| cookie-bulk-upload.proto | استخدِم هذه الرسالة لتحميل بيانات استهداف المستخدمين بشكل مجمّع. | v.24 | 27 مارس 2024 |
| openrtb.proto | تتيح Google استخدام بروتوكول OpenRTB، مع ترميز JSON أو Protobuf. هذا النموذج الأوّلي ضروري إذا كنت تستخدم OpenRTB/Protobuf. ويتضمّن أيضًا مستندات حول الحقول المتوافقة وطريقة ربطها بالبروتوكول الأصلي من Google. | 2.6 | 23 يونيو 2025 |
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات المتوفّرة في ملف proto منفصل. | v.191 | 8 يوليو 2025 |
| publisher-settings.proto | مجموعة من إعدادات الناشرين الخاصة بشبكة عروض الأسعار في الوقت الفعلي | v.14 | 5 فبراير 2024 |
| realtime-bidding.proto | تحذير: سيتم إيقاف هذا البروتوكول نهائيًا اعتبارًا من 1 مايو 2025. إذا لم يسبق لك إجراء ذلك، تنصحك Google بشدة بالانتقال إلى OpenRTB في أقرب وقت ممكن للحدّ من الانقطاعات في عملية دمج ميزة "عروض الأسعار في الوقت الفعلي". | v.333 | 4 يونيو 2025 |
Open Beta Protos
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات المتوفّرة في ملف proto منفصل. | v.198 | 8 يوليو 2025 |
| realtime-bidding.proto | تحذير: سيتم إيقاف هذا البروتوكول نهائيًا اعتبارًا من 1 مايو 2025. إذا لم يسبق لك إجراء ذلك، تنصحك Google بشدة بالانتقال إلى OpenRTB في أقرب وقت ممكن للحدّ من الانقطاعات في عملية دمج ميزة "عروض الأسعار في الوقت الفعلي". | v.344 | 4 يونيو 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 يصف هذا الحقل أنواع التصاميم التي لا يسمح بها الناشر. على سبيل المثال، قد يحدّدون قيودًا بشأن ما إذا كان يُسمح باستخدام ملفات تعريف الارتباط، أو ما إذا كان يُسمح بعرض إعلانات وسائط و/أو إعلانات نصية. |
| مجالات الناشرين | مُستخدَمة في الحقل detected_vertical الخاص بـ BidRequest يحدّد هذا الحقل الفئات العمودية (المشابهة للكلمات الرئيسية) للصفحة التي سيتم عرض الإعلان عليها. تنشئ Google هذا الحقل من خلال الزحف إلى الصفحة وتحديد الفئات العمودية المستخدَمة. |
| المورّدون | مُستخدَمة في الحقل allowed_vendor_type الخاص بـ BidRequest يسرد هذا الحقل مورّدي الوسائط التفاعلية المتقدّمة المسموح بهم، مثل Campaign Monitor وVoiceFive، بالنسبة إلى تصميم الإعلان المعروض، وذلك على النحو الذي يحدّده الناشر. يتضمّن البائعين من ملف قاموس |
| مقدّمو البيانات | مُستخدَمة في الحقل SegmentData.id الخاص بـ BidRequest يحتوي هذا الحقل على معلومات حول الجهة التي قدّمت الإشارات المقدَّمة من الناشر. |
جداول المراجع (انقر لتنزيل ملفات CSV) |
|
| التطبيقات المتوافقة مع الأجهزة الجوَّالة لنظام التشغيل Android | قائمة بتطبيقات Android المتوافقة مع الأجهزة الجوّالة التي يمكن استهدافها، مع أرقام تعريف التطبيقات وأرقام تعريف الفئات وأسماء التطبيقات التي يمكن قراءتها. |
| جداول المواقع الجغرافية | الجدول المستخدَم لفك ترميز الحقل geo_criteria_id من BidRequest يُرجى الرجوع إلى الاستهداف الجغرافي للحصول على مزيد من المعلومات. |
| مقدّمو الخدمات ضمن برنامج "الشراكة في الخلاصات المحلية" |
قائمة مقدّمي خدمات تخصيص الإعلانات المسموح لهم بعرض الإعلانات على زيارات المستخدمين من المناطق الخاضعة لقانون 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