انحرافات اعلام شده

این صفحه فهرستی از تاریخ‌های منسوخ شدن و پایان اعتبار نسخه‌های API و ویژگی‌های منحصر به فرد در Display & Video 360 API را ارائه می‌دهد.

تاریخ‌های انقضا و پایان پشتیبانی از API نیز در وبلاگ توسعه‌دهندگان گوگل ادز اعلام خواهد شد.

منسوخ شدن نسخه‌ها

نسخه‌های رابط برنامه‌نویسی کاربردی Display & Video 360 به طور منظم منتشر، منسوخ و از رده خارج می‌شوند. این مراحل به شرح زیر تعریف می‌شوند:

  • انتشار : نسخه از هرگونه وضعیت آلفا یا بتا خارج شده و پایدار در نظر گرفته می‌شود. ممکن است ویژگی‌های اضافی همچنان برای این نسخه منتشر شوند.
  • منسوخ شدن : این نسخه در حال منسوخ شدن است و تاریخ پایان پشتیبانی (غروب آفتاب) اعلام شده است. کاربران باید قبل از تاریخ غروب آفتاب به نسخه جدیدتری مهاجرت کنند. دیگر هیچ ویژگی جدیدی برای این نسخه منتشر نخواهد شد.
  • غروب آفتاب : این نسخه دیگر پشتیبانی نمی‌شود. درخواست‌های ارسالی به این نسخه خطا می‌دهند.

این جدول تمام نسخه‌های اصلی موجود رابط برنامه‌نویسی کاربردی Display & Video 360، تاریخ انتشار آنها و تاریخ انقضا و پایان عمر آنها را، در صورت اعلام، فهرست می‌کند.

نسخه API تاریخ انتشار تاریخ انقضا تاریخ غروب آفتاب راهنمای مهاجرت
نسخه ۴ ۲۷ مارس ۲۰۲۵
نسخه ۳ ۳۱ اکتبر ۲۰۲۳ ۲ آوریل ۲۰۲۵ ۷ اکتبر ۲۰۲۵ مهاجرت از نسخه ۳ به نسخه ۴
نسخه ۲ ۶ دسامبر ۲۰۲۲ ۱۵ فوریه ۲۰۲۴ ۳ سپتامبر ۲۰۲۴ مهاجرت از نسخه ۲ به نسخه ۳
نسخه ۱ ۹ مارس ۲۰۲۰ ۱۳ مارس ۲۰۲۳ ۱۴ سپتامبر ۲۰۲۳ مهاجرت از نسخه ۱ به نسخه ۲

منسوخ شدن ویژگی‌ها

برای اطلاع از اطلاعیه‌های مربوط به حذف ویژگی‌های مهم آینده ، وبلاگ توسعه‌دهندگان گوگل ادز ما را دنبال کنید.

جدول زیر تمام ویژگی‌های منسوخ‌شده‌ی اعلام‌شده را فهرست می‌کند، به همراه تاریخ اولیه‌ی مؤثر و شرح منسوخ‌شدن به همراه اقدامات پیشنهادی و لینک به مستندات مربوطه:

ویژگی تاریخ شروع به کار توضیحات
گسترش هدف‌گیری ۲۵ مارس ۲۰۲۳ جایگزینی ویژگی گسترش هدف‌گیری با هدف‌گیری بهینه ، به تدریج از ۲۵ مارس ۲۰۲۳ تا اوایل مه ۲۰۲۳ ارائه شد. تغییرات مرتبط با Display & Video 360 API و رفتار Structured Data Files و همچنین اقدامات پیشنهادی در یک پست وبلاگ اعلام شد.
محرک‌های دستی ۱۷ مه ۲۰۲۳

جدول زمانی:

  • ۱۷ مه ۲۰۲۳: نمایش آیتم‌های خطی که از تریگرهای دستی استفاده می‌کنند در Display & Video 360 متوقف خواهد شد. اگر پس از این تاریخ تریگر دستی مرتبط با یک آیتم خطی فعال را فعال کنید، آن آیتم خطی تبلیغات نمایش نخواهد داد.
  • ۱ آگوست ۲۰۲۳: سرویس advertisers.manualTriggers در DV360 API نسخه ۱ و ۲، مقدار enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER در DV360 API نسخه ۱ و فیلد LineItemFlight.triggerId در DV360 API نسخه ۱ غیرفعال خواهند شد. پس از این تاریخ، درخواست‌های ارسالی به این سرویس‌ها یا این فیلدها با خطا مواجه خواهند شد.

