إعدادات الناشر في الوقت الفعلي (RTB)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح Google قوائم إعدادات الناشرين المجمَّعة من خلال تحميلها.
إلى حزمة Google Cloud Storage خاصة بالحساب (ضمن مشروع
تملكها Google). يمكنك تنزيل هذه الخيارات لاستخدامها في الاستهدافات التي لا يمكن
في وقت تقديم عروض الأسعار. يُرجى التواصل مع المدير التقني للحسابات لتفعيل هذه الميزة.
هذه الميزة في حسابك.
يمكن تنزيل الملفات التي تحتوي على إعدادات الناشر آليًا.
باستخدام Cloud Storage
واجهة برمجة التطبيقات، يدويًا من خلال مطوّر برامج Google
Console، أو باستخدام أداة سطر الأوامر gsutil.
يمكنك الاطلاع على Google Cloud
مستندات مساحة التخزين لمزيد من التفاصيل حول الوصول إلى البيانات المخزَّنة في
خدمة Google Cloud Storage
يتم ضغط الملف بتنسيق gzip وفقًا لمعيار RFC 1952. لاستخراج الملف من
سطر الأوامر، شغِّل gzip -d <filename>. لاستخراج
بشكل آلي، يمكنك استخدام zlib أو مكتبة ضغط مشابهة
يدعم تنسيق gzip. والنتيجة هي مخزن بروتوكول تسلسلي متسلسل، على غرار
حمولة طلب POST في BidRequest، والذي يمكن
باستخدام المقتطف التالي:
string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
PublisherSettingsList publisher_settings;
if (publisher_settings.ParseFromString(uncompressed)) {
// Process the publisher settings.
}
يمكن أن يكون تعريف المخزن المؤقت للبروتوكول لـ PublisherSettingsList
تم تنزيلها من البيانات المرجعية
. يمكنك أيضًا طلب ملف مضغوط
ملف واحد (publisher-settings.pb.gz) من ممثل حسابك. أُنشأها جون هنتر، الذي كان متخصصًا
يحتوي على تعريف المخزن المؤقت للبروتوكول بالإضافة إلى مثال لناشر
ملف الإعدادات.
يمكن أن يتغيّر ترتيب PublisherSettingsList في أي وقت.
لا يمكن ضمان ترتيب أو فرز معيّن. كل إدخال في اسم الناشر
تحتوي قائمة الإعدادات على معرّف والعديد من الإعدادات التي تنطبق على
تمت إضافة علامة BidRequests باستخدام هذا المعرّف. يمكنك إضافة ميزة إلى
أنظمة عروض الأسعار لديك للتحقّق بشكل دوري من قائمة إعدادات الناشرين الجديدة
عندما تحصل Google على مرة ظهور مؤهَّلة لاستخدام عروض الأسعار في الوقت الفعلي،
تُضمِّن Google معرّفات في طلب عرض السعر تتوافق مع الإدخالات في
قائمة إعدادات الناشر يمكن لنظام عروض الأسعار استخدام إعدادات الناشر
لتصفية الإعلانات المرشحة لمرة الظهور هذه لكي تكون مؤهَّلاً للحصول على مكافأة،
مرة ظهور، يجب أن يتوافق الإعلان المرشح مع جميع إدخالات إعدادات الناشر
المعرّفات التي تم إرسال بياناتها في الطلب
لاحظ أن أي إعدادات ناشر مفقودة في الملف هي
بسبب عدم حظر المعرّفات لعناوين URL مرتبطة بها.
يتم تقسيم ملف إعدادات الناشر إلى عدة ملفات أصغر حجمًا لتقليل
مقدار البيانات التي يجب تنزيلها في معاملة واحدة. الملفات
مقسّمة إلى حوالي 5 ميغابايت أجزاء وأسماء
من publisher-settings.0.pb.gz إلى
publisher-settings.n.pb.gz (حيث n هو عدد
الملفات ناقص واحد). يمكنك التواصل مع ممثل حسابك للحصول على هذه
الملفات.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle provides aggregated publisher settings lists via a Google Cloud Storage bucket for account-specific use, enabling targeting adjustments beyond bidding time.\u003c/p\u003e\n"],["\u003cp\u003eThese publisher settings files can be accessed programmatically using the Cloud Storage API, manually through the Google Developer Console UI, or via the gsutil command-line tool.\u003c/p\u003e\n"],["\u003cp\u003eThe files are gzip-compressed and contain a serialized protocol buffer that can be decompressed using commands like \u003ccode\u003egzip -d <filename>\u003c/code\u003e or with zlib-like libraries.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePublisherSettingsList\u003c/code\u003e protocol buffer definition, which provides details about the settings and an example file, can be downloaded from the reference data page or requested from your account representative.\u003c/p\u003e\n"],["\u003cp\u003ePublisher settings are split into multiple smaller, approximately 5 MB files, named \u003ccode\u003epublisher-settings.0.pb.gz\u003c/code\u003e through \u003ccode\u003epublisher-settings.n.pb.gz\u003c/code\u003e, to ease downloading.\u003c/p\u003e\n"]]],["Google provides aggregated publisher settings lists in account-specific Google Cloud Storage buckets. These files, compressed in gzip format, can be downloaded programmatically via the Cloud Storage API, manually through the Google Developer Console, or using the `gsutil` tool. They contain serialized protocol buffers that can be parsed to extract settings. Bidding systems can utilize these settings to filter ads based on identifiers included in bid requests. Files are split into ~5MB chunks. Missing settings are due to lack of associated blocked URLs.\n"],null,["# RTB Publisher Settings\n\nGoogle makes aggregated publisher settings lists available by uploading them\nto an account-specific Google Cloud Storage bucket (under a project that is\nowned by Google). You can download these to use for targeting that cannot be\ndone at bidding time. Talk to your technical account manager to enable\nthis feature for your account.\n\nThe files containing publisher settings can be downloaded programmatically\nby using the [Cloud Storage\nAPI](//cloud.google.com/storage/docs/json_api/v1/libraries), manually through the [Google Developer\nConsole](//cloud.google.com/storage/docs/cloud-console) UI, or by using the [gsutil](//cloud.google.com/storage/docs/gsutil) command-line tool.\nSee the [Google Cloud\nStorage](//cloud.google.com/storage/docs/overview) documentation for more details about accessing data stored in\nGoogle Cloud Storage.\n\nThe file is gzip-compressed according to [RFC 1952](//www.ietf.org/rfc/rfc1952.txt). To extract the file from\nthe command line, run `gzip -d \u003cfilename\u003e`. To extract the\nfile programmatically, you can use zlib or a similar compression library that\nsupports gzip format. The result is a serialized protocol buffer, similar to\nthe payload of the POST request in a `BidRequest`, which can be\nparsed with the following snippet: \n\n```gdscript\nstring compressed = /* the payload from the GET request */;\nstring uncompressed = gunzip(compressed);\nPublisherSettingsList publisher_settings;\nif (publisher_settings.ParseFromString(uncompressed)) {\n // Process the publisher settings.\n}\n```\n\nThe protocol buffer definition for `PublisherSettingsList` can be\ndownloaded from the [reference data\npage](/authorized-buyers/rtb/data). You can also request a compressed\n`publisher-settings.pb.gz` file from your account representative. It\ncontains the protocol buffer definition as well as an example publisher\nsettings file.\n\nThe ordering of `PublisherSettingsList` can change at any time.\nNo specific order or sorting is guaranteed. Each entry in the publisher\nsettings list contains an identifier, and several settings that apply to\n`BidRequests` tagged with that identifier. You can add a feature to\nyour bidding systems to periodically check for a new publisher settings list.\nWhen Google receives an impression that is eligible for real-time bidding,\nGoogle includes identifiers in the bid request that correspond to entries in\nthe publisher settings list. Your bidding system can use the publisher settings\nto filter the candidate ads for that impression. To be eligible for a given\nimpression, the candidate ad must comply with all the publisher setting entries\nfor which identifiers were sent in the request.\n\nNote that any missing publisher settings from the file are\ndue to the identifiers not having blocked URLs associated with them.\n\nThe publisher settings file is broken into multiple smaller files to reduce\nthe amount of data that must be downloaded in a single transaction. The files\nare broken into approximately 5 MB chunks and names as\n`publisher-settings.0.pb.gz` through\n`publisher-settings.n.pb.gz` (where \u003cvar translate=\"no\"\u003en\u003c/var\u003e is the number of\nfiles minus one.) Contact your account representative to obtain these\nfiles."]]
