نظرة عامة على إعداد التقارير

توفّر واجهة برمجة التطبيقات Campaign Manager 360 API عدة طرق لاسترداد بيانات الإعلانات التي تتم إدارتها من خلال "مدير الحملة 360".

خدمة التقارير

يتضمّن إنشاء التقارير باستخدام خدمة Reports سير عمل متعدّد الخطوات لتحديد ملفات التقارير وإنشائها واستردادها (مثل تنسيق CSV أو Excel). هذا هو مسار إعداد التقارير العادي لواجهة برمجة التطبيقات Campaign Manager 360 API وهو مناسب لمجموعات البيانات الكبيرة أو النصوص البرمجية المجدولة الآلية أو التطبيقات النهائية التي تستهلك الملفات.

يتألف سير العمل عادةً من الخطوات التالية:

1. تحديد مورد Report أو العثور عليه (تحديد السمات والمقاييس والنطاقات الزمنية والفلاتر) الذي يتم حفظه باستخدام معرّف تقرير فريد يُرجى الاطّلاع على مقالة إنشاء التقارير وتعديلها.
2. تشغيل عملية إنشاء التقارير من خلال استدعاء الـ reports.run method. يؤدي ذلك إلى وضع عملية تشغيل التقرير في قائمة الانتظار وعرض مورد File نائب. يُرجى الاطّلاع على مقالة البحث عن التقارير وتشغيلها.
3. التحقّق بشكل دوري من حالة مورد File بما أنّ هذه العملية يتم تشغيلها بشكل غير متزامن، ستبدأ حالة الملف على أنّها PROCESSING وتنتقل إلى REPORT_AVAILABLE عند اكتمالها. يُرجى الاطّلاع على مقالة البحث عن التقارير وتشغيلها.
4. جلب محتوى الملف (CSV أو Excel) بعد اكتمال عملية إنشاء التقرير يُرجى الاطّلاع على مقالة تنزيل التقارير.

تشغيل التقارير بشكل متزامن

إذا كنت بحاجة إلى إنشاء ملف تقرير (CSV أو Excel) لكمية صغيرة من البيانات، يمكنك تشغيل التقرير بشكل متزامن من خلال استدعاء الطريقة reports.run مع ضبط المعلَمة synchronous على true. تحاول واجهة برمجة التطبيقات إنشاء التقرير خلال فترة مهلة قصيرة. إذا استغرقت عملية التنفيذ وقتًا أطول، يتم تلقائيًا إعادة تشغيل التقرير في قائمة الانتظار غير المتزامنة.

لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة التقارير المتزامنة.

الاستعلام عن بيانات التقرير

استخدِم طريقة reportData.query للاستعلام عن بيانات إعداد التقارير مباشرةً بدلاً من إنشاء ملف تقرير.

• بدلاً من إنشاء مورد Report وحفظه، يمكنك تحديد السمات والمقاييس ومعايير الفلترة أو الترتيب الأخرى مباشرةً في الطلب.
• تحتوي الاستجابة على بيانات تقرير منظَّمة، ما يغني عن الحاجة إلى إجراء طلبات بحث عن ملف تم إنشاؤه وتنزيله.
• يتم تنفيذ الطلب بشكل متزامن مع مهلة قصوى تبلغ 60 ثانية.

لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة الاستعلام عن بيانات تقرير JSON.