اقدامات توصیه شده:

  • فوراً استفاده از محرک‌های دستی برای شروع و توقف ارائه اقلام خطی را متوقف کنید.
  • ارسال درخواست به سرویس advertisers.manualTriggers را متوقف کنید.
  • فیلدهای flight.flightDateType و flight.triggerId را برای همه آیتم‌های خط با استفاده از triggerهای دستی به‌روزرسانی کنید.
انواع برنامه‌های نصب‌شده و دستگاه‌های تلفن همراه جدید GoogleAudience ۲۰ مه ۲۰۲۳

جدول زمانی:

  • ۲۰ مه ۲۰۲۳: دیگر نمی‌توانید منابع GoogleAudience با نوع GoogleAudienceType برابر با GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS یا GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES را به هدف‌گیری مخاطب در سطر یا ترتیب درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌گیری مخاطب در یک سطر اختصاص می‌دهند، خطا برمی‌گردانند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، اگر سطر ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطب خود باشد.
  • ۸ ژوئن ۲۰۲۳: مخاطبان تحت تأثیر از تمام ردیف‌های هدف‌گیری و ترتیب درج و از تمام مخاطبان ترکیبی حذف خواهند شد. اگر یک ردیف در هنگام حذف این مخاطبان قادر به نمایش تبلیغات نباشد، نمایش آنها متوقف خواهد شد. در این تاریخ، این مخاطبان نیز دیگر با استفاده از سرویس googleAudiences قابل بازیابی نخواهند بود.

وظایف پیشنهادی:

  • توصیه می‌کنیم هنگام به‌روزرسانی‌های بعدی در هدف‌گذاری اقلام خطی خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید.
  • تمام مخاطبان تحت تأثیر را از ردیف‌های موجود و هدف‌گذاری ترتیب درج حذف کنید. در مورد به‌روزرسانی هدف‌گذاری مخاطبان، در راهنمای مخاطبان هدف ما بخوانید.
انواع مخاطبان FirstAndThirdPartyAudience بر اساس فعالیت و سقف تکرار ۲۰ مه ۲۰۲۳

جدول زمانی:

  • ۲۰ مه ۲۰۲۳: دیگر نمی‌توانید منابع FirstAndThirdPartyAudience با AudienceType برابر با ACTIVITY_BASED یا FREQUENCY_CAP را به هدف‌گیری مخاطب در سطر یا ترتیب درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌گیری مخاطب در یک سطر اختصاص می‌دهند، خطا برمی‌گردانند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، اگر سطر ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطب خود باشد.
  • ۸ ژوئن ۲۰۲۳: مخاطبان تحت تأثیر از تمام ردیف‌های هدف‌گیری و ترتیب درج و از تمام مخاطبان ترکیبی حذف خواهند شد. اگر یک ردیف در هنگام حذف این مخاطبان قادر به نمایش تبلیغات نباشد، تبلیغات متوقف می‌شوند. در این تاریخ، این مخاطبان دیگر با استفاده از سرویس firstAndThirdPartyAudiences قابل بازیابی نخواهند بود.

وظایف پیشنهادی:

  • توصیه می‌کنیم هنگام به‌روزرسانی‌های بعدی در هدف‌گذاری اقلام خطی خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید.
  • تمام مخاطبان تحت تأثیر را از ردیف‌های موجود و هدف‌گذاری ترتیب درج حذف کنید. در مورد به‌روزرسانی هدف‌گذاری مخاطبان، در راهنمای مخاطبان هدف ما بخوانید.
محدودیت‌های سهمیه API موجود ۳۰ مه ۲۰۲۳

در تاریخ 30 مه 2023، محدودیت‌های استفاده موجود با یک ساختار سهمیه‌بندی ترکیبی جایگزین خواهد شد که موارد زیر را انجام می‌دهد:

  1. درخواست‌های روزانه به ازای هر سهمیه پروژه را حذف می‌کند.
  2. برای روش‌های واجد شرایط، به ازای هر تبلیغ‌کننده در هر پروژه، درخواست‌هایی را در هر دقیقه تعیین می‌کند.

این محدودیت‌های جدید، انعطاف‌پذیری بیشتری در استفاده از API ایجاد کرده و امکان موازی‌سازی درخواست‌ها را در بین تبلیغ‌کنندگان فراهم می‌کند. جزئیات این تغییر در مستندات محدودیت سهمیه موجود ما موجود است.

استفاده از عملگر OR بین محدودیت‌های فیلدهای مختلف در فیلترهای LIST

۲۱ ژوئن ۲۰۲۳

