Performance reports

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

指標

您可以查詢想要傳回的指標 (例如 clicks 和 impressions)。您必須對日期範圍新增篩選器，才能在報表服務中查詢效能資料。

以下查詢範例會傳回單一資料列，其中包含指定日期範圍內的點擊總數：

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

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

下列回應範例顯示，在 2020 年 12 月 1 日至 2020 年 12 月 21 日期間，商家在所有行銷方式中的共獲得 4,440 次點擊。

{
  "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

下列回應範例顯示，商家在 2020 年 12 月 1 日，所有行銷方式的所有產品共獲得 1,546 次點擊，所有產品的所有行銷方法共獲得 829 次點擊。商家在 2020 年 12 月 3 日沒有獲得任何點擊，因此該日期不會傳回任何結果。

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