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

عرض الملفات المتوافقة مع بروتوكول RTB أو تنزيلها

Protos

ملف الوصف الإصدار تاريخ التعديل الأخير
cookie-bulk-upload.proto استخدِم هذه الرسالة لتحميل بيانات استهداف المستخدِمين بشكل مجمّع. v.24 27 آذار (مارس) 2024
openrtb.proto تتوافق Google مع بروتوكول OpenRTB، باستخدام ترميز JSON أو Protobuf. هذا النموذج ضروري إذا كنت تستخدم OpenRTB/Protobuf. ويتضمن أيضًا مستندات عن الحقول المتوافقة وربطها بالبروتوكول الأصلي من Google. 2.6 18 تشرين الثاني (نوفمبر) 2024
openrtb-adx.proto يتضمّن بروتوكول OpenRTB من Google بعض الإضافات، ويتم توفيرها في بروتوكول منفصل. v.181 1 تشرين الثاني (نوفمبر) 2024
publisher-settings.proto مجموعة من إعدادات الناشر الخاصة بشبكة عروض أسعار في الوقت الفعلي v.14 5 شباط (فبراير) 2024
realtime-bidding.proto بروتوكول عرض الأسعار في الوقت الفعلي (RTB) الخاص ببرنامج "الشراة المعتمَدون" من Google هذه هي الرسالة التي تستخدمها Google لطلب عروض الأسعار. يتضمّن BidRequest خانة الإعلان من مرّة ظهور واحدة. v.331 1 تشرين الثاني (نوفمبر) 2024

النماذج الأولية للإصدار التجريبي المفتوح

ملف الوصف الإصدار تاريخ التعديل الأخير
openrtb-adx.proto يتضمّن بروتوكول OpenRTB من Google بعض الإضافات، ويتم توفيرها في بروتوكول منفصل. v.187 6 تشرين الثاني (نوفمبر) 2024
realtime-bidding.proto بروتوكول عرض الأسعار في الوقت الفعلي (RTB) الخاص ببرنامج "الشراة المعتمَدون" من Google هذه هي الرسالة التي تستخدمها Google لطلب عروض الأسعار. يتضمّن BidRequest خانة الإعلان من مرّة ظهور واحدة. v.342 31 تشرين الأول (أكتوبر) 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 API
سمات المواد الإبداعية التي يُفصح عنها المشتري تُستخدَم للحقل attribute في BidResponse. يصف هذا الحقل السمات التي يقدّمها المشتري في تصميمات الإعلانات والتي يجب عدم ظهورها في excluded_attribute في BidRequest.
رموز حالة وسائل الشرح رموز الحالة التي تُرجعها طريقةperformancereport عند الاتصال بها
تصنيفات المحتوى تُستخدَم في حقل detected_content_labels من BidRequest.
رموز حالة أداة مطابقة ملفات تعريف الارتباط يُستخدَم في حقل cookieMatcherStatusRate من تقارير أداء "بروتوكول RTB" . يتم وصف الرموز المتاحة في دليل مطابقة ملفات تعريف الارتباط.
رموز حالة تصميم الإعلان

مُستخدَمة في

تم إرجاع creative_status_code في ملاحظات في الوقت الفعلي.
رموز حالة المطابقة المستضافة يُستخدَم في حقل hostedMatchStatusRate من تقارير أداء "بروتوكول RTB" .
ما مِن أسباب عروض الأسعار يجب تقديم القيم العادية لسبب عدم تقديم عرض سعر في حقل BidResponse.no_bid_reason في بروتوكول عروض أسعار "الشراة المعتمَدون".
سمات تصميم الإعلان القابلة للاستهداف المُسبَق يُستخدَم في حقل supportedCreativeAttribute في مورد PretargetingConfig المعروض في Buyer REST API. يصف هذا الحقل سمات تصميم الإعلان المتوقّعة أن تكون متوفّرة في جميع تصميمات الإعلانات المقابلة لإعداد واحد للاستهداف المُسبَق.
سمات تصميم الإعلان التي يمكن للناشر استبعادها مُستخدَمة في حقل 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.
مشغّلو شبكات الجوّال قائمة مشغّلي شبكات الجوّال
الأجهزة الجوّالة قائمة الأجهزة الجوّالة
أنظمة التشغيل للأجهزة الجوّالة قائمة بأنظمة التشغيل للأجهزة الجوّالة
المزوّدون تربط معرّفات مقدّمي خدمات تخصيص الإعلانات باسم يسهل فهمه وعنوان URL لسياسة الخصوصية وقائمة بالنطاقات التي يمكن أن يُنسَب إليها مقدّم الخدمة. في الوقت الحالي، يتم استخدام مزوّدي الخدمة في الحقل BidRequest.AdSlot.consented_providers_settings لبروتوكول AdX و BidRequest.User.UserExt.consented_providers_settings لبروتوكول OpenRTB. في هذه المجالات، يحصل مقدّمو الخدمات المدرَجون على موافقة المستخدِم كما وافق عليها الناشرون للمستخدمين في البلدان ضمن المنطقة الاقتصادية الأوروبية.

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

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

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

يمكنك استخدام مواضيع السياسات الواردة في هذا الملف لفلترة المواد الإبداعية أثناء المراجعة في Real-time Bidding API.

نزِّل topics policy كملف CSV.

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