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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

بروتو

ملف الوصف الإصدار تاريخ التعديل الأخير
cookie-bulk-upload.proto استخدم هذه الرسالة للتحميل المجمّع لبيانات استهداف المستخدمين. الإصدار 19 25 آب (أغسطس) 2022
openrtb.proto يتيح محرّك البحث Google استخدام بروتوكول OpenRTB، سواء كان بتنسيق JSON أو Protobuf. هذا النموذج الأولي ضروري إذا كنت تستخدم OpenRTB/Protobuf. ويتضمّن أيضًا مستندات للحقول المتاحة وربطها ببروتوكول Google الأصلي. 2.6 28 شباط (فبراير) 2023
openrtb-adx.proto يتضمن بروتوكول OpenRTB من Google بعض الإضافات التي يتم تقديمها في نموذج أولي منفصل. الإصدار 127 2 آذار (مارس) 2023
publisher-settings.proto مجموعة من إعدادات الناشر الخاصة بإحدى شبكات تقديم عروض الأسعار في الوقت الفعلي. الإصدار 13 2 شباط (فبراير) 2023
عروض الأسعار في الوقت الفعلي.proto بروتوكول RTB الخاص بالشراة المعتمَدين في Google. هذه هي الرسالة التي تستخدمها Google لطلب عروض الأسعار. يتضمّن BidRequest الشريحة الإعلانية من مرة ظهور واحدة. الإصدار 269 5 آذار (مارس) 2023

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

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

مستخدمة في

تمّ إرجاع creative_status_code في ملاحظات في الوقت الفعلي.
رموز حالة المطابقة المستضافة تُستخدم في الحقل hostedMatchStatusRate من تقارير أداء بروتوكول RTB.
ما مِن أسباب مرتبطة بعروض الأسعار القيم القياسية للسبب بدون عرض أسعار والتي سيتم تقديمها في الحقل BidResponse.no_bid_reason في بروتوكول عروض الأسعار "الشراة المعتمَدون".
سمات تصميم الإعلان القابلة للاستهداف مسبقًا تُستخدم هذه السمة في الحقل supportedCreativeAttribute في مورد PretargetingConfig الذي يظهر في واجهة برمجة تطبيقات المشتري. يصف هذا الحقل سمات تصميم الإعلان التي يُتوقع أن تكون متوفّرة في جميع تصميمات الإعلانات المقابلة لضبط واحد للاستهداف المسبق.
سمات تصميم الإعلان غير المستثناة من الناشر تُستخدم في الحقل 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 من ممثل حسابك.