پروتوها و داده های مرجع

فایل‌هایی را که از پروتکل RTB پشتیبانی می‌کنند، مشاهده یا دانلود کنید.

پروتوس

فایل توضیحات نسخه آخرین به‌روزرسانی
آپلود دسته‌ای کوکی.proto از این پیام برای آپلود انبوه داده‌های هدف‌گیری کاربر استفاده کنید. آیه ۲۴ ۲۷ مارس ۲۰۲۴
openrtb.proto Google supports the OpenRTB protocol, using either JSON or Protobuf encoding. This proto is necessary if you use OpenRTB/Protobuf. It also includes documentation of supported fields and their mapping to Google's native protocol. ۲.۶ ۱۵ دسامبر ۲۰۲۵
openrtb-adx.proto پروتکل OpenRTB گوگل شامل برخی افزونه‌ها است که در یک نمونه اولیه جداگانه ارائه شده‌اند. آیه ۲۰۲ ۷ ژانویه ۲۰۲۶
تنظیمات ناشر.proto مجموعه‌ای از تنظیمات ناشر مخصوص یک شبکه پیشنهاددهنده بلادرنگ. آیه ۱۴ ۵ فوریه ۲۰۲۴

پروتوس بتا را باز کنید

فایل توضیحات نسخه آخرین به‌روزرسانی
openrtb-adx.proto پروتکل OpenRTB گوگل شامل برخی افزونه‌ها است که در یک نمونه اولیه جداگانه ارائه شده‌اند. آیه ۲۱۰ ۷ ژانویه ۲۰۲۶

داده‌های مرجع

واژه‌نامه‌ها (برای دانلود فایل .txt کلیک کنید)

دسته بندی محصولات تبلیغاتی Used in the excluded_product_category field of BidRequest . This field describes categories of products and services that are not allowed by a publisher, for example, if the publisher doesn't want to host ads related to online banking.
دسته‌های محدود شده برای تبلیغات Used in the allowed_restricted_category field of BidRequest and the restricted_category field of BidResponse . The allowed_restricted_category field describes categories that are normally restricted, but explicitly declared by a publisher as allowed, for example, ads containing alcohol-related content.
دسته‌های حساس به تبلیغات Used in the excluded_sensitive_category field of BidRequest and the category field of BidResponse . The excluded_sensitive_category field describes sensitive categories that are not allowed by the publisher, for example, if the publisher does not want to host ads related to politics.
تبلیغ‌کنندگان Used in the advertiser_id field of SnippetStatusItem. This field specifies the advertiser represented by the creative associated with the snippet. This list reflects advertisers across the exchange and does not reflect the advertisers represented by any one buyer.
برندها فهرست برندهای مورد استفاده در API دسترسی کلاینت.
ویژگی‌های خلاقانه قابل اعلام توسط خریدار برای فیلد attribute در BidResponse استفاده می‌شود. این فیلد ویژگی‌های قابل اعلام توسط خریدار را در آگهی‌ها توصیف می‌کند که نباید در excluded_attribute در BidRequest ظاهر شوند.
کدهای وضعیت فراخوانی کدهای وضعیتی که توسط فراخوانی متد performancereport برگردانده می‌شوند.
برچسب‌های محتوا در فیلد detected_content_labels از BidRequest استفاده می‌شود.
کدهای وضعیت تطبیق کوکی در فیلد cookieMatcherStatusRate از گزارش‌های عملکرد پروتکل RTB استفاده می‌شود. کدهای موجود در راهنمای تطبیق کوکی شرح داده شده‌اند.
کدهای وضعیت خلاقانه

مورد استفاده در