در ۲۱ ژوئن ۲۰۲۳، پارامترهای filter درخواست LIST دیگر اجازه استفاده از عملگرهای منطقی OR را بین محدودیت‌های فیلدهای مختلف نخواهند داد.

برای مثال، منابعی که با رشته فیلتر lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" شناسایی شده‌اند، باید با استفاده از دو درخواست LIST با رشته‌های فیلتر زیر بازیابی شوند:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

برای جزئیات بیشتر در مورد محدودیت‌های عملگرهای منطقی، به راهنمای ما در مورد فیلتر کردن درخواست‌های LIST مراجعه کنید.

پارامترهای پرس و جوی filter تمام فراخوانی‌های LIST موجود خود را بررسی کنید و تأیید کنید که آنها قبل از ۲۱ ژوئن ۲۰۲۳ به درستی از عملگر منطقی OR استفاده می‌کنند تا از وقفه در سرویس جلوگیری شود.

امکان فیلتر کردن یا مرتب‌سازی درخواست‌های لیست بر اساس فیلدهای budget.budget_segments. date_range.end_date و flight.dateRange.endDate

تاریخ اولیه اجرا به‌روزرسانی شد

۲۱ ژوئن ۲۰۲۳

در تاریخ ۲۱ ژوئن ۲۰۲۳، فیلدهای budget.budget_segments. date_range.end_date و flight.dateRange.endDate دیگر به ترتیب در پارامترهای filter و query orderBy advertisers.insertionOrders.list و advertisers.lineItems.list پذیرفته نخواهند شد. پس از این تاریخ، درخواست‌هایی که از این فیلدها در پارامترهای query مربوط به filter و orderBy استفاده می‌کنند، خطا برمی‌گردانند.

برای جلوگیری از وقفه در سرویس، قبل از ۲۱ ژوئن ۲۰۲۳، تمام منطق فیلتر و سفارش را با استفاده از این دو فیلد حذف کنید.

امکان فیلتر کردن درخواست‌های advertisers.lineItems.list بر اساس چهار فیلد اضافی ۲۱ ژوئن ۲۰۲۳

در ۲۱ ژوئن ۲۰۲۳، advertisers.lineItems.list دیگر از فیلتر کردن بر اساس فیلدهای زیر پشتیبانی نخواهد کرد:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

برای جلوگیری از وقفه در سرویس، تمام منطق فیلتر را با استفاده از این چهار فیلد قبل از ۲۱ ژوئن ۲۰۲۳ حذف کنید.

خرید مبتنی بر نتیجه ۱ آگوست ۲۰۲۳

در تاریخ ۱ آگوست ۲۰۲۳، سفارش‌های درج با استفاده از خرید مبتنی بر نتیجه، که توسط مقدار فیلد billableOutcome با شناسه‌های BILLABLE_OUTCOME_PAY_PER_CLICK یا BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION تعریف شده‌اند، و اقلام ردیف فرزند آنها بایگانی خواهند شد.

این تغییر بر درخواست‌های زیر تأثیر خواهد گذاشت:

فیلد publisherReviewStatuses در منابع خلاق ۲۶ ژوئن ۲۰۲۴

از تاریخ ۲۶ ژوئن ۲۰۲۴، فیلد publisherReviewStatuses از بین می‌رود و هنگام بازیابی منابع Creative خالی خواهد بود.

هدف‌گذاری محتوا برای موارد خطی یوتیوب و شرکا ۳۰ سپتامبر ۲۰۲۴

در تاریخ 30 سپتامبر 2024، مقادیر زیر برای انواع هدف‌گذاری شناسایی‌شده برای موارد مربوط به یوتیوب و شرکا از بین خواهند رفت:

گزینه‌های هدف‌گیری غروب آفتاب به‌طور خودکار از هدف‌گیری آیتم‌های خطی موجود حذف می‌شوند. این مقادیر همچنان برای استفاده در هدف‌گیری سطح تبلیغ‌کننده در دسترس خواهند بود.

برای جلوگیری از هرگونه وقفه در سرویس، این هدف‌گیری را قبل از تاریخ انقضا از هرگونه آیتم موجود در خط YouTube & Partners حذف کنید.

مخاطبان شخص ثالث و اول شخص اوراکل ۳۰ سپتامبر ۲۰۲۴

