ملفات البيانات المنظَّمة (SDF) هي ملفات CSV منسَّقة بشكل خاص. تتيح هذه الواجهة استرداد الموارد وإنشاؤها وتعديلها بشكل مجمّع في "مساحة العرض والفيديو 360". يمكنك إجراء تعديلات على المراجع بشكل مجمّع من خلال تنزيل ملفات SDF وتعديلها ثم إعادة تحميلها.
تتيح واجهة مستخدم "مساحة العرض والفيديو 360" عمليات تنزيل وتحميل ملفات SDF. تتيح واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" تنزيل ملفات SDF.
التنسيقات
يستخدم SDF أحد التنسيقَين الأساسيَين التاليَين: عادي وQA:
- يمكنك تنزيل ملفات بتنسيق قياسي وتحميلها. قد تستخدم البيانات في هذه الملفات معرّفات رقمية لضمان الدقة عند التحميل. قد تكون هناك حاجة إلى معلومات مرجعية لتفسير البيانات.
- يمكنك تنزيل ملفات بتنسيق QA. توفّر هذه الملفات البيانات نفسها المتوفّرة في ملفات التنسيق العادي، ولكنها تستخدم قيمًا يمكن لشخص عادي قراءتها. على سبيل المثال، قد تستخدم بعض الأعمدة أسماء معروضة بدلاً من المعرّفات. تستخدم الأعمدة الخاصة بهذا التنسيق اللاحقة "Qa".
أنواع الملفات
يتوافق SDF مع سبعة أنواع من الموارد. لكل نوع من أنواع الموارد نوع ملف خاص به وبنية أعمدة خاصة به. أنواع الموارد المتوافقة هي:
- الحملة
- طلب إدراج
- العنصر
- المجموعة الإعلانية
- إعلان
- مصدر المساحات الإعلانية
- المنتج الإعلامي
لا يتيح نوعا الملفات عنصر الحملة والمجموعة الإعلانية استخدام تنسيق ضمان الجودة.
يتم إصدار إصدارات جديدة من SDF بانتظام، كما يتم إيقاف الإصدارات القديمة نهائيًا. تعدّل الإصدارات الجديدة بنية عمود نوع الملف. إذا لزم الأمر، سيتضمّن إصدار جديد من SDF دليل نقل بيانات عند إطلاقه.
أخطاء التنزيل
يمكن أن تؤدي عمليات تنزيل ملفات SDF إلى حدوث نوعَين من الأخطاء: أخطاء إنشاء الملفات والموارد التي تم تخطّيها.
أخطاء إنشاء الملفات
يمكن أن تتوقف عملية إنشاء ملفات SDF بسبب حدوث خطأ. في حال تعذّر إنشاء التقرير عند استخدام Display & Video 360 API، سيتم ضبط الحقل error للمهمة المكتملة باستخدام العنصر Status. سيتضمّن العنصر
Status رسالة توضّح سبب
الخطأ.
يمكنك الاطّلاع على مزيد من المعلومات حول هذه الأخطاء في صفحة دليل الأخطاء والتحذيرات.
الأخطاء التي تم تخطّيها
لا تتوافق ملفات SDF مع جميع الأنواع الفرعية للموارد. إذا تعذّر تضمين أحد المراجع في ملف SDF، سيتم تضمين ملف "تم تخطّيه" (مثال: SDF-LineItems-Skipped.csv) في عملية التنزيل. يحتوي هذا الملف على بنية من عمودين. يحدّد العمود الأول المرجع الذي تم تخطّيه. ويشرح العمود الثاني سبب استبعادها.
تحميل الملفات
حمِّل ملفات SDF باستخدام واجهة مستخدم "مساحة العرض والفيديو 360" لإنشاء مراجع جديدة أو تعديل المراجع الحالية.
اتّبِع الخطوات التالية لتقليل الأخطاء عند تعديل الموارد أو إنشائها باستخدام ملفات SDF:
- يمكنك تنزيل ملفات SDF باستخدام واجهة برمجة التطبيقات لمساحة العرض والفيديو 360 أو واجهة المستخدم.
- تعديل إدخالات الملفات الحالية لإجراء تعديلات على المراجع الحالية
- أضِف إدخالات ملفات لإنشاء مراجع جديدة.
- أزِل أي إدخالات ليست جديدة أو معدَّلة. يؤدي ذلك إلى تقليل حجم الملف وإزالة فرصة إجراء تحديثات غير مقصودة.
- حمِّل الملف في واجهة مستخدم "مساحة العرض والفيديو 360".
بعد تحميل ملف SDF ومعالجته، يصبح ملف SDF-ResultFile.zip متاحًا للتنزيل. يمكن أن يحتوي ملف ZIP هذا على ملفَين محتملَين:
SDF-{ResourceType}-Updated-ResultFile.csv، التي تسرد الموارد التي تم تعديلها أو إنشاؤها بنجاح.SDF-{ResourceType}-Failed-ResultFile.csv، الذي يسرد العمليات التي تعذّر تنفيذها ورسائل الخطأ ذات الصلة.
قد يحتوي ملف ZIP على أحد الملفين أو كليهما.