عرض الملفات التي تتوافق مع بروتوكول "عرض الأسعار في الوقت الفعلي" أو تنزيلها
ملفات Protos
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| cookie-bulk-upload.proto | استخدِم هذه الرسالة لتحميل بيانات استهداف المستخدِمين بشكل مجمّع. | v.25 | 27 مارس 2024 |
| openrtb.proto | تتيح Google بروتوكول OpenRTB باستخدام ترميز JSON أو Protobuf يكون هذا الملف proto ضروريًا إذا كنت تستخدم OpenRTB/Protobuf. ويتضمّن أيضًا مستندات الحقول المتاحة وعملية ربطها ببروتوكول Google الأصلي. | 2.6 | 15 أكتوبر 2026 |
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات المتوفّرة في ملف proto منفصل. | v.210 | 04 أغسطس 2026 |
| publisher-settings.proto | مجموعة من إعدادات الناشر الخاصة بشبكة عارض أسعار في الوقت الفعلي. | v.14 | 05 فبراير 2024 |
ملفات Protos للإصدار التجريبي المفتوح
| ملف | الوصف | الإصدار | تاريخ التعديل الأخير |
|---|---|---|---|
| openrtb-adx.proto | يتضمّن بروتوكول OpenRTB من Google بعض الإضافات المتوفّرة في ملف proto منفصل. | v.220 | 16 سبتمبر 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. يحدّد هذا الحقل المعلِن الذي يمثّله تصميم الإعلان المرتبط بالمقتطف. تعكس هذه القائمة المعلِنين على مستوى البورصة ولا تعكس المعلِنين الذين يمثّلهم أيّ مشترٍ واحد. |
| العلامات التجارية | قائمة بالعلامات التجارية تُستخدَم في واجهة برمجة تطبيقات وصول العميل. |
| سمات تصميم الإعلان التي يمكن للمشتري الإعلان عنها | تُستخدَم للحقل attribute في BidResponse.
يصف هذا الحقل السمات التي يمكن للمشتري الإعلان عنها في تصاميم الإعلانات والتي يجب
ألا تظهر في excluded_attribute في
BidRequest. |
| رموز حالة الإعلانات البارزة | رموز الحالة التي يعرضها استدعاء طريقة performancereport
|
| تصنيفات المحتوى | تُستخدَم في الحقل detected_content_labels من الـ
BidRequest. |
| رموز حالة أداة مطابقة ملفات تعريف الارتباط | تُستخدَم في الحقل cookieMatcherStatusRate من تقارير الأداء لبروتوكول "عرض الأسعار في الوقت الفعلي"
. يتم وصف الرموز المتاحة في دليل مطابقة ملفات تعريف الارتباط. |
| رموز حالة تصميم الإعلان | تُستخدَم في creative_status_code الذي يتم عرضه في الملاحظات في الوقت الفعلي.
|
| رموز حالة المطابقة المستضافة | تُستخدَم في الحقل hostedMatchStatusRate من تقارير الأداء لبروتوكول "عرض الأسعار في الوقت الفعلي"
. |
| أسباب عدم تقديم عرض سعر | القيم العادية لأسباب عدم تقديم عرض سعر التي يجب تقديمها في الحقل BidResponse.no_bid_reason في
بروتوكول عروض أسعار "الشراة المعتمَدون". |
| سمات تصميم الإعلان التي يمكن استهدافها مسبقًا | تُستخدَم في الحقل supportedCreativeAttribute في مورد
PretargetingConfig المعروض في واجهة برمجة تطبيقات REST للمشتري. يصف هذا الحقل
سمات تصميم الإعلان التي يُتوقَّع أن تكون موجودة في جميع تصاميم الإعلانات
التي تتوافق مع إعداد واحد للاستهداف المسبق. |
| سمات تصميم الإعلان التي يمكن للناشر استبعادها | تُستخدَم في الحقل 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