در تاریخ 30 سپتامبر 2024، منابع FirstAndThirdPartyAudience از Oracle غیرفعال خواهند شد. پس از غیرفعال شدن، این مخاطبان از هرگونه هدف‌گیری منابع موجود و مخاطبان ترکیبی حذف می‌شوند. اگر یک مورد خطی یا فقط مخاطبان غیرفعال را هدف قرار دهد یا به طور منفی هر مخاطب غیرفعال را هدف قرار دهد، این به‌روزرسانی به طور خودکار آن مورد خطی را متوقف می‌کند.

برای جلوگیری از هرگونه وقفه در سرویس، قبل از تاریخ انقضا، مخاطبان اوراکل را از لیست مخاطبان هدف موجود و مخاطبان ترکیبی شناسایی و حذف کنید.

هدف‌گذاری بهینه‌شده برای هر ردیف کالا برای زیرمجموعه‌ای از استراتژی‌های پیشنهاد قیمت ۳۰ سپتامبر ۲۰۲۴

در تاریخ 30 سپتامبر 2024، منابع LineItem که از زیرمجموعه‌ای از استراتژی‌های پیشنهاد قیمت استفاده می‌کنند، دیگر با هدف‌گیری بهینه سازگار نخواهند بود. با این تغییر، منابع LineItem که targetingExpansion.enableOptimizedTargeting روی True تنظیم شده و bidStrategy.maximizeSpendAutoBid.performanceGoalType روی BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA ، BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN ، یا BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED یا bidStrategy.performanceGoalAutoBid.performanceGoalType روی BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM تنظیم شده‌اند، به‌روزرسانی می‌شوند تا targetingExpansion.enableOptimizedTargeting روی False تنظیم شود.

برای جلوگیری از هرگونه وقفه در سرویس، موارد خطی خود را که از این استراتژی‌های پیشنهاد قیمت استفاده می‌کنند، به‌روزرسانی و تأیید کنید که هدف‌گیری بهینه فعال نشده باشد.

پرواز در اسرع Pacing برای ثبت سفارش‌های الحاقی ۵ نوامبر ۲۰۲۴

در تاریخ ۵ نوامبر ۲۰۲۴، هنگام تنظیم فیلد pacing ترتیب درج، PACING_TYPE_ASAP دیگر با PACING_PERIOD_FLIGHT سازگار نخواهد بود. pacingType برای همه ترتیب‌های درج موجود با این پیکربندی به PACING_TYPE_AHEAD به‌روزرسانی می‌شود.

برای جلوگیری از هرگونه وقفه در سرویس، pacing هر دستور درج موجود را با استفاده از PACING_TYPE_ASAP و PACING_PERIOD_FLIGHT به‌روزرسانی کنید.

دوره محدودیت فرکانس بیش از 30 روز ۲۸ فوریه ۲۰۲۵

در ۲۸ فوریه ۲۰۲۵:

  • درخواست‌های ایجاد یا به‌روزرسانی منابع LineItem ، InsertionOrder و Campaign برای استفاده از یک شیء FrequencyCap با فیلد timeUnit تنظیم‌شده روی TIME_UNIT_LIFETIME یا فیلد timeUnit تنظیم‌شده روی TIME_UNIT_MONTH و فیلد timeUnitCount تنظیم‌شده روی ۲، خطای 400 را برمی‌گردانند.
  • ورودی‌های موجود در بخش‌های Line Item ، Insertion Order و Campaign Structured Data Files که مقدار ستون "دوره تناوب" آنها "Lifetime" یا مقدار ستون "دوره تناوب" آنها "Months" و مقدار ستون "مقدار تناوب" آنها "2" باشد، در هنگام آپلود فایل ایجاد یا به‌روزرسانی نخواهند شد.
  • کمپین‌های موجود، سفارش‌های درج و ردیف‌های فروش به‌روزرسانی خواهند شد تا از دوره تناوب ۳۰ روزه یا کمتر استفاده کنند.

برای جلوگیری از هرگونه وقفه در سرویس:

  • منابع کمپین، ترتیب درج و ردیف‌های موجود که از دوره محدودیت تکرار بیش از ۳۰ روز استفاده می‌کنند را به ۳۰ روز یا کمتر به‌روزرسانی کنید.
  • هنگام ایجاد یا به‌روزرسانی منابع کمپین، ترتیب درج یا ردیف آیتم‌ها با استفاده از Display & Video 360 API یا Structured Data Files، تأیید کنید که ادغام شما، دوره زمانی بیش از 30 روز را برای حداکثر تکرار تنظیم نمی‌کند.
هدف‌گذاری بهینه برای اقلام خطی با استفاده از پیشنهاد قیمت ثابت ۶ مارس ۲۰۲۵

در ۶ مارس ۲۰۲۵:

  • درخواست‌های ایجاد یا به‌روزرسانی منابع LineItem برای تنظیم فیلد BiddingStrategy fixedBid و فیلد TargetingExpansionConfig به true enableOptimizedTargeting خطای 400 را برمی‌گردانند.
  • ورودی‌های موجود در فایل‌های داده ساختاریافته‌ی ردیفی که مقدار ستون «نوع استراتژی پیشنهاد قیمت» آنها «ثابت» و مقدار ستون «هدف‌گذاری بهینه‌شده» آنها «درست» باشد، در هنگام آپلود فایل ایجاد یا به‌روزرسانی نمی‌شوند.
  • ردیف‌های موجود که از قیمت‌گذاری ثابت استفاده می‌کنند، به‌روزرسانی می‌شوند تا هدف‌گذاری بهینه‌شده غیرفعال شود.

برای جلوگیری از هرگونه وقفه در سرویس:

  • منابع موجود برای اقلام خطی که از هر دو روش قیمت‌گذاری ثابت و هدف‌گذاری بهینه استفاده می‌کنند را به‌روزرسانی کنید.
  • هنگام ایجاد یا به‌روزرسانی منابع اقلام خطی با استفاده از Display & Video 360 API یا Structured Data Files، تأیید کنید که ادغام شما شامل تعیین یک استراتژی قیمت‌گذاری ثابت و هدف‌گذاری بهینه نباشد.
به‌روزرسانی به اندازه پیش‌فرض صفحه firstAndThirdPartyAudiences.list ۶ مارس ۲۰۲۵

در تاریخ ۶ مارس ۲۰۲۵، اندازه پیش‌فرض صفحه برای درخواست‌های firstAndThirdPartyAudiences.list از ۱۰۰ به ۵۰۰۰ به‌روزرسانی خواهد شد.

برای جلوگیری از وقفه در سرویس، ادغام خود را به‌روزرسانی کنید تا پارامتر پرس‌وجوی pageSize مربوط به درخواست‌های firstAndThirdPartyAudiences.list خود را روی اندازه صفحه دلخواه خود تنظیم کنید.

خطای عدم تطابق جدید sdfdownloadtasks.create partner/advertiser ۶ مارس ۲۰۲۵

در تاریخ ۶ مارس ۲۰۲۵، درخواست‌های sdfdownloadtasks.create که از یک فیلتر موجودیت والد برای فیلتر کردن بر اساس تبلیغ‌کنندگانی که فرزند مجموعه partnerId نیستند استفاده می‌کنند، شروع به بازگرداندن خطای 400 خواهند کرد.

محدودیت‌های دسترسی به اقلام در یوتیوب در SDF ۲۴ مارس ۲۰۲۵

در ۲۴ مارس ۲۰۲۵، فایل‌های داده ساختاریافته (Structured Data Files) هنگام ایجاد یا به‌روزرسانی موارد خطی، نیاز به استفاده از قالب‌های تبلیغاتی گسترده‌تری خواهند داشت. این به معنای موارد زیر است:

  • SDF نسخه‌های ۶ و ۷ دیگر از ایجاد ورودی‌های جدید فایل Line Item با مقدار Subtype "Reach" پشتیبانی نمی‌کنند.
  • ورودی‌های جدید در فایل‌های SDF Line Item با Subtype «Reach» باید از مقدار «Responsive» در ستون TrueView Video Ad Formats استفاده کنند. ورودی‌های موجود با Subtype «Reach» نمی‌توانند مقدار ستون TrueView Video Ad Formats خود را به‌روزرسانی کنند.
  • ورودی‌های جدید در فایل‌های SDF Line Item با مقدار Subtype "Reach" نیاز به جمعیت ستون TrueView Video Ad Inventory Control دارند.
الگوریتم مناقصه سفارشی و فعالیت‌های نورافکن نامتناسب ۱ آوریل ۲۰۲۵

در ۱ آوریل ۲۰۲۵:

برای جلوگیری از هرگونه وقفه در سرویس، ادغام خود را به موارد زیر به‌روزرسانی کنید:

  • تأیید کنید که فعالیت‌های مربوط به نورپردازی، قبل یا همزمان با اختصاص الگوریتم مناقصه سفارشی، به یک آیتم خطی اختصاص داده شده‌اند.
  • الگوریتم‌های مناقصه سفارشی موجود، قبل از تلاش برای به‌روزرسانی، از تمام اقلام ردیف تخصیص داده نمی‌شوند.

مدت زمان عضویت نامحدود برای مخاطبان شخص اول ۷ آوریل ۲۰۲۵