creative_status_code در بازخورد بلادرنگ بازگردانده شد.
کدهای وضعیت مسابقه میزبانی شده در فیلد hostedMatchStatusRate از گزارش‌های عملکرد پروتکل RTB استفاده می‌شود.
دلایل پیشنهاد قیمت وجود ندارد مقادیر استاندارد دلیل عدم پیشنهاد که باید در فیلد BidResponse.no_bid_reason در پروتکل پیشنهاد خریداران مجاز ارائه شوند.
ویژگی‌های خلاقانه از پیش تعیین‌شده Used in the supportedCreativeAttribute field in the PretargetingConfig resource exposed in the Buyer REST API. This field describes creative attributes expected to be present in all creatives corresponding to a single pretargeting configuration.
ویژگی‌های خلاقانه‌ی قابل استثنا توسط ناشر Used in the excluded_attribute field of BidRequest . This field describes the types of creatives that are not allowed by the publisher. For example, they might specify restrictions on whether cookie usage is allowed, or whether media and/or text ads are allowed.
فروشندگان Used in the allowed_vendor_type field of BidRequest . This field lists which Rich Media vendors, such as Campaign Monitor and VoiceFive, are allowed for the creative being served, as specified by the publisher.

شامل فروشندگان فایل دیکشنری sunsetted gdn-vendors.txt می‌شود.

ارائه دهندگان داده در فیلد SegmentData.id از BidRequest استفاده می‌شود. این فیلد حاوی اطلاعاتی در مورد موجودیتی است که سیگنال‌های ارائه شده توسط ناشر را ارائه داده است.

جداول مرجع (برای دانلود CSV کلیک کنید)

اپلیکیشن‌های موبایل اندروید فهرست برنامه‌های تلفن همراه اندروید قابل هدف‌گیری به همراه شناسه برنامه، شناسه دسته‌بندی و نام‌های برنامه قابل خواندن توسط انسان.
جداول جغرافیایی جدولی که برای رمزگشایی فیلد geo_criteria_id از BidRequest استفاده شده است. برای اطلاعات بیشتر به Geotargeting مراجعه کنید.
ارائه دهندگان 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 را از نماینده حساب خود درخواست کنید.

مباحث مربوط به سیاست بررسی خلاقانه

شما می‌توانید از مباحث مربوط به خط‌مشی در این فایل برای فیلتر کردن آگهی‌های تبلیغاتی در طول بررسی در API مناقصه در زمان واقعی استفاده کنید.

مباحث مربوط به خط‌مشی را به عنوان فایل CSV دانلود کنید.

آخرین به‌روزرسانی: ۱۸ آوریل ۲۰۲۲

،

فایل‌هایی را که از پروتکل RTB پشتیبانی می‌کنند، مشاهده یا دانلود کنید.

پروتوس

فایل توضیحات نسخه آخرین به‌روزرسانی
آپلود دسته‌ای کوکی.proto از این پیام برای آپلود انبوه داده‌های هدف‌گیری کاربر استفاده کنید. آیه ۲۴ ۲۷ مارس ۲۰۲۴
openrtb.proto Google supports the OpenRTB protocol, using either JSON or Protobuf encoding. This proto is necessary if you use OpenRTB/Protobuf. It also includes documentation of supported fields and their mapping to Google's native protocol. ۲.۶ ۱۵ دسامبر ۲۰۲۵
openrtb-adx.proto پروتکل OpenRTB گوگل شامل برخی افزونه‌ها است که در یک نمونه اولیه جداگانه ارائه شده‌اند. آیه ۲۰۲ ۷ ژانویه ۲۰۲۶
تنظیمات ناشر.proto مجموعه‌ای از تنظیمات ناشر مخصوص یک شبکه پیشنهاددهنده بلادرنگ. آیه ۱۴ ۵ فوریه ۲۰۲۴

پروتوس بتا را باز کنید

فایل توضیحات نسخه آخرین به‌روزرسانی
openrtb-adx.proto پروتکل OpenRTB گوگل شامل برخی افزونه‌ها است که در یک نمونه اولیه جداگانه ارائه شده‌اند. آیه ۲۱۰ ۷ ژانویه ۲۰۲۶

داده‌های مرجع

واژه‌نامه‌ها (برای دانلود فایل .txt کلیک کنید)

