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

جدول زمانی:

• 17 مه 2023: موارد خطی که از محرک‌های دستی استفاده می‌کنند در Display & Video 360 متوقف می‌شوند. اگر پس از این تاریخ یک راه‌انداز دستی مرتبط با یک مورد خط فعال را فعال کنید، مورد خط تبلیغاتی را نمایش نمی‌دهد.
• 1 آگوست 2023: سرویس advertisers.manualTriggers در DV360 API نسخه 1 و نسخه 2، مقدار فهرست LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER در DV360 API v1، و قسمت LineItemFlight.triggerId در DV360 API v1 غروب خواهد کرد. پس از این تاریخ، درخواست‌هایی که به این سرویس‌ها یا این فیلدها ارسال می‌شود، با خطا مواجه می‌شوند.

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

• فوراً استفاده از محرک‌های دستی را برای شروع و توقف سرویس اقلام خط متوقف کنید.
• درخواست به سرویس advertisers.manualTriggers را متوقف کنید.
• فیلدهای flight.flightDateType و flight.triggerId را برای همه موارد خط با استفاده از محرک‌های دستی به‌روزرسانی کنید.

جدول زمانی:

• 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 را با AudienceType ACTIVITY_BASED یا FREQUENCY_CAP به هدف‌یابی مخاطب خطی یا سفارش درج اختصاص دهید. درخواست‌هایی که این مخاطبان را به هدف‌یابی مخاطب خطی اختصاص می‌دهند، با خطا مواجه می‌شوند. این شامل درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault می‌شود، در صورتی که مورد خط ایجاد شده شامل مخاطبان منسوخ شده در هدف‌گیری مخاطبانش باشد.
• 8 ژوئن 2023: مخاطبان تحت تأثیر از همه هدف‌گذاری مورد خط و سفارش درج و از همه مخاطبان ترکیبی حذف خواهند شد. اگر زمانی که این مخاطبان حذف می‌شوند، یک مورد خطی نتواند تبلیغات را ارائه دهد، موقتاً متوقف می‌شود. در این تاریخ، این مخاطبان نیز دیگر با استفاده از سرویس firstAndThirdPartyAudiences قابل بازیابی نخواهند بود.

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

• توصیه می‌کنیم هنگام به‌روزرسانی‌های آینده برای هدف‌یابی مورد خط خود، فوراً استفاده از مخاطبان تحت تأثیر را متوقف کنید.
• همه مخاطبان تحت تأثیر را از هدف گذاری مورد خط موجود و سفارش درج حذف کنید. درباره به‌روزرسانی هدف‌گیری مخاطب در راهنمای مخاطبان هدف ما بخوانید.

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

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

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

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

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

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

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

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

تاریخ شروع اولیه به روز شد

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

قبل از 21 ژوئن 2023 تمام منطق فیلتر و سفارش را با استفاده از این دو فیلد حذف کنید تا از وقفه در سرویس جلوگیری کنید.

در 21 ژوئن 2023، advertisers.lineItems.list دیگر از فیلتر کردن با فیلدهای زیر پشتیبانی نخواهد کرد:

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

تمام منطق فیلتر را با استفاده از این چهار قسمت قبل از 21 ژوئن 2023 حذف کنید تا از وقفه در سرویس جلوگیری شود.

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

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

• تلاش برای استفاده از advertisers.insertionOrders.create برای ایجاد یک سفارش درج با استفاده از خرید مبتنی بر نتیجه، خطای 400 را برمی‌گرداند.
• تلاش برای استفاده advertisers.lineItems.create ، advertisers.lineItems.duplicate ، یا advertisers.lineItems.generateDefault برای ایجاد یک مورد خطی تحت سفارش درج با استفاده از خرید مبتنی بر نتیجه، خطای 400 را برمی‌گرداند.
• با توجه به اینکه منابع بایگانی شده به طور پیش‌فرض در درخواست‌های LIST گنجانده نمی‌شوند، منابع تحت تأثیر دیگر به‌طور پیش‌فرض توسط روش‌های advertisers.insertionOrders.list و advertisers.lineItems.list برگردانده نمی‌شوند.