در ۷ آوریل ۲۰۲۵، منابع FirstAndThirdPartyAudience دیگر اجازه مدت زمان عضویت نامحدود مخاطبان را نخواهند داد. درخواست‌های firstAndThirdPartyAudiences.create و firstAndThirdPartyAudiences.patch که مقدار فیلد membershipDurationDays را روی ۱۰۰۰۰ تنظیم می‌کنند، خطای 400 را برمی‌گردانند. مخاطبان فعلی که مقدار فیلد membershipDurationDays آنها ۱۰۰۰۰ است، به ۵۴۰ به‌روزرسانی می‌شوند و مدت زمان عضویت جدید به صورت عطف به ماسبق برای عضویت‌های موجود اعمال می‌شود. این کار باعث می‌شود تمام عضویت‌های قدیمی‌تر از ۵۴۰ روز منقضی شوند.

برای جلوگیری از هرگونه وقفه در سرویس:

  • تأیید کنید که ادغام شما مقدار فیلد membershipDurationDays مخاطبان جدید یا موجود را روی ۱۰۰۰۰ تنظیم نمی‌کند.
  • عضویت‌های مخاطبان Customer Match فعلی خود را با استفاده از firstAndThirdPartyAudiences.editCustomerMatchMembers به‌روزرسانی کنید.
  • مرتباً فهرست مخاطبان Customer Match خود را به‌روزرسانی کنید تا مطمئن شوید که اندازه فهرست مخاطبان شما ناخواسته کوچک‌تر نمی‌شود.

در نسخه ۴، این تغییر در منابع FirstPartyAndPartnerAudience منعکس شده است.

کمپین‌های اکشن ویدیویی در فایل‌های داده ساختاریافته ۲۲ آوریل ۲۰۲۵

در ۲۲ آوریل ۲۰۲۵، دیگر نمی‌توانید با استفاده از فایل‌های داده ساختاریافته (Structured Data Files)، آیتم‌های خطی (Line Items) برای کمپین‌های اکشن ویدیویی ایجاد کنید، زیرا این فایل‌ها به Demand Gen ارتقا می‌یابند. ورودی‌های آیتم خطی که سعی می‌کنند با مقدار ستون Subtype با "Action" و مقدار ستون Type برابر با "TrueView" آپلود شوند، با شکست مواجه خواهند شد.

برای جلوگیری از هرگونه وقفه در سرویس، ادغام خود را به‌روزرسانی کنید تا به جای کمپین‌های اکشن ویدیویی، از Demand Gen استفاده کنید.

برای اقلام خط تولید تقاضا در فایل‌های داده ساختاریافته، به منبع موجودی شریک ویدیویی نیاز است. ۲۲ آوریل ۲۰۲۵

از ۲۲ آوریل ۲۰۲۵، شما ملزم خواهید بود که مقدار «Video Partners» را در ستون TrueView Inventory Source Targeting برای ورودی‌های ردیف آیتم‌هایی که مقدار ستون Type آنها «Demand Gen» است، وارد کنید. پس از شروع این الزام، مقدار برای ردیف آیتم‌های موجود دوباره پر می‌شود و هنگام دانلود فایل‌های داده ساختاریافته جدید نیز لحاظ می‌گردد.

برای جلوگیری از هرگونه وقفه در سرویس:

  • ادغام خود را به‌روزرسانی کنید تا مقدار «شرکای ویدیویی» در تمام ورودی‌های ردیف Demand Gen لحاظ شود.
  • ادغام خود را برای مدیریت منابع موجودی Demand Gen در سطح گروه تبلیغاتی با استفاده از ستون‌های گروه تبلیغاتی SDF نسخه ۸.۱ با عنوان‌های Demand Gen Inventory Source Strategy و Demand Gen Enabled Inventory Sources به‌روزرسانی کنید.
ستون «ضرایب پیشنهاد قیمت» در فایل‌های داده ساختاریافته ردیف کالا ۱ مه ۲۰۲۵

در تاریخ ۱ مه ۲۰۲۵، ورودی‌های موجود در فایل‌های داده ساختاریافته‌ی اقلام خطی که سعی در تنظیم ستون «ضرایب پیشنهاد قیمت» دارند، در هنگام آپلود فایل، قادر به ایجاد یا به‌روزرسانی منبع نخواهند بود.

تنظیمات دسته‌بندی محتوا برای یوتیوب و شرکایش ۱۲ ژوئن ۲۰۲۵

