مشاهده یا دانلود فایل هایی که از پروتکل RTB پشتیبانی می کنند.
Protos
| فایل | شرح | نسخه | اخرین به روز رسانی |
|---|---|---|---|
| cookie-bulk-upload.proto | از این پیام برای آپلود انبوه داده های هدف گذاری کاربر استفاده کنید. | v.24 | 27 مارس 2024 |
| openrtb.proto | Google از پروتکل OpenRTB با استفاده از کدگذاری JSON یا Protobuf پشتیبانی می کند. اگر از OpenRTB/Protobuf استفاده می کنید، این پروتو ضروری است. همچنین شامل مستندات فیلدهای پشتیبانی شده و نگاشت آنها به پروتکل بومی Google است. | 2.6 | 23 مارس 2024 |
| openrtb-adx.proto | پروتکل OpenRTB گوگل شامل برخی از برنامه های افزودنی است که در یک پروتکل جداگانه ارائه شده است. | نسخه 171 | 17 آوریل 2024 |
| publisher-settings.proto | مجموعه ای از تنظیمات ناشر خاص برای یک شبکه پیشنهاددهنده بلادرنگ. | نسخه 13 | 05 فوریه 2024 |
| بیدرنگ مناقصه.proto | پروتکل RTB خریداران مجاز Google. این پیامی است که گوگل برای درخواست پیشنهادات استفاده می کند. BidRequest شامل جایگاه آگهی از یک نمایش است. | نسخه 324 | 17 آوریل 2024 |
نسخه های اولیه بتا را باز کنید
| فایل | شرح | نسخه | اخرین به روز رسانی |
|---|---|---|---|
| openrtb-adx.proto | پروتکل OpenRTB گوگل شامل برخی از برنامه های افزودنی است که در یک پروتکل جداگانه ارائه شده است. | v.174 | 17 آوریل 2024 |
| بیدرنگ مناقصه.proto | پروتکل RTB خریداران مجاز Google. این پیامی است که گوگل برای درخواست پیشنهادات استفاده می کند. BidRequest شامل جایگاه آگهی از یک نمایش است. | نسخه 331 | 17 آوریل 2024 |
داده های مرجع
دیکشنری ها (برای دانلود فایل 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 استفاده می شود. این فیلد تبلیغ‌کننده‌ای را مشخص می‌کند که توسط خلاقیت مرتبط با قطعه نمایش داده می‌شود. این فهرست آگهی‌دهندگان را در صرافی نشان می‌دهد و آگهی‌دهندگانی را که توسط هیچ یک از خریدار نمایندگی می‌شوند را نشان نمی‌دهد. |
| برندها | فهرست برندهای مورد استفاده در Client Access 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 در معرض دید قرار گرفته استفاده می‌شود. این فیلد ویژگی‌های خلاقانه‌ای را توصیف می‌کند که انتظار می‌رود در همه خلاقیت‌های مربوط به یک پیکربندی پیش‌هدف‌یابی واحد وجود داشته باشد. |
| ویژگی‌های خلاق قابل حذف توسط ناشر | در قسمت excluded_attribute BidRequest استفاده می شود. این فیلد انواع خلاقیت‌هایی را که توسط ناشر مجاز نیست توضیح می‌دهد. برای مثال، ممکن است محدودیت‌هایی را در مورد مجاز بودن استفاده از کوکی، یا مجاز بودن تبلیغات رسانه‌ای و/یا متنی مشخص کنند. |
| عمودی ناشر | در قسمت detected_vertical BidRequest استفاده می شود. این فیلد عمودی (مشابه کلمات کلیدی) صفحه ای که تبلیغ در آن نمایش داده می شود را مشخص می کند. گوگل با خزیدن در صفحه و تعیین اینکه کدام عمودی استفاده می شود، این فیلد را ایجاد می کند. |
| شناسه شبکه فروشنده | در قسمت seller_network_id BidRequest استفاده می شود. این قسمت شبکه فروشنده ای که ناشر به آن تعلق دارد را مشخص می کند. محتویات این فایل بر اساس مقدار شناسه شبکه فروشنده به ترتیب صعودی می باشد. |
| فروشندگان | در قسمت allowed_vendor_type BidRequest استفاده می شود. این فیلد فروشندگان Rich Media، مانند Campaign Monitor و VoiceFive را فهرست می‌کند که طبق مشخص‌شده توسط ناشر، برای ارائه خلاقیت مجاز هستند. شامل فروشندگان از فایل فرهنگ لغت |
جداول مرجع (برای دانلود CSV ها کلیک کنید) | |
| برنامه های موبایل اندروید | فهرست برنامه‌های تلفن همراه Android قابل هدف با شناسه برنامه، شناسه دسته‌ها و نام برنامه‌های قابل خواندن توسط انسان. |
| جداول جغرافیایی | جدول مورد استفاده برای رمزگشایی فیلد geo_criteria_id BidRequest . برای اطلاعات بیشتر به هدف گذاری جغرافیایی مراجعه کنید. |
| ارائه دهندگان LGPD | فهرست ارائه‌دهندگان شخصی‌سازی آگهی‌هایی که مجاز به ارائه در ترافیک LGPD هستند، با شناسه، نام قابل خواندن توسط انسان، URL حریم خصوصی، و فهرستی از دامنه‌هایی که می‌توان به ارائه‌دهنده نسبت داد. اجرای LGPD در یک درخواست پیشنهادی معین از طریق قسمت BidRequest.adslot.regs_lgpd در پروتکل پیشنهاد خریداران مجاز و قسمت BidRequest.regs.ext.lgpd در پروتکل پیشنهادی OpenRTB نشان داده می شود. |
| اپراتورهای موبایل | لیست اپراتورهای تلفن همراه |
| دستگاه های موبایل | لیست دستگاه های تلفن همراه |
| سیستم عامل های موبایل | لیست سیستم عامل های موبایل |
| ارائه دهندگان | شناسه‌های ارائه‌دهنده شخصی‌سازی تبلیغات Maps به یک نام قابل خواندن برای انسان، یک URL خط‌مشی رازداری، و فهرستی از دامنه‌هایی که می‌توان به ارائه‌دهنده نسبت داد. در حال حاضر، ارائه دهندگان در قسمت BidRequest.AdSlot.consented_providers_settings برای پروتکل AdX و BidRequest.User.UserExt.consented_providers_settings برای پروتکل OpenRTB استفاده می شوند. در این زمینه‌ها، ارائه‌دهندگان فهرست‌شده رضایت کاربر را دارند که توسط ناشران برای کاربران کشورهای منطقه اقتصادی اروپا تصویب شده است. |
تنظیمات ناشر
فایل publisher-settings.pb.gz را از نماینده حساب خود درخواست کنید.
موضوعات خط مشی بررسی خلاقانه
می‌توانید از موضوعات خط‌مشی در این فایل برای فیلتر کردن خلاقیت‌ها در حین بررسی در API بیدرنگ پیشنهاد استفاده کنید
موضوعات خط مشی را به صورت فایل CSV دانلود کنید.آخرین به روز رسانی: 18 آوریل 2022