Performance reports

Merchant API گزارش‌های عملکرد را ارائه می‌کند، به عنوان مثال ProductPerformanceView . این صفحه ساختار گزارش های عملکرد را توضیح می دهد.

معیارها

می‌توانید معیارهایی (به عنوان مثال، clicks و impressions ) را که می‌خواهید برگردانده شوند، جستجو کنید. برای پرس و جو از سرویس گزارش ها برای داده های عملکرد، باید یک فیلتر در محدوده تاریخ اضافه کنید.

در اینجا یک پرس و جو نمونه است که یک ردیف را با تعداد کل کلیک ها در محدوده تاریخ مشخص شده برمی گرداند:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

باید داده هایی را که می خواهید برگردانید مشخص کنید. حروف عام (به عنوان مثال، SELECT * ) یک خطا برمی گرداند.

پاسخ نمونه زیر نشان می‌دهد که بازرگان در بین 1 دسامبر 2020 تا 21 دسامبر 2020، 4440 کلیک در کل محصولات، در همه روش‌های بازاریابی داشته است.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

بخش ها

می توانید از MCQL برای پرس و جو برای فیلدهای بخش استفاده کنید. فیلدهای بخش‌ها می‌توانند ویژگی‌های محصول (به عنوان مثال، offerId ، brand ، و category ) یا ویژگی‌های رویداد (به عنوان مثال date و marketingMethod ) باشند.

فیلدهای Segments مشابه GROUP BY در SQL عمل می کنند. فیلدهای بخش، معیارهای انتخابی را تقسیم می‌کنند و بر اساس هر بخش در عبارت SELECT گروه‌بندی می‌شوند.

در اینجا یک جستجوی نمونه وجود دارد که کلیک‌ها را در هر روز، به ترتیب نزولی بر اساس clicks ، در شرایط اضافه شده در محدوده تاریخ برمی‌گرداند. فقط ردیف هایی که حداقل یکی از معیارهای درخواستی آنها غیر صفر باشد، برگردانده می شوند.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

پاسخ نمونه زیر نشان می‌دهد که تاجر ۱۵۴۶ کلیک در همه محصولات، در همه روش‌های بازاریابی، در ۱ دسامبر ۲۰۲۰، و ۸۲۹ کلیک روی همه محصولات، در همه روش‌های بازاریابی، در ۲ دسامبر ۲۰۲۰ داشته است. تاجر هیچ کلیکی روی آن نداشت. 3 دسامبر 2020، بنابراین چیزی برای آن تاریخ برگردانده نمی شود.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}