در ۱۲ ژوئن ۲۰۲۵، به عنوان بخشی از به‌روزرسانی تجربه تناسب برند ، پیکربندی‌های دسته‌بندی محتوا برای آیتم‌های خطی یوتیوب و شرکا دیگر در سطح قابل تغییر نخواهند بود. در عوض، تنظیمات دسته‌بندی محتوا صرفاً در سطح تبلیغ‌کننده کنترل می‌شوند. برای تطبیق با این تغییر، تغییرات زیر در API نمایش و ویدیو ۳۶۰ و فایل‌های داده ساختاریافته اعمال خواهد شد:

  • فیلد contentCategory در اشیاء YoutubeAndPartnersSettings از منابع YouTube & partners LineItem دیگر به‌روزرسانی نخواهد شد. این فیلد در تاریخ بعدی به‌طور کامل حذف خواهد شد.
  • ستون TrueView Content Filter در SDFهای آیتم خطی دیگر قابل نوشتن نخواهد بود.
برای جلوگیری از هرگونه وقفه در سرویس:
  • هنگام بررسی موارد خطی YouTube & partners در API، فیلد effectiveContentCategory را به جای فیلد contentCategory بازیابی کنید.
  • هنگام به‌روزرسانی ورودی‌های سطر SDF ، تغییر ستون TrueView Content Filter را متوقف کنید. هنگام ایجاد سطرهای جدید، ستون را خالی نگه دارید.
به‌روزرسانی‌های بودجه ردیف‌های بودجه با بهینه‌سازی ترتیب درج ۱۲ ژوئن ۲۰۲۵

از ۱۲ ژوئن ۲۰۲۵، دیگر نمی‌توانید تنظیمات بودجه را برای ردیف‌هایی که سفارش‌های درج والد روی بهینه‌سازی با استفاده از استراتژی‌های پیشنهاد قیمت خودکار تنظیم شده‌اند، به‌روزرسانی کنید.

برای جلوگیری از هرگونه وقفه در سرویس:
  • در API: بررسی کنید که آیا InsertionOrder والد یک آیتم خطی، دارای bidStrategy.maximizeSpendAutoBid یا bidStrategy.performanceGoalAutoBid تنظیم شده است یا خیر. در این صورت، سعی نکنید فیلد بودجه LineItem را با استفاده از advertisers.lineItems.patch به‌روزرسانی کنید.
  • در SDF: بررسی کنید که آیا ستون Insertion Order Optimization ورودی SDF مربوط به ردیف آیتم، روی TRUE تنظیم شده است یا خیر. در این صورت، سعی نکنید ستون‌های Budget Type یا Budget Amount را برای ردیف آیتم SDF به‌روزرسانی کنید.
محدودیت‌های سایت برای فایل‌های داده ساختاریافته ۱۲ ژوئن ۲۰۲۵

از ۱۲ ژوئن ۲۰۲۵، محدودیت موجود برای URLهای هدف‌گذاری‌شده در ورودی‌های SDF که مانع از گنجاندن سایت‌های جدیدتر می‌شد را حذف خواهیم کرد. در عوض، SDF رفتار API و UI را مطابقت می‌دهد و امکان هدف‌گیری URLها را تا زمانی که به درستی قالب‌بندی شده باشند، فراهم می‌کند.

این مربوط به ستون‌های Site Targeting - Include و Site Targeting - Exclude در فایل‌های «ترتیب درج» و «مورد سطر» است.
اعلام کنید که آیا موارد خط به تبلیغات سیاسی اتحادیه اروپا خدمت می‌کنند یا خیر ۸ سپتامبر ۲۰۲۵

از ۸ سپتامبر ۲۰۲۵، هنگام ایجاد یک ردیف آگهی جدید با استفاده از Display & Video 360 API یا SDFها، لازم است اعلام کنید که آیا آن ردیف آگهی، تبلیغات سیاسی اتحادیه اروپا را نمایش می‌دهد یا خیر. این اعلان‌ها را می‌توان به روش‌های زیر انجام داد:

اگر تبلیغ‌کننده‌ی والد شما هیچ آیتم خطی که تبلیغات سیاسی اتحادیه‌ی اروپا را ارائه می‌دهد، نداشته باشد، می‌توانید با استفاده از فیلد containsEuPoliticalAds در منبع Display & Video 360 API Advertiser ، در سطح تبلیغ‌کننده اعلام کنید. اگر این فیلد روی DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING تنظیم شده باشد، به تمام آیتم‌های خطی جدید زیر تبلیغ‌کننده، در صورتی که مقدار دیگری مشخص نشده باشد، مقدار یکسانی اختصاص داده می‌شود و اگر مقداری از قبل تنظیم نشده باشد، تمام آیتم‌های خطی موجود زیر تبلیغ‌کننده برای استفاده از همان مقدار به‌روزرسانی می‌شوند. اعلان یک آیتم خطی را می‌توان در هر زمانی پس از ایجاد با استفاده از رابط کاربری، API یا SDF به‌روزرسانی کرد.

