گزارش اجمالی

رابط برنامه‌نویسی کاربردی (API) کمپین مدیر ۳۶۰ (Campaign Manager 360) روش‌های مختلفی برای بازیابی داده‌های مربوط به تبلیغاتی که از طریق کمپین مدیر ۳۶۰ منتشر می‌شوند، ارائه می‌دهد.

سرویس گزارش‌ها

تولید گزارش‌ها با استفاده از سرویس Reports شامل یک گردش کار چند مرحله‌ای برای پیکربندی، تولید و بازیابی فایل‌های گزارش (مانند فرمت CSV یا Excel) است. این مسیر گزارش‌دهی استاندارد برای API Campaign Manager 360 است و برای مجموعه داده‌های بزرگ، اسکریپت‌های زمان‌بندی شده خودکار یا برنامه‌های پایین‌دستی که فایل‌ها را مصرف می‌کنند، مناسب است.

گردش کار معمولاً شامل مراحل زیر است:

1. یک منبع Report (با مشخص کردن ابعاد، معیارها، محدوده‌های تاریخ و فیلترها) را که با یک شناسه گزارش منحصر به فرد ذخیره می‌شود، تعریف یا پیدا کنید. به بخش ایجاد و به‌روزرسانی گزارش‌ها مراجعه کنید.
2. با فراخوانی متد reports.run تولید گزارش را اجرا کنید. این تابع، اجرای گزارش را در صف قرار می‌دهد و یک منبع File resource) را برمی‌گرداند. به بخش «یافتن و اجرای گزارش‌ها» مراجعه کنید.
3. وضعیت منبع File را به صورت دوره‌ای بررسی کنید. از آنجا که این فرآیند به صورت غیرهمزمان اجرا می‌شود، وضعیت یک فایل با PROCESSING شروع می‌شود و پس از اتمام به REPORT_AVAILABLE تغییر می‌یابد. به بخش «یافتن و اجرای گزارش‌ها» مراجعه کنید.
4. پس از اتمام تولید گزارش، محتوای فایل (CSV یا Excel) را دریافت کنید. به بخش دانلود گزارش‌ها مراجعه کنید.

اجرای گزارش‌ها به صورت همزمان

اگر نیاز به تولید فایل گزارش (CSV یا Excel) برای حجم کمی از داده‌ها دارید، می‌توانید گزارش را به صورت همزمان با فراخوانی متد reports.run با پارامتر synchronous که روی true تنظیم شده است، اجرا کنید. API تلاش می‌کند گزارش را در یک دوره زمانی کوتاه تولید کند. اگر اجرا بیشتر طول بکشد، اجرای گزارش به طور خودکار به صف غیرهمزمان برمی‌گردد.

برای جزئیات بیشتر، به گزارش‌های همگام‌سازی مراجعه کنید.

پرس و جو در مورد داده‌های گزارش

از متد reportData.query برای جستجوی مستقیم داده‌های گزارش به جای تولید یک فایل گزارش استفاده کنید.

• به جای ایجاد و ذخیره یک منبع Report ، شما ابعاد، معیارها و سایر معیارهای فیلتر یا مرتب‌سازی را مستقیماً در درخواست مشخص می‌کنید.
• این پاسخ حاوی داده‌های گزارش ساختاریافته است و نیاز به نظرسنجی و دانلود فایل تولید شده را از بین می‌برد.
• این درخواست به صورت همزمان و با محدودیت ۶۰ ثانیه اجرا می‌شود.

برای جزئیات بیشتر، به Query JSON Report Data مراجعه کنید.