عرض الملفات التي تتيح بروتوكول "عرض الأسعار في الوقت الفعلي" أو تنزيلها
ملفات Protos
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| cookie-bulk-upload.proto | استخدِم هذه الرسالة لتحميل بيانات استهداف المستخدمين بشكلٍ مجمّع. | v.24 | 27 مارس 2024 |
| openrtb.proto | تتيح Google بروتوكول OpenRTB باستخدام ترميز JSON أو Protobuf يكون هذا الملف proto ضروريًا إذا كنت تستخدم OpenRTB/Protobuf. ويتضمّن أيضًا مستندات الحقول المتاحة وربطها ببروتوكول Google الأصلي. | 2.6 | 30 يونيو 2026 |
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات التي يتم تقديمها في ملف proto منفصل. | v.209 | 07 يوليو 2026 |
| publisher-settings.proto | مجموعة من إعدادات الناشر الخاصة بشبكة عارض أسعار في الوقت الفعلي | v.14 | 05 فبراير 2024 |
ملفات Protos للإصدار التجريبي المفتوح
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات التي يتم تقديمها في ملف proto منفصل. | v.218 | 07 يوليو 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