فایل‌هایی را که از پروتکل RTB پشتیبانی می‌کنند، مشاهده یا دانلود کنید.
پروتوس
| فایل | توضیحات | نسخه | آخرین به‌روزرسانی |
|---|---|---|---|
| آپلود دسته‌ای کوکی.proto | از این پیام برای آپلود انبوه داده‌های هدف‌گیری کاربر استفاده کنید. | آیه ۲۴ | ۲۷ مارس ۲۰۲۴ |
| openrtb.proto | گوگل از پروتکل OpenRTB با استفاده از کدگذاری JSON یا Protobuf پشتیبانی می‌کند. اگر از OpenRTB/Protobuf استفاده می‌کنید، این proto ضروری است. همچنین شامل مستندات فیلدهای پشتیبانی شده و نگاشت آنها به پروتکل بومی گوگل است. | ۲.۶ | ۶ اکتبر ۲۰۲۵ |
| openrtb-adx.proto | پروتکل OpenRTB گوگل شامل برخی افزونه‌ها است که در یک نمونه اولیه جداگانه ارائه شده‌اند. | آیه ۱۹۸ | ۲۰ اکتبر ۲۰۲۵ |
| تنظیمات ناشر.proto | مجموعه‌ای از تنظیمات ناشر مخصوص یک شبکه پیشنهاددهنده بلادرنگ. | آیه ۱۴ | ۵ فوریه ۲۰۲۴ |
پروتوس بتا را باز کنید
| فایل | توضیحات | نسخه | آخرین به‌روزرسانی |
|---|---|---|---|
| openrtb-adx.proto | پروتکل OpenRTB گوگل شامل برخی افزونه‌ها است که در یک نمونه اولیه جداگانه ارائه شده‌اند. | آیه ۲۰۵ | ۲۰ اکتبر ۲۰۲۵ |
داده‌های مرجع
واژه‌نامه‌ها (برای دانلود فایل .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 استفاده می‌شود. این فیلد، تبلیغ‌کننده‌ای را که توسط آگهی مرتبط با قطعه نمایش داده می‌شود، مشخص می‌کند. این لیست، تبلیغ‌کنندگان را در سراسر صرافی نشان می‌دهد و تبلیغ‌کنندگانی را که توسط هیچ خریدار خاصی نمایش داده می‌شوند، منعکس نمی‌کند. |
| برندها | فهرست برندهای مورد استفاده در API دسترسی کلاینت. |
| ویژگی‌های خلاقانه قابل اعلام توسط خریدار | برای فیلد attribute در BidResponse استفاده می‌شود. این فیلد ویژگی‌های قابل اعلام توسط خریدار را در آگهی‌ها توصیف می‌کند که نباید در excluded_attribute در BidRequest ظاهر شوند. |
| کدهای وضعیت فراخوانی | کدهای وضعیتی که توسط فراخوانی متد performancereport برگردانده می‌شوند. |
| برچسب‌های محتوا | در فیلد detected_content_labels از BidRequest استفاده می‌شود. |
| کدهای وضعیت تطبیق کوکی | در فیلد cookieMatcherStatusRate از گزارش‌های عملکرد پروتکل RTB استفاده می‌شود. کدهای موجود در راهنمای تطبیق کوکی شرح داده شده‌اند. |
| کدهای وضعیت خلاقانه | مورد استفاده در creative_status_code در بازخورد بلادرنگ بازگردانده شد. |
| کدهای وضعیت مسابقه میزبانی شده | در فیلد hostedMatchStatusRate از گزارش‌های عملکرد پروتکل RTB استفاده می‌شود. |
| دلایل پیشنهاد قیمت وجود ندارد | مقادیر استاندارد دلیل عدم پیشنهاد که باید در فیلد BidResponse.no_bid_reason در پروتکل پیشنهاد خریداران مجاز ارائه شوند. |
| ویژگی‌های خلاقانه از پیش تعیین‌شده | در فیلد supportedCreativeAttribute در منبع PretargetingConfig که در Buyer REST API قرار دارد، استفاده می‌شود. این فیلد، ویژگی‌های خلاقانه‌ای را که انتظار می‌رود در تمام آگهی‌های تبلیغاتی مربوط به یک پیکربندی pretargeting واحد وجود داشته باشد، توصیف می‌کند. |
| ویژگی‌های خلاقانه‌ی قابل استثنا توسط ناشر | در فیلد excluded_attribute از BidRequest استفاده می‌شود. این فیلد انواع تبلیغاتی را که توسط ناشر مجاز نیستند، توصیف می‌کند. برای مثال، آنها ممکن است محدودیت‌هایی در مورد مجاز بودن استفاده از کوکی یا مجاز بودن تبلیغات رسانه‌ای و/یا متنی تعیین کنند. |
| فروشندگان | در فیلد allowed_vendor_type از BidRequest استفاده می‌شود. این فیلد فهرستی از فروشندگان Rich Media، مانند Campaign Monitor و VoiceFive، را که طبق مشخصات ناشر، مجاز به ارائه محتوای خلاقانه هستند، ارائه می‌دهد. شامل فروشندگان فایل دیکشنری sunsetted |
| ارائه دهندگان داده | در فیلد 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 دانلود کنید.آخرین به‌روزرسانی: ۱۸ آوریل ۲۰۲۲