آخرین به روز رسانی: 2025-08-21
این راهنما شما را از طریق این فرآیندها راهنمایی می کند:
- با استفاده از رابط کاربری Display & Video 360 UI یا API نسخه Structured Data Files انتخابی خود را به نسخه 9 به روز کنید.
- ادغام خود را از نسخه های منسوخ شده فایل های داده ساختاریافته (v7، v7.1، v8، یا v8.1) به نسخه 9 منتقل کنید. شما را به صفحاتی راهنمایی می کند که جزئیات تغییرات بین نسخه فعلی و نسخه 9 را نشان می دهد که ممکن است بر یکپارچگی شما تأثیر بگذارد. در برخی موارد، باید از v9 برای آپلود SDF از تاریخ 8 سپتامبر 2025 استفاده کنید.
برای فهرست کاملی از تفاوت‌های نسخه خود و نسخه 9، به صفحات مهاجرت ویژه هر نسخه مراجعه کنید.
نسخه Structured Data Files خود را به روز کنید
برای استفاده از v9، باید منابع و اقدامات تولید SDF خود را به روز کنید تا از v9 هنگام دانلود و آپلود فایل های داده ساختاریافته استفاده کنید.
نسخه فایل های داده ساختاریافته را به روز کنید
برای استفاده از نسخه جدید فایل‌های داده ساختاریافته، نسخه اختصاص داده شده را در منابع شریک و آگهی‌دهنده خود به‌روزرسانی کنید و هنگام ایجاد تکالیف دانلود در Display & Video 360 API از نسخه جدید استفاده کنید.
تنظیمات منبع والد را به روز کنید
شما نسخه پیش‌فرض Structured Data Files را در سطح منبع شریک و تبلیغ‌کننده تنظیم می‌کنید. این نسخه به عنوان پیش‌فرض هنگام دانلود فایل‌های داده ساختاریافته از طریق رابط یا API استفاده می‌شود.
در رابط تنظیم کنید
در سطح شریک:
- به شریک مورد نظر بروید.
- به صفحه جزئیات اولیه در منوی تنظیمات شریک در ناوبری سمت چپ بروید.
- پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 9 به روز کنید.
در سطح تبلیغ کننده:
- به تبلیغ کننده مورد نظر بروید.
- به صفحه جزئیات اولیه در منوی تنظیمات آگهی‌دهنده در ناوبری سمت چپ بروید.
- پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 9 به روز کنید. اگر نسخه پیش‌فرض در سطح شریک تنظیم شده باشد، ممکن است این تنظیم قابل ویرایش نباشد.
در API تنظیم کنید
در سطح شریک: نمی‌توانید نسخه پیش‌فرض SDF را در سطح شریک در API تنظیم کنید.
در سطح تبلیغ‌کننده: یک درخواست advertisers.patch برای به‌روزرسانی dataAccessConfig.sdfConfig.sdfConfig.version به SDF_VERSION_9 و در صورت نیاز dataAccessConfig.sdfConfig.overridePartnerSdfConfig به True ارائه دهید.
درخواست‌های sdfdownloadtasks.create را در API به‌روزرسانی کنید
هنگام ایجاد یک درخواست sdfdownloadtasks.create با استفاده از Display & Video 360 API، قسمت version بدنه درخواست را روی SDF_VERSION_9 تنظیم کنید.
از نسخه SDF فعلی خود مهاجرت کنید
صفحات زیر شما را از طریق به‌روزرسانی‌های لازم برای ادغام خود در هنگام مهاجرت از نسخه فعلی به نسخه 9 راهنمایی می‌کنند و فهرستی جامع از همه تغییرات بین نسخه‌ها ارائه می‌دهند: