يتيح كلٌّ من ملفات البيانات المنظَّمة (SDF) ومساحة العرض والفيديو 360 API الإدارة المجمَّعة لإعدادات موارد "مساحة العرض والفيديو 360 ". كل أداة لها قيود فريدة. يقترح هذا الدليل طرقًا لتحسين عملية التنفيذ الحالية باستخدام كلتا الأداتين.
إذا سبق لك استخدام ملفات البيانات المنظَّمة
يمكنك استخدام "مساحة العرض والفيديو 360 API" لدعم دمج SDF من خلال الاسترداد الآلي للملفات والبيانات الوصفية ذات الصلة.
إنشاء الملفات وتنزيلها باستخدام واجهة برمجة التطبيقات
يمكنك تلقائيًا تنزيل ملفات البيانات المنظَّمة يدويًا باستخدام واجهة "مساحة العرض والفيديو 360". تقتصر عمليات التنزيل هذه بشكلٍ عام على معلن واحد ويجب أن تبدأ من صفحات موارد محدّدة. قد يكون تنزيل الكثير من بيانات SDF من خلال الواجهة معقدًا ويستغرق وقتًا طويلاً.
يمكنك تبسيط هذه العملية من خلال إنشاء ملفات البيانات المنظَّمة وتنزيلها بشكل آلي باستخدام واجهة برمجة التطبيقات "مساحة العرض والفيديو 360". اقرأ دليلنا للحصول على تعليمات مفصّلة حول كيفية تنفيذ هذه الميزة.
البحث عن المعرّفات المرجعية باستخدام واجهة برمجة التطبيقات
تعكس ملفات البيانات المنظَّمة إعدادات موارد "مساحة العرض والفيديو 360". تستخدم معظم أعمدة SDF أرقام تعريف رقمية لتحديد الموارد الأخرى أو تكوينات الاستهداف. غالبًا ما تحتاج إلى مرجع لفهم هذه المعرفات عند قراءة بيانات SDF وتعديلها.
استخدِم "مساحة العرض والفيديو 360 API" لاسترداد المعلومات المرجعية بشكل مجمّع. يمكنك استرداد المعرّفات المتاحة التي تستخدمها معظم أعمدة SDF باستخدام دالة GET أو LIST للمورد ذي الصلة.
يمكنك استرداد المعلومات المرجعية وتخزينها مؤقتًا بشكل آلي لاستخدام تلك المعلومات المخزّنة مؤقتًا عند تحليل ملفات البيانات المنظَّمة وتعديلها. يمكنك تحديث ذاكرة التخزين المؤقت بانتظام، وإذا لزم الأمر، البحث عن المعرّفات غير المعروفة في الوقت الفعلي عند تحليل ملفات SDF لاسترداد المعلومات حول الموارد الجديدة.
يمكنك الاطّلاع على المستندات المرجعية لواجهة برمجة التطبيقات للحصول على قائمة شاملة بالخدمات والطرق المتاحة لواجهة برمجة التطبيقات.
الاستثناءات الحالية
لا يمكن استرداد عدد صغير من أرقام التعريف المرجعية التي تستخدمها ملفات البيانات المنظَّمة باستخدام واجهة برمجة التطبيقات "مساحة العرض والفيديو 360 ":
- الاستهداف ذو الاهتمامات المشتركة والاستهداف في السوق: يمكنك استرداد أرقام تعريف الجمهور المستخدمة في هذه الأعمدة من واجهة "مساحة العرض والفيديو 360 ".
- أرقام تعريف نشاط Floodlight للإحالات الناجحة: يمكنك استرداد أرقام تعريف نشاط Floodlight المستخدَمة في هذه الأعمدة من واجهة "مساحة العرض والفيديو 360".
- استهداف مصدر المستودع: استرِدّ أرقام تعريف Exchange المستخدَمة في هذه الأعمدة من مرجع تبادل SDF المنشور. استرداد أرقام تعريف مصدر المستودع وأرقام تعريف التبادل الفرعي المستخدَمة في هذه الأعمدة باستخدام مساحة العرض والفيديو 360 API.
- استهداف التطبيقات: استرجع أرقام تعريف التطبيقات المستخدمة في هذه الأعمدة من نظام التطبيق الأساسي ذي الصلة.
في حال استخدام "مساحة العرض والفيديو 360 API" حاليًا
يمكنك استخدام SDF لدعم دمج "مساحة العرض والفيديو 360 API " من خلال إنشاء موارد YouTube والشركاء وتعديلها بشكل مجمَّع.
تعديل مراجع YouTube والشركاء باستخدام تحميل SDF
لا يمكنك إنشاء موارد YouTube والشركاء أو تعديلها، مثل أنواع محدّدة من تفاصيل الإعلانات والمجموعات الإعلانية والإعلانات، باستخدام واجهة برمجة التطبيقات "مساحة العرض والفيديو 360". يمكنك استرداد عمليات الضبط والاستهداف المعيَّن لهذه الموارد، ولكن يجب إجراء أي تعديلات من خلال واجهة "مساحة العرض والفيديو 360". يؤدي ذلك إلى تقييد الإجراءات المجمّعة ويحد من المعدل الذي يمكنك به تحديث هذه الموارد.
يمكنك استخدام ميزة تحميل ملفات البيانات المنظَّمة لإنشاء موارد YouTube والشركاء أو تعديلها بشكل مجمَّع من خلال واجهة "مساحة العرض والفيديو 360 ". على الرغم من أنّه يجب تحميل ملفات البيانات المنظَّمة يدويًا، يمكنك إكمال معظم العملية، وتحديدًا استرداد الملفات وتعديلها، آليًا.
للاطّلاع على مزيد من المعلومات، يمكنك قراءة دليل واجهة برمجة التطبيقات حول تنزيل ملفات SDF والمستندات المتعلّقة بتحميل SDF.