قد تحتاج إلى نقل البيانات إلى الإصدار 9 لتحميل ملفات البيانات المنظَّمة بعد 8 سبتمبر 2025. يمكنك الاطّلاع على صفحة الإيقاف النهائي للحصول على مزيد من التفاصيل ودليل نقل البيانات إلى الإصدار 9 للحصول على تعليمات مفصّلة.
الانتقال إلى الإصدار 9 من ملفات البيانات المنظَّمة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تاريخ آخر تعديل: 2025-08-21
يرشدك هذا الدليل خلال العمليات التالية:
عدِّل إصدار "ملفات البيانات المنظَّمة" المحدَّد إلى الإصدار 9 باستخدام واجهة مستخدم "مساحة العرض والفيديو 360" أو واجهة برمجة التطبيقات.
نقل عملية الدمج من إصدارات "ملفات البيانات المنظَّمة" القديمة (الإصدار 7 أو 7.1 أو 8 أو 8.1) إلى الإصدار 9 ويوجّهك إلى صفحات تتضمّن تفاصيل التغييرات بين الإصدار الحالي والإصدار 9 التي قد تؤثّر في عملية الدمج. في بعض الحالات، عليك استخدام الإصدار 9 لتحميل ملفات SDF اعتبارًا من 8 سبتمبر 2025.
لاستخدام الإصدار 9، عليك تعديل مواردك وإجراءات إنشاء ملفات البيانات المنظَّمة لاستخدام الإصدار 9 عند تنزيل ملفات البيانات المنظَّمة وتحميلها.
تعديل إصدار ملفات البيانات المنظَّمة
لاستخدام إصدار جديد من "ملفات البيانات المنظَّمة"، عدِّل الإصدار المعيّن في موارد "الشريك" و"المعلِن" الرئيسية، واستخدِم الإصدار الجديد عند إنشاء مهام تنزيل فردية في Display & Video 360 API.
تعديل إعدادات المورد الرئيسي
يمكنك ضبط الإصدار التلقائي من "ملفات البيانات المنظَّمة" على مستوى موارد الشريك والمعلِن. يتم استخدام هذا الإصدار كإصدار تلقائي عند تنزيل ملفات البيانات المنظَّمة من خلال الواجهة أو واجهة برمجة التطبيقات.
الضبط في الواجهة
على مستوى الشريك:
انتقِل إلى الشريك المقصود.
انتقِل إلى صفحة التفاصيل الأساسية ضمن قائمة إعدادات الشريك في قائمة التنقّل اليمنى.
عدِّل إعداد إصدار SDF في قسم "ملفات البيانات المنظَّمة" إلى الإصدار 9.
على مستوى المعلِن:
انتقِل إلى المعلِن المقصود.
انتقِل إلى صفحة التفاصيل الأساسية ضمن قائمة إعدادات المعلِن في قائمة التنقّل اليمنى.
عدِّل إعدادات إصدار SDF في قسم ملفات البيانات المنظَّمة إلى الإصدار 9. إذا تم ضبط الإصدار التلقائي على مستوى الشريك، قد لا يكون هذا الإعداد قابلاً للتعديل.
الضبط في واجهة برمجة التطبيقات
على مستوى الشريك: لا يمكنك ضبط الإصدار التلقائي من SDF على مستوى الشريك في واجهة برمجة التطبيقات.
تعديل طلبات sdfdownloadtasks.create في واجهة برمجة التطبيقات
عند تقديم طلب 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)"]]
