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

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

بروتوس

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

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

ملف الوصف الإصدار تاريخ التعديل الأخير
openrtb-adx.proto يتضمّن بروتوكول OpenRTB من Google بعض الإضافات، ويتم توفيرها في بروتوكول منفصل. v.186 1 تشرين الثاني (نوفمبر) 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 المعروض في واجهة برمجة تطبيقات بر شراء 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.
مشغّلو شبكات الجوّال قائمة مشغّلي شبكات الجوّال
الأجهزة الجوّالة قائمة الأجهزة الجوّالة
أنظمة التشغيل للأجهزة الجوّالة قائمة بأنظمة التشغيل للأجهزة الجوّالة
المزوّدون تربط معرّفات مقدّمي خدمات تخصيص الإعلانات باسم يسهل فهمه وعنوان 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