البيانات الأولية والتجريبية

عرض أو تنزيل الملفات التي تدعم بروتوكول RTB.

بروتوس

ملف الوصف الإصدار تاريخ التعديل الأخير
cookie-bulk-upload.proto استخدِم هذه الرسالة لتحميل بيانات استهداف المستخدمين بشكل مجمّع. v.24 27 مارس 2024
openrtb.proto يتيح محرّك بحث Google استخدام بروتوكول OpenRTB، إما باستخدام JSON أو Protobuf الترميز. هذا النموذج ضروري في حالة استخدام OpenRTB/Protobuf. وكذلك وثائق الحقول المعتمدة وربطها بحقول Google بروتوكول أصلي. 2.6 22 مايو 2024
openrtb-adx.proto يتضمن بروتوكول OpenRTB من Google بعض الإضافات التي يتم توفيرها في نموذج أوّلي منفصل. v.175 15 يوليو 2024
publisher-settings.proto مجموعة من إعدادات الناشر المخصَّصة لشبكة مقدِّمي عروض الأسعار في الوقت الفعلي v.13 5 فبراير 2024
realtime-bidding.proto بروتوكول عرض الأسعار في الوقت الفعلي (RTB) للمشترين المعتمَدين من Google. هذه هي الرسالة التي تستخدمها Google. لطلب عروض الأسعار. تتضمن BidRequest الشريحة الإعلانية من مرة ظهور واحدة. v.328 ‫21 مايو 2024

النماذج التجريبية المفتوحة

ملف الوصف الإصدار تاريخ التعديل الأخير
openrtb-adx.proto يتضمن بروتوكول OpenRTB من Google بعض الإضافات التي يتم توفيرها في نموذج أوّلي منفصل. v.180 15 يوليو 2024
realtime-bidding.proto بروتوكول عرض الأسعار في الوقت الفعلي (RTB) للمشترين المعتمَدين من Google. هذه هي الرسالة التي تستخدمها Google. لطلب عروض الأسعار. تتضمن BidRequest الشريحة الإعلانية من مرة ظهور واحدة. v.338 ‫21 مايو 2024

بيانات المرجع

