ممکن است مجبور شوید برای آپلود فایل‌های داده ساختاریافته پس از ۸ سپتامبر ۲۰۲۵ به نسخه ۹ مهاجرت کنید. برای جزئیات بیشتر و راهنمای انتقال نسخه 9 ما برای دستورالعمل‌های گام به گام، صفحه منسوخ‌ها را ببینید.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
آخرین به روز رسانی: 2025-08-21
این راهنما شما را از طریق این فرآیندها راهنمایی می کند:
با استفاده از رابط کاربری Display & Video 360 UI یا API نسخه Structured Data Files انتخابی خود را به نسخه 9 به روز کنید.
ادغام خود را از نسخه های منسوخ شده فایل های داده ساختاریافته (v7، v7.1، v8، یا v8.1) به نسخه 9 منتقل کنید. شما را به صفحاتی راهنمایی می کند که جزئیات تغییرات بین نسخه فعلی و نسخه 9 را نشان می دهد که ممکن است بر یکپارچگی شما تأثیر بگذارد. در برخی موارد، باید از v9 برای آپلود SDF از تاریخ 8 سپتامبر 2025 استفاده کنید.
برای استفاده از v9، باید منابع و اقدامات تولید SDF خود را به روز کنید تا از v9 هنگام دانلود و آپلود فایل های داده ساختاریافته استفاده کنید.
نسخه فایل های داده ساختاریافته را به روز کنید
برای استفاده از نسخه جدید فایل‌های داده ساختاریافته، نسخه اختصاص داده شده را در منابع شریک و آگهی‌دهنده خود به‌روزرسانی کنید و هنگام ایجاد تکالیف دانلود در Display & Video 360 API از نسخه جدید استفاده کنید.
تنظیمات منبع والد را به روز کنید
شما نسخه پیش‌فرض Structured Data Files را در سطح منبع شریک و تبلیغ‌کننده تنظیم می‌کنید. این نسخه به عنوان پیش‌فرض هنگام دانلود فایل‌های داده ساختاریافته از طریق رابط یا API استفاده می‌شود.
در رابط تنظیم کنید
در سطح شریک:
به شریک مورد نظر بروید.
به صفحه جزئیات اولیه در منوی تنظیمات شریک در ناوبری سمت چپ بروید.
پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 9 به روز کنید.
در سطح تبلیغ کننده:
به تبلیغ کننده مورد نظر بروید.
به صفحه جزئیات اولیه در منوی تنظیمات آگهی‌دهنده در ناوبری سمت چپ بروید.
پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 9 به روز کنید. اگر نسخه پیش‌فرض در سطح شریک تنظیم شده باشد، ممکن است این تنظیم قابل ویرایش نباشد.
در API تنظیم کنید
در سطح شریک: نمی‌توانید نسخه پیش‌فرض SDF را در سطح شریک در API تنظیم کنید.
درخواست‌های sdfdownloadtasks.create را در API به‌روزرسانی کنید
هنگام ایجاد یک درخواست sdfdownloadtasks.create با استفاده از Display & Video 360 API، قسمت version بدنه درخواست را روی SDF_VERSION_9 تنظیم کنید.
از نسخه SDF فعلی خود مهاجرت کنید
صفحات زیر شما را از طریق به‌روزرسانی‌های لازم برای ادغام خود در هنگام مهاجرت از نسخه فعلی به نسخه 9 راهنمایی می‌کنند و فهرستی جامع از همه تغییرات بین نسخه‌ها ارائه می‌دهند:
تاریخ آخرین به‌روزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Migrate to Structured Data Files v9\n\n*Last update: 2025-08-21*\n\nThis guide leads you through these processes:\n\n- Update your selected Structured Data Files version to v9 using the Display \\& Video 360 UI or API.\n- Migrate your integration from deprecated Structured Data Files versions (v7, v7.1, v8, or v8.1) to v9. It points you to pages detailing the changes between your current version and v9 that may impact your integration. In some cases, you will have to use v9 to upload SDFs starting on September 8, 2025.\n\nSee the [migration pages specific to each version](#migrate_from_your_current_sdf_version) for an\nexhaustive list of differences between your version and v9.\n\nUpdate your Structured Data Files version\n-----------------------------------------\n\nTo use v9, you must update your resources and SDF generation actions to use v9\nwhen downloading and uploading Structured Data Files.\n\n### Update Structured Data Files version\n\nTo use a new Structured Data Files version, update the assigned version in your\nparent Partner and Advertiser resources and use the new version when creating\nindividual download tasks in the [Display \\& Video 360 API](/display-video/api/guides/getting-started/overview).\n\n#### Update parent resource settings\n\nYou set the default Structured Data Files version at the partner and advertiser\nresource level. This version is used as the default when downloading Structured\nData Files through the interface or API.\n\n##### Set in the interface\n\n**At the partner level:**\n\n1. Navigate to the intended partner.\n2. Go to the **Basic Details** page under the **Partner Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the Structured Data Files section to **v9**.\n\n**At the advertiser level:**\n\n1. Navigate to the intended advertiser.\n2. Go to the **Basic Details** page under the **Advertiser Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the **Structured Data Files** section to **v9**. If the default version is set at the Partner level, this setting may not be editable.\n\n#### Set in the API\n\n**At the partner level:** You cannot set the default SDF version at the Partner\nlevel in the API.\n\n**At the advertiser level:** Make an [`advertisers.patch`](/display-video/api/reference/rest/current/advertisers/patch) request to\nupdate the\n[`dataAccessConfig.sdfConfig.sdfConfig.version`](/display-video/api/reference/rest/current/SdfConfig#FIELDS.version) to\n`SDF_VERSION_9` and, if needed,\n[`dataAccessConfig.sdfConfig.overridePartnerSdfConfig`](/display-video/api/reference/rest/current/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config)\nto True.\n\n### Update `sdfdownloadtasks.create` requests in the API\n\nWhen making a [`sdfdownloadtasks.create`](/display-video/api/reference/rest/current/sdfdownloadtasks/create) request using the\nDisplay \\& Video 360 API, set the [`version`](/display-video/api/reference/rest/current/sdfdownloadtasks/create#body.request_body.FIELDS.version) field of the request body to\n`SDF_VERSION_9`.\n\nMigrate from your current SDF version\n-------------------------------------\n\n| **Important:** The only new feature in v9 is the ability to declare whether a line item will serve EU political ads. This column will be required starting **September 8, 2025**.\n\nThe following pages walk you through the necessary updates to make to your\nintegration when migrating from your current version to v9 and provide a\ncomprehensive list of all changes between the versions:\n\n- [Migrate from v7](/display-video/api/structured-data-file/v7/migrate-to-v9)\n- [Migrate from v7.1](/display-video/api/structured-data-file/v7-1/migrate-to-v9)\n- [Migrate from v8](/display-video/api/structured-data-file/v8/migrate-to-v9)\n- [Migrate from v8.1](/display-video/api/structured-data-file/v8-1/migrate-to-v9)"]]