از 26 ژوئن 2024، قسمت publisherReviewStatuses غروب می‌کند و هنگام بازیابی منابع Creative خالی می‌شود.

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

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION :
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION :
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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

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

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

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

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

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

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

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

در 28 فوریه 2025:

• درخواست ایجاد یا به‌روزرسانی منابع LineItem ، InsertionOrder ، و Campaign برای استفاده از یک شی FrequencyCap با یک فیلد timeUnit روی TIME_UNIT_LIFETIME یا یک قسمت timeUnit تنظیم شده روی TIME_UNIT_MONTH و یک فیلد timeUnitCount تنظیم شده روی 2، خطای 400 را برمی‌گرداند.
• ورودی‌های مورد خط ، ترتیب درج ، و فایل‌های داده ساختاریافته کمپین با مقدار ستون «دوره فراوانی» «طول عمر» یا «دوره فراوانی» ستون «ماه‌ها» و مقدار ستون «مقدار فراوان» «2» ایجاد یا به‌روزرسانی نمی‌شوند.
• کمپین‌های موجود، سفارش‌های درج، و موارد خط برای استفاده از دوره محدودیت فرکانس 30 روز یا کمتر به‌روزرسانی می‌شوند.

برای جلوگیری از هرگونه وقفه در خدمات:

• منابع کمپین موجود، ترتیب درج و موارد خطی را که از دوره محدودیت فرکانس بیش از 30 روز استفاده می کنند تا 30 روز یا کمتر باشد، به روز کنید.
• هنگام ایجاد یا به‌روزرسانی منابع کمپین، سفارش درج یا آیتم‌های خطی با استفاده از Display & Video 360 API یا فایل‌های داده ساختاریافته، بررسی کنید که ادغام شما یک دوره محدودیت فرکانس بیش از 30 روز تنظیم نمی‌کند.

در 6 مارس 2025:

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

برای جلوگیری از هرگونه وقفه در خدمات:

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

در 6 مارس 2025، اندازه صفحه پیش‌فرض برای درخواست‌های firstAndThirdPartyAudiences.list از 100 به 5000 به‌روزرسانی می‌شود.

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

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

در 1 آوریل 2025:

• advertisers.lineItems.create درخواست هایی برای تنظیم فیلد floodlightActivityConfigs شی ConversionCountingConfig و فیلد customBiddingAlgorithmId اشیاء MaximizeSpendBidStrategy یا PerformanceGoalBidStrategy که از فعالیت های floodlight منطبق استفاده نمی کنند، 400 خطا برمی گردند.
• درخواست‌های advertisers.lineItems.patch در تلاش برای به‌روزرسانی فیلد floodlightActivityConfigs شی ConversionCountingConfig در حالی که فیلد customBiddingAlgorithmId اشیاء MaximizeSpendBidStrategy یا PerformanceGoalBidStrategy تنظیم شده است، یک خطای 400 برمی‌گرداند.
• ورودی‌هایی در فایل‌های داده ساختاریافته آیتم‌های خطی که تلاش می‌کنند ستون «شناسه‌های فعالیت نورافکن تبدیل» را با تنظیم ستون «شناسه الگوریتم» به‌روزرسانی کنند، در آپلود فایل به‌روزرسانی نمی‌شوند.
• customBiddingAlgorithms.patch , customBiddingAlgorithms.rules.create , customBiddingAlgorithms.scripts.create درخواست هایی برای منابع CustomBiddingAlgorithm که به یک آیتم خطی اختصاص داده می شود، یک خطا برمی گرداند.

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

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

در 7 آوریل 2025، منابع FirstAndThirdPartyAudience دیگر به مدت زمان عضویت مخاطبان بی نهایت اجازه نمی دهند. درخواست‌های firstAndThirdPartyAudiences.create و firstAndThirdPartyAudiences.patch با تنظیم مقدار فیلد membershipDurationDays روی 10000، خطای 400 را برمی‌گرداند. مخاطبان موجود با مقدار فیلد membershipDurationDays DurationDays 10000 به 540 به‌روزرسانی می‌شوند و مدت عضویت جدید به‌عنوان ماسبق به عضویت‌های موجود اعمال می‌شود. این همه عضویت های قدیمی تر از 540 روز منقضی می شود.

برای جلوگیری از هرگونه وقفه در خدمات:

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

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