دسته بندی محصولات تبلیغاتی Used in the excluded_product_category field of BidRequest . This field describes categories of products and services that are not allowed by a publisher, for example, if the publisher doesn't want to host ads related to online banking.
دسته‌های محدود شده برای تبلیغات Used in the allowed_restricted_category field of BidRequest and the restricted_category field of BidResponse . The allowed_restricted_category field describes categories that are normally restricted, but explicitly declared by a publisher as allowed, for example, ads containing alcohol-related content.
دسته‌های حساس به تبلیغات Used in the excluded_sensitive_category field of BidRequest and the category field of BidResponse . The excluded_sensitive_category field describes sensitive categories that are not allowed by the publisher, for example, if the publisher does not want to host ads related to politics.
تبلیغ‌کنندگان Used in the advertiser_id field of SnippetStatusItem. This field specifies the advertiser represented by the creative associated with the snippet. This list reflects advertisers across the exchange and does not reflect the advertisers represented by any one buyer.
برندها فهرست برندهای مورد استفاده در API دسترسی کلاینت.
ویژگی‌های خلاقانه قابل اعلام توسط خریدار برای فیلد attribute در BidResponse استفاده می‌شود. این فیلد ویژگی‌های قابل اعلام توسط خریدار را در آگهی‌ها توصیف می‌کند که نباید در excluded_attribute در BidRequest ظاهر شوند.
کدهای وضعیت فراخوانی کدهای وضعیتی که توسط فراخوانی متد performancereport برگردانده می‌شوند.
برچسب‌های محتوا در فیلد detected_content_labels از BidRequest استفاده می‌شود.
کدهای وضعیت تطبیق کوکی در فیلد cookieMatcherStatusRate از گزارش‌های عملکرد پروتکل RTB استفاده می‌شود. کدهای موجود در راهنمای تطبیق کوکی شرح داده شده‌اند.
کدهای وضعیت خلاقانه

مورد استفاده در

creative_status_code در بازخورد بلادرنگ بازگردانده شد.
کدهای وضعیت مسابقه میزبانی شده در فیلد hostedMatchStatusRate از گزارش‌های عملکرد پروتکل RTB استفاده می‌شود.
دلایل پیشنهاد قیمت وجود ندارد مقادیر استاندارد دلیل عدم پیشنهاد که باید در فیلد BidResponse.no_bid_reason در پروتکل پیشنهاد خریداران مجاز ارائه شوند.
ویژگی‌های خلاقانه از پیش تعیین‌شده Used in the supportedCreativeAttribute field in the PretargetingConfig resource exposed in the Buyer REST API. This field describes creative attributes expected to be present in all creatives corresponding to a single pretargeting configuration.
ویژگی‌های خلاقانه‌ی قابل استثنا توسط ناشر Used in the excluded_attribute field of BidRequest . This field describes the types of creatives that are not allowed by the publisher. For example, they might specify restrictions on whether cookie usage is allowed, or whether media and/or text ads are allowed.
فروشندگان Used in the allowed_vendor_type field of BidRequest . This field lists which Rich Media vendors, such as Campaign Monitor and VoiceFive, are allowed for the creative being served, as specified by the publisher.

شامل فروشندگان فایل دیکشنری sunsetted gdn-vendors.txt می‌شود.

ارائه دهندگان داده در فیلد SegmentData.id از BidRequest استفاده می‌شود. این فیلد حاوی اطلاعاتی در مورد موجودیتی است که سیگنال‌های ارائه شده توسط ناشر را ارائه داده است.

جداول مرجع (برای دانلود CSV کلیک کنید)

اپلیکیشن‌های موبایل اندروید فهرست برنامه‌های تلفن همراه اندروید قابل هدف‌گیری به همراه شناسه برنامه، شناسه دسته‌بندی و نام‌های برنامه قابل خواندن توسط انسان.
جداول جغرافیایی جدولی که برای رمزگشایی فیلد geo_criteria_id از BidRequest استفاده شده است. برای اطلاعات بیشتر به Geotargeting مراجعه کنید.
ارائه دهندگان 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 را از نماینده حساب خود درخواست کنید.

مباحث مربوط به سیاست بررسی خلاقانه

شما می‌توانید از مباحث مربوط به خط‌مشی در این فایل برای فیلتر کردن آگهی‌های تبلیغاتی در طول بررسی در API مناقصه در زمان واقعی استفاده کنید.

مباحث مربوط به خط‌مشی را به عنوان فایل CSV دانلود کنید.

آخرین به‌روزرسانی: ۱۸ آوریل ۲۰۲۲