اگر نمی‌توانید در سطح تبلیغ‌کننده اعلام کنید یا اعلام کرده‌اید که تبلیغات سیاسی اتحادیه اروپا ممکن است تحت عنوان تبلیغ‌کننده شما ارائه شود، برای جلوگیری از وقفه در سرویس، API و ادغام Display & Video 360 خود را قبل از ۸ سپتامبر ۲۰۲۵ به‌روزرسانی کنید:

  • هنگام ایجاد درخواست advertisers.lineItems.create ، فیلد containsEuPoliticalAds را در یک منبع LineItem جدید تنظیم کنید.
  • فیلد containsEuPoliticalAds را در بدنه درخواست هر درخواست advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault تنظیم کنید.
  • به نسخه ۹ فایل‌های داده ساختاریافته مهاجرت کنید و ستون Contains EU Political Ads را برای هر آیتم خط جدید در هنگام آپلود روی Yes یا No تنظیم کنید. برای دستورالعمل‌های گام به گام، به راهنمای مهاجرت نسخه ۹ ما مراجعه کنید.
  • قبل از به‌روزرسانی هدف‌گذاری جغرافیایی برای یک آیتم خطی موجود با استفاده از Display & Video 360 API یا SDF، آیتم خطی را به‌روزرسانی کنید تا یک اعلان ارائه دهد.
مدیریت ترتیب درج و هدف‌گیری کمپین در Display & Video 360 API و فایل‌های داده ساختاریافته فوریه ۲۰۲۶

در فوریه ۲۰۲۶، Display & Video 360 ترتیب درج و هدف‌گیری کمپین را غیرفعال خواهد کرد. تغییراتی در API Display & Video 360 و فایل‌های داده ساختاریافته (SDF) ایجاد خواهد شد تا با این تغییر همسو شوند. در Display & Video 360 API، زیرمجموعه‌ای از متدها غیرفعال می‌شوند و در صورت فراخوانی خطا برمی‌گردانند. در SDF، ستون‌های هدف‌گیری در فایل‌های ترتیب درج و کمپین دیگر در هنگام دانلود پر نمی‌شوند و لازم است در هنگام آپلود خالی باشند. توصیه می‌شود کاربران هنگام ایجاد آیتم‌های خطی، هدف‌گیری را مستقیماً به آیتم‌های خطی اختصاص دهند.

متدهای Display & Video 360 API زیر در صورت فراخوانی، خطای 404 را برمی‌گردانند:

ورودی‌های SDF کمپین که مقادیری به ستون‌های زیر اختصاص داده باشند، در هنگام آپلود با شکست مواجه می‌شوند:

  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Environment Targeting

ورودی‌های SDF مربوط به ترتیب درج که مقادیری به ستون‌های زیر اختصاص داده باشند، در هنگام آپلود با شکست مواجه می‌شوند:

  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Device Targeting - Include
  • Device Targeting - Exclude
  • Browser Targeting - Include
  • Browser Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Channel Targeting - Include
  • Channel Targeting - Exclude
  • Site Targeting - Include
  • Site Targeting - Exclude
  • App Targeting - Include
  • App Targeting - Exclude
  • App Collection Targeting - Include
  • App Collection Targeting - Exclude
  • Category Targeting - Include
  • Category Targeting - Exclude
  • Content Genre Targeting - Include
  • Content Genre Targeting - Exclude
  • Keyword Targeting - Include
  • Keyword Targeting - Exclude
  • Keyword List Targeting - Exclude
  • Audience Targeting - Include
  • Audience Targeting - Exclude
  • Affinity & In Market Targeting - Include
  • Affinity & In Market Targeting - Exclude
  • Custom List Targeting
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Daypart Targeting
  • Daypart Targeting Time Zone
  • Environment Targeting
  • Viewability Omid Targeting Enabled
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Position Targeting - Audio Position In Content
  • Video Player Size Targeting
  • Content Duration Targeting
  • Content Stream Type Targeting
  • Audio Content Type Targeting
  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Connection Speed Targeting
  • Carrier Targeting - Include
  • Carrier Targeting - Exclude

این مطلب متعاقباً با ذکر تاریخ دقیق به‌روزرسانی خواهد شد.