Display & Video 360 API v2 غروب است. به جای آن از Display & Video 360 API v3 استفاده کنید. برای دستورالعمل‌های انتقال نسخه 2 به نسخه 3، راهنمای مهاجرت ما را ببینید.
نسخه های Display & Video 360 API به طور منظم منتشر، منسوخ و غروب می شوند. این مراحل به صورت زیر تعریف می شوند:
انتشار : نسخه از هر وضعیت آلفا یا بتا خارج می شود و پایدار در نظر گرفته می شود. ممکن است همچنان ویژگی های اضافه شده برای نسخه منتشر شود.
منسوخ شدن : نسخه در حال بازنشستگی است و تاریخ پایان پشتیبانی (غروب آفتاب) اعلام شده است. کاربران باید قبل از غروب آفتاب به نسخه جدیدتر مهاجرت کنند. ویژگی های اضافه شده دیگر برای نسخه منتشر نخواهد شد.
غروب : نسخه دیگر پشتیبانی نمی شود. درخواست‌هایی که به نسخه ارسال می‌شود یک خطا را برمی‌گرداند.
جدول زیر تمام نسخه‌های هسته اصلی Display & Video 360 API، تاریخ انتشار آنها، و تاریخ‌های منسوخ شدن و غروب آفتاب را در صورت اعلام فهرست می‌کند.
جدول زیر تمام موارد منسوخ شدن ویژگی های اعلام شده را فهرست می کند، تاریخ شروع اولیه و شرحی از انحلال را همراه با اقدامات توصیه شده و پیوندهایی به اسناد مربوطه ارائه می دهد:
ویژگی
تاریخ شروع اولیه
توضیحات
توسعه هدف گذاری
25 مارس 2023
جایگزینی ویژگی گسترش هدف‌گیری با هدف‌یابی بهینه شده ، از ۲۵ مارس ۲۰۲۳ تا اوایل ماه مه ۲۰۲۳ به‌تدریج اجرا شد. تغییرات مربوط به Display & Video 360 API و رفتار فایل‌های داده ساختاریافته و همچنین اقدامات توصیه‌شده در یک پست وبلاگ اعلام شد.
محرک های دستی
17 مه 2023
جدول زمانی:
17 مه 2023: موارد خطی که از محرک‌های دستی استفاده می‌کنند در Display & Video 360 متوقف می‌شوند. اگر پس از این تاریخ یک راه‌انداز دستی مرتبط با یک مورد خط فعال را فعال کنید، مورد خط تبلیغاتی را نمایش نمی‌دهد.
برنامه‌های نصب‌شده و دستگاه‌های تلفن همراه جدید انواع GoogleAudience
20 مه 2023
جدول زمانی:
20 مه 2023: دیگر نمی‌توانید منابع GoogleAudience را با GoogleAudienceType از GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS یا GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES به هدف‌یابی مخاطب خط یا سفارش درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌یابی مخاطب خطی اختصاص می‌دهند، با خطا مواجه می‌شوند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، در صورتی که مورد خط ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطبانش باشد.
8 ژوئن 2023: مخاطبان تحت تأثیر از همه هدف‌گذاری مورد خط و سفارش درج و از همه مخاطبان ترکیبی حذف خواهند شد. اگر زمانی که این مخاطبان حذف می‌شوند، یک مورد خطی نتواند تبلیغات را ارائه دهد، موقتاً متوقف می‌شود. در این تاریخ، این مخاطبان دیگر با استفاده از سرویس googleAudiences قابل بازیابی نخواهند بود.
وظایف پیشنهادی:
توصیه می‌کنیم هنگام به‌روزرسانی‌های آینده برای هدف‌یابی مورد خط خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید.
همه مخاطبان تحت تأثیر را از هدف گذاری مورد خط موجود و سفارش درج حذف کنید. درباره به‌روزرسانی هدف‌گیری مخاطب در راهنمای مخاطبان هدف ما بخوانید.
20 مه 2023: دیگر نمی‌توانید منابع FirstAndThirdPartyAudience را با AudienceTypeACTIVITY_BASED یا FREQUENCY_CAP به هدف‌یابی مخاطب خطی یا سفارش درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌یابی مخاطب خطی اختصاص می‌دهند، با خطا مواجه می‌شوند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، در صورتی که مورد خط ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطبانش باشد.
8 ژوئن 2023: مخاطبان تحت تأثیر از همه هدف‌گذاری مورد خط و سفارش درج و از همه مخاطبان ترکیبی حذف خواهند شد. اگر زمانی که این مخاطبان حذف می‌شوند، یک مورد خطی نتواند تبلیغات را ارائه دهد، موقتاً متوقف می‌شود. در این تاریخ، این مخاطبان نیز دیگر با استفاده از سرویس firstAndThirdPartyAudiences قابل بازیابی نخواهند بود.
وظایف پیشنهادی:
توصیه می‌کنیم هنگام به‌روزرسانی‌های آینده برای هدف‌یابی مورد خط خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید.
همه مخاطبان تحت تأثیر را از هدف گذاری مورد خط موجود و سفارش درج حذف کنید. درباره به‌روزرسانی هدف‌گیری مخاطب در راهنمای مخاطبان هدف ما بخوانید.
محدودیت های سهمیه API موجود
30 مه 2023
در 30 می 2023، محدودیت‌های استفاده موجود با ساختار سهمیه ترکیبی جایگزین می‌شود که موارد زیر را انجام می‌دهد:
حذف درخواست ها در روز به ازای هر سهمیه پروژه.
یک درخواست در دقیقه برای هر تبلیغ کننده در هر سهمیه پروژه برای روش های واجد شرایط ایجاد می کند.
این محدودیت‌های جدید به انعطاف‌پذیری بیشتری در استفاده از API اجازه می‌دهد و موازی‌سازی درخواست‌ها را در بین تبلیغ‌کنندگان ممکن می‌سازد. جزئیات این تغییر در اسناد محدودیت سهمیه موجود ما موجود است.
OR استفاده از اپراتور بین محدودیت های فیلدهای مختلف در فیلترهای LIST
21 ژوئن 2023
در 21 ژوئن 2023، پارامترهای filter درخواست LIST دیگر اجازه استفاده از عملگرهای منطقی OR را بین محدودیت های فیلدهای مختلف نمی دهد.
برای مثال، منابع شناسایی شده با رشته فیلتر lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" باید با استفاده از دو درخواست LIST با رشته های فیلتر زیر بازیابی شوند:
پارامترهای جستجوی filter همه تماس‌های LIST موجود خود را بررسی کنید و بررسی کنید که آنها قبل از 21 ژوئن 2023 از عملگر منطقی OR به درستی استفاده می‌کنند تا از وقفه در سرویس جلوگیری شود.
تمام منطق فیلتر را با استفاده از این چهار قسمت قبل از 21 ژوئن 2023 حذف کنید تا از وقفه در سرویس جلوگیری شود.
خرید مبتنی بر نتیجه
1 آگوست 2023
در 1 اوت 2023، سفارش‌های درج با استفاده از خرید مبتنی بر نتیجه، که با مقدار فیلد billableOutcomeBILLABLE_OUTCOME_PAY_PER_CLICK یا BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION تعریف شده‌اند، و موارد خط فرزند آنها بایگانی می‌شوند.
این تغییر بر درخواست‌های زیر تأثیر می‌گذارد:
تلاش برای استفاده از advertisers.insertionOrders.create برای ایجاد یک سفارش درج با استفاده از خرید مبتنی بر نتیجه، خطای 400 را برمی‌گرداند.
گزینه های هدف گذاری غروب به طور خودکار از هدف گذاری مورد خط موجود حذف می شود. این مقادیر همچنان برای استفاده در هدف گذاری در سطح تبلیغ کننده در دسترس خواهند بود.
برای جلوگیری از هرگونه وقفه در سرویس، قبل از غروب آفتاب، این هدف‌گیری را از همه موارد خط YouTube & Partners موجود حذف کنید.
مخاطبان شخص اول و شخص ثالث اوراکل
30 سپتامبر 2024
در 30 سپتامبر 2024، منابع FirstAndThirdPartyAudience از Oracle غروب خواهند کرد. به محض غروب آفتاب، این مخاطبان از هر منبع هدف موجود و مخاطب ترکیبی حذف خواهند شد. اگر یک مورد خطی فقط مخاطبان غروب خورشید را هدف قرار دهد یا مخاطبان غروب خورشید را هدف قرار دهد، این به‌روزرسانی به‌طور خودکار آن مورد خط را متوقف می‌کند.
برای جلوگیری از هرگونه وقفه در سرویس، قبل از غروب آفتاب، مخاطبان Oracle را از مخاطبان مورد خط موجود و مخاطبان ترکیبی شناسایی و حذف کنید.
هدف گذاری بهینه سازی شده برای زیرمجموعه ای از استراتژی های پیشنهادی
برای جلوگیری از هرگونه وقفه در سرویس، به‌روزرسانی و بررسی کنید که موارد خط شما با استفاده از این استراتژی‌های پیشنهادی، هدف‌یابی بهینه را روشن نکرده باشند.
در تاریخ 5 نوامبر 2024، PACING_TYPE_ASAP دیگر با PACING_PERIOD_FLIGHT هنگام تنظیم فیلد pacing ترتیب درج سازگار نخواهد بود. pacingType برای همه سفارش‌های درج موجود با این پیکربندی به PACING_TYPE_AHEAD به‌روزرسانی می‌شود.
برای جلوگیری از هرگونه وقفه در سرویس، pacing هر گونه سفارش درج موجود را با استفاده از PACING_TYPE_ASAP و PACING_PERIOD_FLIGHT به‌روزرسانی کنید.
تاریخ آخرین به‌روزرسانی 2024-10-30 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2024-10-30 بهوقت ساعت هماهنگ جهانی."],[[["This page provides a schedule of deprecation and sunset dates for Display & Video 360 API versions and features."],["Display & Video 360 API versions are regularly released, deprecated, and eventually sunset; users should migrate to newer versions before the sunset date to avoid service disruptions."],["The page includes tables outlining version and feature deprecations, with details on timelines, descriptions, and recommended actions for each."],["Users should regularly consult this page and the Google Ads developer blog for announcements and updates to stay informed about upcoming changes and ensure a smooth transition."]]],[]]
