عرض الملفات التي تتيح استخدام بروتوكول "عرض الأسعار في الوقت الفعلي" أو تنزيلها
ملفات Protos
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| cookie-bulk-upload.proto | استخدِم هذه الرسالة لتحميل بيانات استهداف المستخدمين بشكل مجمّع. | v.24 | 27 مارس 2024 |
| openrtb.proto | تتيح Google استخدام بروتوكول OpenRTB، باستخدام ترميز JSON أو Protobuf. يكون هذا الملف proto ضروريًا إذا كنت تستخدم OpenRTB/Protobuf. ويتضمّن أيضًا توثيق الحقول المتوافقة وطريقة ربطها ببروتوكول Google الأصلي. | 2.6 | 2 يونيو 2026 |
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات، يتم تقديمها في ملف proto منفصل. | v.208 | 9 يونيو 2026 |
| publisher-settings.proto | مجموعة من إعدادات الناشر الخاصة بشبكة عارض أسعار في الوقت الفعلي | v.14 | 5 فبراير 2024 |
ملفات Protos للإصدار التجريبي المفتوح
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات، يتم تقديمها في ملف proto منفصل. | v.216 | 9 يونيو 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. |
| رموز حالة الإعلانات البارزة | رموز الحالة التي يعرضها طلب الطريقة performancereport
|
| تصنيفات المحتوى | تُستخدَم في حقل detected_content_labels من الـ
BidRequest. |
| رموز حالة أداة مطابقة ملفات تعريف الارتباط | تُستخدَم في حقل cookieMatcherStatusRate من تقارير الأداء في بروتوكول "عرض الأسعار في الوقت الفعلي"
يتم وصف الرموز المتاحة في دليل مطابقة ملفات تعريف الارتباط. |
| رموز حالة تصميم الإعلان | تُستخدَم في creative_status_code الذي يتم عرضه في الملاحظات في الوقت الفعلي.
|
| رموز حالة المطابقة المستضافة | تُستخدَم في حقل hostedMatchStatusRate من تقارير الأداء في بروتوكول "عرض الأسعار في الوقت الفعلي"
|
| أسباب عدم تقديم عروض أسعار | القيم العادية لأسباب عدم تقديم عروض الأسعار التي يجب تقديمها في الحقل BidResponse.no_bid_reason في
بروتوكول عروض الأسعار في برنامج "الشراة المعتمَدون" |
| سمات تصميم الإعلان التي يمكن استهدافها مسبقًا | تُستخدَم في حقل supportedCreativeAttribute في
مورد PretargetingConfig المعروض في Buyer REST API. يصف هذا الحقل
سمات تصميم الإعلان التي من المتوقّع أن تظهر في جميع تصاميم الإعلانات
التي تتطابق مع إعداد واحد للاستهداف المسبق. |
| سمات تصميم الإعلان التي يمكن للناشر استبعادها | تُستخدَم في حقل 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