رابط برنامهنویسی کاربردی Display & Video 360 اکنون از مدیریت منابع Demand Gen پشتیبانی میکند. برای یادگیری نحوه ساخت و اجرای یک کمپین تبلیغاتی Demand Gen، به راهنمای جدید ما مراجعه کنید.
نسخههای رابط برنامهنویسی کاربردی Display & Video 360 به طور منظم منتشر، منسوخ و از رده خارج میشوند. این مراحل به شرح زیر تعریف میشوند:
انتشار : نسخه از هرگونه وضعیت آلفا یا بتا خارج شده و پایدار در نظر گرفته میشود. ممکن است ویژگیهای اضافی همچنان برای این نسخه منتشر شوند.
منسوخ شدن : این نسخه در حال منسوخ شدن است و تاریخ پایان پشتیبانی (غروب آفتاب) اعلام شده است. کاربران باید قبل از تاریخ غروب آفتاب به نسخه جدیدتری مهاجرت کنند. دیگر هیچ ویژگی جدیدی برای این نسخه منتشر نخواهد شد.
غروب آفتاب : این نسخه دیگر پشتیبانی نمیشود. درخواستهای ارسالی به این نسخه خطا میدهند.
این جدول تمام نسخههای اصلی موجود رابط برنامهنویسی کاربردی Display & Video 360، تاریخ انتشار آنها و تاریخ انقضا و پایان عمر آنها را، در صورت اعلام، فهرست میکند.
این جدول تمام حذف ویژگیهای اعلامشده که بر نسخههای زنده تأثیر میگذارند را فهرست میکند و تاریخ اولیه اجرا و شرح حذف را با اقدامات پیشنهادی و پیوندهایی به مستندات مربوطه ارائه میدهد:
ویژگی
تاریخ شروع به کار
توضیحات
مقادیر نام و لوگوی تجاری مورد نیاز برای تبلیغات واکنشگرای یوتیوب
۱۲ اکتبر ۲۰۲۶
از ۱۲ اکتبر ۲۰۲۶، در صورتی که مقدار پیشفرضی برای تبلیغکننده تعیین نشده باشد، ارائه نام و لوگوی تجاری برای تبلیغات واکنشگرای یوتیوب الزامی خواهد بود.
در نتیجه، اگر مقادیر پیشفرض به تبلیغکنندهی والد اختصاص داده نشده باشد، ستونهای Logo Asset IDsBusiness Name و لوگو در Ad SDFها برای تبلیغاتی از نوع «واکنشگرا» باید تنظیم شوند. اگر مقدار پیشفرض اختصاص داده شود و ستون خالی بماند، تبلیغ هنگام ذخیره، پیشفرضهای سطح تبلیغکننده را به ارث میبرد.
منسوخ کردن حذف دستهبندی حساس
۱ اکتبر ۲۰۲۶
از اول اکتبر ۲۰۲۶، دیگر نمیتوانید هنگام تعیین هدفگذاری برای آیتمهای خطی، اکثر دستهبندیهای حساس را مستثنی کنید. برای تطبیق با این تغییر، تغییرات زیر در رابط برنامهنویسی کاربردی نمایش و ویدئو ۳۶۰ و فایلهای داده ساختاریافته اعمال خواهد شد:
ستون « Brand Safety Sensitivity Setting در SDFهای ردیف آیتم دیگر گزینه «استفاده سفارشی» را مجاز نخواهد کرد.
ستون Brand Safety Custom Settings در SDFهای آیتمهای خطی دیگر پشتیبانی نخواهد شد و هنگام دانلود با مقدار خالی پر میشود.
منسوخ کردن حذف برچسب محتوای دیجیتال
۱ اکتبر ۲۰۲۶
از اول اکتبر ۲۰۲۶، دیگر نمیتوانید برچسبهای محتوای دیجیتال خاص را با استفاده از هدفگیری حذف کنید. برای تطبیق با این تغییر، تغییرات زیر در API نمایش و ویدئو ۳۶۰ و فایلهای داده ساختاریافته اعمال خواهد شد:
ستون « Digital Content Labels - Exclude در SDFهای آیتمهای خطی ، فقط امکان اختصاص گزینه «؟» را فراهم میکند، در غیر این صورت ستون باید خالی باشد. تلاش برای اختصاص هر مقدار دیگری منجر به خطا در آپلود خواهد شد.
نیلسن به عنوان یک فروشنده شخص ثالث، ارتقای برند را اندازهگیری میکند
۱۳ ژوئیه ۲۰۲۶
از ۱۳ جولای ۲۰۲۶، نیلسن دیگر نمیتواند به عنوان یک فروشنده شخص ثالث برای اندازهگیری ارتقای برند تعیین شود. برای تطبیق با این تغییر، تغییرات زیر در API نمایش و ویدئو ۳۶۰ و فایلهای داده ساختاریافته اعمال خواهد شد:
ستون TrueView Third-Party Brand Lift Vendor در فهرست اقلام SDF دیگر گزینهی «Nielsen» را مجاز نخواهد بود.
استفاده فعلی از نیلسن به عنوان فروشنده برند آسانسور حذف خواهد شد.
برای جلوگیری از وقفه در ارائه خدمات، هرگونه واگذاری نیلسن به عنوان فروشنده برند آسانسور را از فرآیند ادغام خود حذف کنید.
نام تجاری و لوگوی پیشفرض به ارث رسیده
۱۳ ژوئیه ۲۰۲۶
از ۱۳ جولای ۲۰۲۶، تبلیغات واکنشگرای یوتیوب پشتیبانی از نام و لوگوی تجاری را آغاز خواهند کرد و همه تبلیغات واکنشگرای Demand Gen و یوتیوب که نام و لوگوی تجاری آنها تنظیم نشده باشد، از هرگونه مقادیر پیشفرض تعیینشده در سطح تبلیغکننده بهرهمند خواهند شد. در عین حال، این تغییر باعث تغییرات زیر در رفتار Display & Video 360 API و فایلهای داده ساختاریافته خواهد شد:
فیلدهای businessName ، logo و logoImages در منابع ad_details Demand Gen AdGroupAd دیگر در صورت اختصاص مقادیر پیشفرض به تبلیغکنندهی والد، مورد نیاز نخواهند بود. در صورت عدم ارائه، تبلیغ از مقادیر پیشفرض سطح تبلیغکننده پیروی خواهد کرد.
ستونهای Logo Asset IDsBusiness Name و لوگو در SDFهای تبلیغاتی (Ad SDFs) را میتوان برای تبلیغاتی با هر یک از انواع زیر تنظیم کرد: «واکنشگرا»، «محصول نسل تقاضا»، «ویدئوی نسل تقاضا»، «تصویر نسل تقاضا» و «چرخ فلک نسل تقاضا». اگر این ستونها برای یک ورودی تبلیغ مرتبط تنظیم نشده باشند و مقادیر پیشفرض به تبلیغکننده والد اختصاص داده شده باشد، تبلیغ هنگام ذخیره، پیشفرضهای سطح تبلیغکننده را به ارث میبرد.
ستونهای Logo Asset IDsBusiness Name و لوگو در Ad SDFها دیگر برای تبلیغات Demand Gen مورد نیاز نیستند، اگر تبلیغکنندهی والد مقادیر پیشفرض را به آنها اختصاص داده باشد.
اگر مقادیر پیشفرض در سطح تبلیغکننده تنظیم شوند، به همه تبلیغات تحت آن تبلیغکننده، نام تجاری و مقدار لوگو اختصاص داده میشود. اگر میخواهید مقادیر نام تجاری و مقادیر لوگو را برای تبلیغات واکنشگرای یوتیوب تنظیم نکنید، مقادیر پیشفرض را برای تبلیغکننده خود تنظیم نکنید .
مدیریت ترتیب درج و هدفگیری کمپین در Display & Video 360 API و فایلهای داده ساختاریافته
۲۳ فوریه ۲۰۲۶
در ۲۳ فوریه ۲۰۲۶، Display & Video 360 ترتیب درج و هدفگیری کمپین را غیرفعال خواهد کرد. تغییراتی در API Display & Video 360 و فایلهای داده ساختاریافته (SDF) ایجاد خواهد شد تا با این تغییر همسو شوند. در Display & Video 360 API، زیرمجموعهای از متدها غیرفعال میشوند و در صورت فراخوانی خطا برمیگردانند. در SDF، ستونهای هدفگیری در فایلهای ترتیب درج و کمپین دیگر در هنگام دانلود پر نمیشوند و لازم است در هنگام آپلود خالی باشند. توصیه میشود کاربران هنگام ایجاد آیتمهای خطی، هدفگیری را مستقیماً به آیتمهای خطی اختصاص دهند.
متدهای Display & Video 360 API زیر در صورت فراخوانی، خطای 404 را برمیگردانند:
اعلام کنید که آیا موارد خط به تبلیغات سیاسی اتحادیه اروپا خدمت میکنند یا خیر
۸ سپتامبر ۲۰۲۵
از ۸ سپتامبر ۲۰۲۵، هنگام ایجاد یک ردیف آگهی جدید با استفاده از Display & Video 360 API یا SDFها، لازم است اعلام کنید که آیا آن ردیف آگهی، تبلیغات سیاسی اتحادیه اروپا را نمایش میدهد یا خیر. این اعلانها را میتوان به روشهای زیر انجام داد:
استفاده از ستون Contains EU Political Ads در نوع فایل SDF v9 Line Item .
اگر تبلیغکنندهی والد شما هیچ آیتم خطی که تبلیغات سیاسی اتحادیهی اروپا را ارائه میدهد، نداشته باشد، میتوانید با استفاده از فیلد containsEuPoliticalAds در منبع Display & Video 360 API Advertiser ، در سطح تبلیغکننده اعلام کنید. اگر این فیلد روی DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING تنظیم شده باشد، به تمام آیتمهای خطی جدید زیر تبلیغکننده، در صورتی که مقدار دیگری مشخص نشده باشد، مقدار یکسانی اختصاص داده میشود و اگر مقداری از قبل تنظیم نشده باشد، تمام آیتمهای خطی موجود زیر تبلیغکننده برای استفاده از همان مقدار بهروزرسانی میشوند. اعلان یک آیتم خطی را میتوان در هر زمانی پس از ایجاد با استفاده از رابط کاربری، API یا SDF بهروزرسانی کرد.
اگر نمیتوانید در سطح تبلیغکننده اعلام کنید یا اعلام کردهاید که تبلیغات سیاسی اتحادیه اروپا ممکن است تحت عنوان تبلیغکننده شما ارائه شود، برای جلوگیری از وقفه در سرویس، API و ادغام Display & Video 360 خود را قبل از ۸ سپتامبر ۲۰۲۵ بهروزرسانی کنید:
به نسخه ۹ فایلهای داده ساختاریافته مهاجرت کنید و ستون Contains EU Political Ads را برای هر آیتم خط جدید در هنگام آپلود روی Yes یا No تنظیم کنید. برای دستورالعملهای گام به گام، به راهنمای مهاجرت نسخه ۹ ما مراجعه کنید.
قبل از بهروزرسانی هدفگذاری جغرافیایی برای یک آیتم خطی موجود با استفاده از Display & Video 360 API یا SDF، آیتم خطی را بهروزرسانی کنید تا یک اعلان ارائه دهد.
تنظیمات دستهبندی محتوا برای یوتیوب و شرکایش
۱۲ ژوئن ۲۰۲۵
در ۱۲ ژوئن ۲۰۲۵، به عنوان بخشی از بهروزرسانی تجربه تناسب برند ، پیکربندیهای دستهبندی محتوا برای آیتمهای خطی یوتیوب و شرکا دیگر در سطح قابل تغییر نخواهند بود. در عوض، تنظیمات دستهبندی محتوا صرفاً در سطح تبلیغکننده کنترل میشوند. برای تطبیق با این تغییر، تغییرات زیر در API نمایش و ویدیو ۳۶۰ و فایلهای داده ساختاریافته اعمال خواهد شد:
هنگام بهروزرسانی ورودیهای سطر SDF ، تغییر ستون TrueView Content Filter را متوقف کنید. هنگام ایجاد سطرهای جدید، ستون را خالی نگه دارید.
بهروزرسانیهای بودجه ردیفهای بودجه با بهینهسازی ترتیب درج
۱۲ ژوئن ۲۰۲۵
از ۱۲ ژوئن ۲۰۲۵، دیگر نمیتوانید تنظیمات بودجه را برای ردیفهایی که سفارشهای درج والد روی بهینهسازی با استفاده از استراتژیهای پیشنهاد قیمت خودکار تنظیم شدهاند، بهروزرسانی کنید.
در SDF: بررسی کنید که آیا ستون Insertion Order Optimizationورودی SDF مربوط به ردیف آیتم، روی TRUE تنظیم شده است یا خیر. در این صورت، سعی نکنید ستونهای Budget Type یا Budget Amount را برای ردیف آیتم SDF بهروزرسانی کنید.
محدودیتهای سایت برای فایلهای داده ساختاریافته
۱۲ ژوئن ۲۰۲۵
از ۱۲ ژوئن ۲۰۲۵، محدودیت موجود برای URLهای هدفگذاریشده در ورودیهای SDF که مانع از گنجاندن سایتهای جدیدتر میشد را حذف خواهیم کرد. در عوض، SDF رفتار API و UI را مطابقت میدهد و امکان هدفگیری URLها را تا زمانی که به درستی قالببندی شده باشند، فراهم میکند.
این مربوط به ستونهای Site Targeting - Include و Site Targeting - Exclude در فایلهای «ترتیب درج» و «مورد سطر» است.
ستون «ضرایب پیشنهاد قیمت» در فایلهای داده ساختاریافته ردیف کالا
۱ مه ۲۰۲۵
در تاریخ ۱ مه ۲۰۲۵، ورودیهای موجود در فایلهای داده ساختاریافتهی اقلام خطی که سعی در تنظیم ستون «ضرایب پیشنهاد قیمت» دارند، در هنگام آپلود فایل، قادر به ایجاد یا بهروزرسانی منبع نخواهند بود.
برای اقلام خط تولید تقاضا در فایلهای داده ساختاریافته، به منبع موجودی شریک ویدیویی نیاز است.
۲۲ آوریل ۲۰۲۵
از ۲۲ آوریل ۲۰۲۵، شما ملزم خواهید بود که مقدار «Video Partners» را در ستون TrueView Inventory Source Targeting برای ورودیهای ردیف آیتمهایی که مقدار ستون Type آنها «Demand Gen» است، وارد کنید. پس از شروع این الزام، مقدار برای ردیف آیتمهای موجود دوباره پر میشود و هنگام دانلود فایلهای داده ساختاریافته جدید نیز لحاظ میگردد.
برای جلوگیری از هرگونه وقفه در سرویس:
ادغام خود را بهروزرسانی کنید تا مقدار «شرکای ویدیویی» در تمام ورودیهای ردیف Demand Gen لحاظ شود.
ادغام خود را برای مدیریت منابع موجودی Demand Gen در سطح گروه تبلیغاتی با استفاده از ستونهای گروه تبلیغاتی SDF نسخه ۸.۱ با عنوانهای Demand Gen Inventory Source Strategy و Demand Gen Enabled Inventory Sources بهروزرسانی کنید.
کمپینهای اکشن ویدیویی در فایلهای داده ساختاریافته
۲۲ آوریل ۲۰۲۵
در ۲۲ آوریل ۲۰۲۵، دیگر نمیتوانید با استفاده از فایلهای داده ساختاریافته (Structured Data Files)، آیتمهای خطی (Line Items) برای کمپینهای اکشن ویدیویی ایجاد کنید، زیرا این فایلها به Demand Gen ارتقا مییابند. ورودیهای آیتم خطی که سعی میکنند با مقدار ستون Subtype با "Action" و مقدار ستون Type برابر با "TrueView" آپلود شوند، با شکست مواجه خواهند شد.
برای جلوگیری از هرگونه وقفه در سرویس، ادغام خود را بهروزرسانی کنید تا به جای کمپینهای اکشن ویدیویی، از Demand Gen استفاده کنید.
در ۷ آوریل ۲۰۲۵، منابع FirstAndThirdPartyAudience دیگر اجازه مدت زمان عضویت نامحدود مخاطبان را نخواهند داد. درخواستهای firstAndThirdPartyAudiences.create و firstAndThirdPartyAudiences.patch که مقدار فیلد membershipDurationDays را روی ۱۰۰۰۰ تنظیم میکنند، خطای 400 را برمیگردانند. مخاطبان فعلی که مقدار فیلد membershipDurationDays آنها ۱۰۰۰۰ است، به ۵۴۰ بهروزرسانی میشوند و مدت زمان عضویت جدید به صورت عطف به ماسبق برای عضویتهای موجود اعمال میشود. این کار باعث میشود تمام عضویتهای قدیمیتر از ۵۴۰ روز منقضی شوند.
برای جلوگیری از هرگونه وقفه در سرویس:
تأیید کنید که ادغام شما مقدار فیلد membershipDurationDays مخاطبان جدید یا موجود را روی ۱۰۰۰۰ تنظیم نمیکند.
ورودیهای موجود در فایلهای داده ساختاریافتهی آیتمهای خطی که سعی در بهروزرسانی ستون «شناسههای فعالیت نورافکن تبدیل» هنگام تنظیم ستون «شناسه الگوریتم» دارند، هنگام بارگذاری فایل بهروزرسانی نخواهند شد.
برای جلوگیری از هرگونه وقفه در سرویس، ادغام خود را به موارد زیر بهروزرسانی کنید:
تأیید کنید که فعالیتهای مربوط به نورپردازی، قبل یا همزمان با اختصاص الگوریتم مناقصه سفارشی، به یک آیتم خطی اختصاص داده شدهاند.
الگوریتمهای مناقصه سفارشی موجود، قبل از تلاش برای بهروزرسانی، از تمام اقلام ردیف تخصیص داده نمیشوند.
منسوخ شدن ویژگیهای قبلی
برای مطالعهی موارد منسوخشدهی اعلامشده که بر نسخههای منسوخشدهی رابط برنامهنویسی کاربردی Display & Video 360 تأثیر میگذارند، به موارد منسوخشدهی بایگانیشدهی ما مراجعه کنید.
تاریخ آخرین بهروزرسانی 2026-08-28 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-08-28 بهوقت ساعت هماهنگ جهانی."],[],[]]