القواميس (انقر لتنزيل ملف .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.
سمات تصميمات الإعلانات التي يفصح عنها المشترين يتم استخدامه للحقل attribute في BidResponse. يصف هذا الحقل السمات التي يحددها المشتري لتصميمات الإعلانات التي يجب لا تظهر في excluded_attribute في BidRequest
رموز حالة وسيلة الشرح رموز الحالة التي يتم عرضها باستخدام الطريقة performancereport الاتصال.
تصنيفات المحتوى مُستخدَم في الحقل detected_content_labels من BidRequest
رموز حالة مطابقة ملفات تعريف الارتباط تُستخدَم في الحقل cookieMatcherStatusRate من بروتوكول عرض الأسعار في الوقت الفعلي (RTB). تقارير الأداء. تم توضيح الرموز المتاحة في مطابقة ملفات تعريف الارتباط الدليل.
رموز حالة تصميم الإعلان

مُستخدَمة في

تم إرجاع creative_status_code في الوقت الفعلي. ملاحظاتك وآرائك.
رموز حالة المطابقة المستضافة تُستخدَم في الحقل hostedMatchStatusRate من بروتوكول عرض الأسعار في الوقت الفعلي (RTB). تقارير الأداء.
ما مِن أسباب لعروض الأسعار القيم العادية التي لا يتم تحديد عروض أسعار لها في الحقل BidResponse.no_bid_reason ضمن بروتوكول عروض أسعار "الشراة المعتمَدون"
سمات تصميمات الإعلانات القابلة للاستهداف مسبقًا مُستخدَم في الحقل supportedCreativeAttribute في تم عرض مورد PretargetingConfig في واجهة برمجة تطبيقات برسمة REST. هذا الحقل يصف سمات تصميمات الإعلانات المتوقع وجودها في جميع تصميمات الإعلانات يتوافق مع تهيئة واحدة للاستهداف المسبق.
سمات تصميمات الإعلانات التي يمكن استبعادها من قِبل الناشر مُستخدَم في الحقل excluded_attribute من BidRequest يصف هذا الحقل أنواع تصميمات الإعلانات التي غير مسموح بها من قبل الناشر. على سبيل المثال، قد يحددون قيود على ما إذا كان يُسمح باستخدام ملفات تعريف الارتباط أو ما إذا كانت الوسائط و/أو النصوص السماح بالإعلانات.
مجالات الناشرين مُستخدَم في الحقل detected_vertical من BidRequest يحدد هذا الحقل مواضع الإعلانات (على غرار ) للصفحة التي سيُعرض عليها الإعلان. تنشئ Google هذا من خلال الزحف إلى الصفحة وتحديد القطاعات المستخدمة.
المورّدون مُستخدَم في الحقل allowed_vendor_type من BidRequest يسرد هذا الحقل موردي الوسائط المتعددة التفاعلية، مثل يُسمح لكل من Campaign Monitor وVoiceFive بتصميم الإعلان الذي يتم عرضه، كما هو محدد من قبل الناشر.

يشمل البائعين من عمليات الإيقاف النهائي ملف قاموس gdn-vendors.txt
مزوِّدو البيانات مُستخدَم في الحقل SegmentData.id من BidRequest يحتوي هذا الحقل على معلومات عن الكيان الذي قدّم إشارات مقدَّمة من الناشر:

الجداول المرجعية (انقر لتنزيل ملفات CSV)
التطبيقات المتوافقة مع الأجهزة الجوَّالة لنظام التشغيل Android قائمة بتطبيقات Android للأجهزة الجوّالة القابلة للاستهداف مع معرّفات التطبيقات وأرقام تعريف الفئات وأسماء التطبيقات التي يسهل على الإنسان قراءتها.
الجداول الجغرافية الجدول المستخدَم لفك ترميز حقل geo_criteria_id في BidRequest ارجع إلى الاستهداف الجغرافي للاطّلاع على مزيد من المعلومات المعلومات.
مقدّمو قانون LGPD قائمة مقدّمي خدمات تخصيص الإعلانات المسموح لها بعرض الإعلانات على الزيارات الواردة من قانون LGPD مع رقم تعريفها واسم سهل القراءة للمستخدم وعنوان URL للخصوصية وقائمة بالنطاقات والذي يمكن نسبه إلى مزود الخدمة. يشار إلى تنفيذ قانون LGPD في طلب عرض سعر معيّن من خلال BidRequest.adslot.regs_lgpd في بروتوكول عروض أسعار "الشراة المعتمَدون" الحقل BidRequest.regs.ext.lgpd في بروتوكول عروض أسعار OpenRTB.
مشغّلو شبكة الجوّال قائمة بمشغّلي شبكة الجوّال
الأجهزة الجوّالة قائمة الأجهزة الجوّالة
أنظمة تشغيل الأجهزة الجوّالة قائمة بأنظمة تشغيل الأجهزة الجوّالة.
مقدّمو خدمة أرقام تعريف موفّري تخصيص الإعلانات على "خرائط Google" لاسم يمكن لشخص عادي قراءته أو الحفاظ على الخصوصية وعنوان URL للسياسة، وقائمة بالنطاقات التي يمكن إسنادها إلى موفّر الخدمة. يتم حاليًا الاستعانة بمقدّمي الخدمات في حقل واحد (BidRequest.AdSlot.consented_providers_settings) في AdX والبروتوكول BidRequest.User.UserExt.consented_providers_settings لبرنامج OpenRTB والبروتوكول. في هذه الحقول، يحصل المزوّدون المدرَجون على موافقة المستخدم وفقًا لما يتم تمريره من للناشرين للمستخدمين في البلدان داخل المنطقة الاقتصادية الأوروبية.

إعدادات الناشر

اطلب الملف publisher-settings.pb.gz من حسابك. ممثلة لك.

مواضيع سياسات مراجعة تصاميم الإعلانات

يمكنك استخدام مواضيع السياسات في هذا الملف لفلترة تصميمات الإعلانات أثناء مراجعة في واجهة برمجة تطبيقات عروض الأسعار في الوقت الفعلي

تنزيل والمواضيع المتعلقة بالسياسات كملف CSV

تاريخ آخر تعديل: 18 نيسان (أبريل) 2022