تنظیمات ناشر RTB
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Google فهرست‌های تنظیمات ناشر انبوه را با آپلود آنها در سطل فضای ذخیره‌سازی Google Cloud مخصوص حساب (تحت پروژه‌ای که متعلق به Google است) در دسترس قرار می‌دهد. می‌توانید این موارد را دانلود کنید تا برای هدف‌یابی که در زمان مناقصه قابل انجام نیست، استفاده کنید. با مدیر حساب فنی خود صحبت کنید تا این ویژگی را برای حساب خود فعال کنید.
فایل‌های حاوی تنظیمات ناشر را می‌توان با استفاده از Cloud Storage API ، به صورت دستی از طریق رابط کاربری کنسول توسعه‌دهنده Google یا با استفاده از ابزار خط فرمان gsutil بارگیری کرد. برای جزئیات بیشتر در مورد دسترسی به داده های ذخیره شده در Google Cloud Storage، به مستندات Google Cloud Storage مراجعه کنید.
فایل بر اساس RFC 1952 با gzip فشرده شده است. برای استخراج فایل از خط فرمان، 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-18 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-18 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
