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