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

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

نماذج أوّلية

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

فتح الإصدار التجريبي من Protos

ملف الوصف الإصدار تاريخ التعديل الأخير
openrtb-adx.proto يتضمن بروتوكول OpenRTB من Google بعض الإضافات التي يتم تقديمها في نموذج منفصل. v.174 17 نيسان (أبريل) 2024
realtime-bidding.proto بروتوكول عرض الأسعار في الوقت الفعلي (RTB) "للشراة المعتمَدين" من Google. وهذه هي الرسالة التي تستخدمها Google لطلب عروض أسعار. يتضمّن BidRequest الشريحة الإعلانية من مرّة ظهور واحدة. v.331 17 نيسان (أبريل) 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 المعروض في واجهة برمجة تطبيقات Migrate REST. يصف هذا الحقل سمات تصميمات الإعلانات المتوقّع أن تكون متوفرة في جميع تصميمات الإعلانات المقابلة لإعداد واحد للاستهداف المُسبَق.
سمات المواد الإبداعية المستثناة من الناشر ويتم استخدامه في الحقل excluded_attribute ضمن BidRequest. يصف هذا الحقل أنواع تصاميم الإعلانات التي لا يسمح بها الناشر. على سبيل المثال، قد تفرض قيودًا على ما إذا كان يُسمح باستخدام ملفات تعريف الارتباط أو ما إذا كان يُسمح بعرض الوسائط و/أو الإعلانات النصية.
فئات الناشرين ويتم استخدامه في الحقل detected_vertical ضمن BidRequest. يحدّد هذا الحقل القطاعات (التي تشبه الكلمات الرئيسية) للصفحة التي سيتم عرض الإعلان عليها. ينشئ محرّك بحث Google هذا الحقل من خلال الزحف إلى الصفحة وتحديد الفئات التي يتم استخدامها.
أرقام تعريف شبكات البائعين ويتم استخدامه في الحقل seller_network_id ضمن BidRequest. يحدد هذا الحقل شبكة البائع التي ينتمي إليها الناشر. يتم ترتيب محتوى هذا الملف تصاعديًا استنادًا إلى قيمة رقم تعريف شبكة البائع.
المورّدون ويتم استخدامه في الحقل allowed_vendor_type ضمن BidRequest. يسرد هذا الحقل مورّدي الوسائط التفاعلية المتقدّمة، مثل Campaign Monitor وVoiceFive، المسموح لهم بعرض تصميم الإعلان، على النحو الذي حدّده الناشر.

يتضمّن ذلك المورّدين من ملف قاموس gdn-vendors.txt الذي تم إيقافه نهائيًا.

الجداول المرجعية (انقر لتنزيل ملفات 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