مشاهده یا بارگیری فایل‌هایی که از «پروتکل RTB» پشتیبانی می‌کنند.
پروتوس
| فایل | شرح | نسخه | Last Updated |
|---|---|---|---|
| cookie-bulk-upload.proto | از این پیام برای بارگذاری انبوه داده‌های هدف‌یابی کاربر استفاده کنید. | v.25 | ۲۷ مارس ۲۰۲۴ |
| openrtb.proto | Google از پروتکل OpenRTB بااستفاده از کدبندی JSON یا Protobuf پشتیبانی می‌کند. اگر از OpenRTB/Protobuf استفاده می‌کنید، این نمونه اولیه ضروری است. همچنین شامل مستندات فیلدهای پشتیبانی‌شده و نگاشت آن‌ها به پروتکل بومی Google است. | ۲.۶ | ۱۵ اکتبر ۲۰۲۶ |
| openrtb-adx.proto | پروتکل OpenRTB در Google شامل برخی افزونه‌ها است که در یک proto جداگانه ارائه شده است. | v.210 | ۴ اوت ۲۰۲۶ |
| publisher-settings.proto | مجموعه‌ای از تنظیمات ناشر که مختص شبکه پیشنهاددهنده قیمت هم‌زمان است. | v.14 | ۵ فوریه ۲۰۲۴ |
نسخه بتای عمومی Protos
| فایل | شرح | نسخه | Last Updated |
|---|---|---|---|
| openrtb-adx.proto | پروتکل OpenRTB در Google شامل برخی افزونه‌ها است که در یک proto جداگانه ارائه شده است. | v.220 | ۱۶ سپتامبر ۲۰۲۶ |
داده مرجع
فرهنگ لغت (برای بارگیری فایل .txt کلیک کنید) |
|
|---|---|
| دسته‌های محصول آگهی | در فیلد excluded_product_category از
BidRequest استفاده شده است. این فیلد دسته‌های محصولات و خدماتی را که ناشر اجازه نمی‌دهد شرح می‌دهد، برای مثال، اگر ناشر نخواهد آگهی‌های مربوط به بانکداری آنلاین را میزبانی کند. |
| دسته‌های محدودشده آگهی | در فیلد allowed_restricted_category از
BidRequest و فیلد restricted_category از
BidResponse استفاده شده است. allowed_restricted_category
فیلد دسته‌هایی را توصیف می‌کند که معمولاً محدود شده‌اند، اما صریحاً
توسط ناشر به‌عنوان مجاز اعلام شده‌اند، برای مثال، آگهی‌های حاوی
محتوای مرتبط با الکل. |
| دسته‌های حساس آگهی | در فیلد excluded_sensitive_category از
BidRequest و فیلد category از
BidResponse استفاده شده است. فیلد excluded_sensitive_category
دسته‌های حساس را که ناشر اجازه نمی‌دهد شرح می‌دهد،
برای مثال، اگر ناشر نمی‌خواهد میزبان آگهی‌های مرتبط با
سیاست باشد. |
| تبلیغ‌کنندگان | Used in the advertiser_id field of SnippetStatusItem. این
فیلد آگهی‌دهنده‌ای را مشخص می‌کند که طرح آگهی مرتبط با
گزیده نشان می‌دهد. این فهرست نشان‌دهنده تبلیغ‌کنندگان در سراسر صرافی است و
نشان‌دهنده تبلیغ‌کنندگانی نیست که توسط یک خریدار نمایندگی می‌شوند. |
| نمانام‌ها | فهرست نمانام‌ها، استفاده‌شده در Client Access API. |
| مشخصه‌های طرح‌آگهی قابل‌اعلام توسط خریدار | برای فیلد attribute در BidResponse استفاده می‌شود.
این فیلد مشخصه‌های قابل‌اعلام خریدار را در طرح‌آگهی‌هایی که نباید در excluded_attribute در
BidRequest نشان داده شود شرح می‌دهد. |
| کدهای وضعیت نوشته راهنما | رمزهای وضعیت برگردانده‌شده توسط فراخوانی روش performancereport. |
| برچسب‌های محتوا | در فیلد detected_content_labels
BidRequest استفاده می‌شود. |
| کدهای وضعیت تطبیق‌دهنده کوکی | در فیلد cookieMatcherStatusRate گزارش‌های عملکرد «پروتکل مناقصه هم‌زمان» استفاده می‌شود. کدهای دردسترس در راهنمای تطابق کوکی
شرح داده شده‌اند. |
| کدهای وضعیت طرح‌آگهی | استفاده‌شده در creative_status_code در بازخورد
هم‌زمان برگردانده شد.
|
| کدهای وضعیت مطابقت میزبانی‌شده | در فیلد hostedMatchStatusRate از گزارش‌های عملکرد «پروتکل RTB»
استفاده می‌شود. |
| بدون دلیل پیشنهاد قیمت | مقادیر استاندارد دلیل عدم پیشنهاد قیمت که باید در فیلد BidResponse.no_bid_reason در پروتکل پیشنهاد قیمت Authorized Buyers ارائه شود. |
| مشخصه‌های طرح‌آگهی قابل‌هدف‌یابی پیشاپیش | در فیلد supportedCreativeAttribute در منبع
PretargetingConfig که در Buyer REST API نمایان شده است استفاده می‌شود. این فیلد
مشخصه‌های طرح آگهی را که انتظار می‌رود در همه طرح‌های آگهی وجود داشته باشد
مطابق با یک پیکربندی پیش‌هدف‌یابی شرح می‌دهد. |
| مشخصه‌های طرح آگهی قابل‌استثنا کردن توسط ناشر | در فیلد excluded_attribute از
BidRequest استفاده می‌شود. این فیلد انواع طرح‌آگهی‌هایی را که
ناشر اجازه استفاده از آن‌ها را نمی‌دهد شرح می‌دهد. برای مثال، ممکن است محدودیت‌هایی را درباره مجاز بودن استفاده از کوکی یا مجاز بودن آگهی‌های رسانه‌ای و/یا نوشتاری مشخص کنند. |
| فروشندگان | در فیلد allowed_vendor_type از
BidRequest استفاده شده است. این فیلد فهرست می‌کند کدام فروشندگان «رسانه‌های غنی»، مثل
Campaign Monitor و VoiceFive، برای عناصر خلاقی که ارائه می‌شود مجاز هستند،
همان‌طور که ناشر مشخص کرده است. شامل فروشندگان از فایل واژه‌نامه
|
| ارائه‌دهندگان داده | در فیلد SegmentData.id از
BidRequest استفاده شده است. این فیلد حاوی اطلاعاتی درباره نهادی است که
نشان‌های ناشرداده را ارائه کرده است. |
جدول‌های مرجع (برای بارگیری فایل‌های CSV کلیک کنید) |
|
| برنامه‌های تلفن همراه Android | فهرست برنامه‌های تلفن همراه Android هدف‌یابی‌شدنی با شناسه برنامه، شناسه دسته، و نام برنامه قابل‌خواندن برای انسان. |
| جدول‌های جغرافیایی | جدول استفاده‌شده برای رمزگشایی فیلد geo_criteria_id از
BidRequest. برای اطلاعات بیشتر به هدف‌یابی جغرافیایی مراجعه کنید. |
| ارائه‌دهندگان LGPD |
فهرست ارائه‌دهندگان شخصی‌سازی آگهی که مجاز به ارائه در ترافیک LGPD هستند،
به‌همراه شناسه، نام قابل‌خواندن برای انسان، نشانی وب حریم خصوصی، و فهرست دامنه‌هایی
که می‌توانند به ارائه‌دهنده نسبت داده شوند. اجرای LGPD در درخواست پیشنهاد قیمت مشخصی ازطریق فیلد BidRequest.adslot.regs_lgpd در پروتکل پیشنهاد قیمت «خریداران مجاز» و فیلد BidRequest.regs.ext.lgpd در پروتکل پیشنهاد قیمت OpenRTB نشان داده می‌شود.
|
| شرکت‌های مخابراتی تلفن همراه | فهرست شرکت‌های مخابراتی تلفن همراه. |
| دستگاه‌های همراه | فهرست دستگاه‌های همراه. |
| سیستم‌عامل‌های تلفن همراه | فهرست سیستم‌عامل‌های تلفن همراه. |
| ارائه‌دهندگان | شناسه‌های ارائه‌دهنده شخصی‌سازی آگهی‌های Maps را به نام قابل‌خواندن توسط انسان، نشانی وب خط‌مشی رازداری، و فهرست دامنه‌هایی که می‌توانند به ارائه‌دهنده نسبت داده شوند نگاشت می‌کند.
درحال‌حاضر، ارائه‌دهندگان در فیلد
BidRequest.AdSlot.consented_providers_settings برای پروتکل
AdX و
BidRequest.User.UserExt.consented_providers_settings برای پروتکل
OpenRTB استفاده می‌شوند. در این فیلدها، ارائه‌دهندگان فهرست‌شده رضایت کاربر را همان‌گونه که
ناشران برای کاربران ساکن کشورهای «منطقه اقتصادی اروپا» ارسال کرده‌اند دارند. |
تنظیمات ناشر
فایل publisher-settings.pb.gz را از نماینده حسابتان درخواست کنید.
موضوعات خط‌مشی بازبینی طرح‌آگهی
می‌توانید از موضوعات خط‌مشی در این فایل برای فیلتر کردن طرح‌آگهی‌ها درطول بازبینی در Real-time Bidding API استفاده کنید
موضوعات خط‌مشی را در قالب فایل CSV بارگیری کنید.آخرین به‌روزرسانی: ۱۸ آوریل ۲۰۲۲