عرض الملفات التي تتيح استخدام بروتوكول "عرض الأسعار في الوقت الفعلي" أو تنزيلها:
ملفات 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.207 | 13 أبريل 2026 |
| publisher-settings.proto | مجموعة من إعدادات الناشر الخاصة بشبكة عارض أسعار في الوقت الفعلي | v.14 | 05 فبراير 2024 |
ملفات Protos للإصدار التجريبي المفتوح
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات، التي يتم تقديمها في ملف proto منفصل. | v.215 | 13 أبريل 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 من ممثل حسابك.
مواضيع سياسة مراجعة تصاميم الإعلانات
يمكنك استخدام مواضيع السياسات في هذا الملف لفلترة تصاميم الإعلانات أثناء المراجعة في واجهة برمجة تطبيقات عرض الأسعار في الوقت الفعلي
تنزيل مواضيع السياسات كملف CSV.آخر تعديل: 18 أبريل 2022