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