Performance reports

Merchant API 會提供成效報表 ProductPerformanceView。 本頁說明成效報表的結構，

指標

您可以查詢自己想查詢的指標 (例如 clicks 和 impressions) 您希望傳回的值您必須新增日期範圍的篩選器，才能查詢報表 效能資料服務

以下是傳回單一資料列和總點擊次數的查詢範例 在指定日期範圍內：

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

您必須指定要傳回的資料。萬用字元 (例如 SELECT *) 會傳回錯誤。

以下範例回應顯示，商家的總計有 4,440 個 12 月 1 日這段期間， 2020 年和 2020 年 12 月 21 日。

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

路段

您可以使用 MCQL 查詢區隔欄位。區隔欄位可以 產品屬性 (例如 offerId、brand 和 category) 或事件 屬性 (例如 date 和 marketingMethod)。

區隔欄位的運作方式與 SQL 中的 GROUP BY 類似。[區隔] 欄位會劃分出 選取的指標，按 SELECT 子句中每個區隔分組。

以下是傳回每日點擊次數的查詢範例 (遞減排序) clicks) 符合日期範圍新增條件。僅顯示至少 系統會傳回非零的值。

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

以下回應範例顯示，商家在各大平台獲得 1,546 次點擊 所有行銷方式中的所有產品，日期為 2020 年 12 月 1 日和 829 日 2020 年 12 月 2 日所有行銷方式上所有產品的點擊次數。 該商家在 2020 年 12 月 3 日沒有獲得任何點擊，因此不會傳回 日期。

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