本頁面由 Cloud Translation API 翻譯而成。

總覽

Reporting API

Reporting API 可讓商家與成效資料互動透過 Merchant Center 查詢語言 (以程式輔助的方式建立)這與包括建立自訂報表直接在 Merchant Center 中管理設定Reporting API 的優點如下：

讓大型商家將產品資訊成效資料匯入內部或第三方檢舉系統。
允許管理商家的使用者、第三方合作夥伴和集結網站存取報表。

API 使用者可以指定要從搜尋來電回應，例如：

要傳回的指標 (例如：點擊次數、曝光次數)
用來區隔資料的維度 (例如：OfferId、Date)
必須符合的條件 (例如：點擊次數 > 100)

Reporting API 查詢語言可以查詢 Content API for Shopping：成效指標 (點擊次數、曝光次數) 可按多種類型區隔維度 (記錄的事件屬性，例如計畫和日期) 屬性 (例如品牌、類別等) 則必須使用Search 「Reports」服務。

對 Reports 服務執行查詢的結果，是一系列 ReportRow 每個 ReportRow 都代表要求的指標值您在查詢中指定的區隔如果沒有指定區隔，則只會有一個傳回的資料列，以及所有區隔的匯總指標。或者，如有要求區隔和指標，而回應顯示一列每個不重複的區隔元組您可以選取多個區隔一筆查詢傳回多項指標

查詢指標

您可以查詢所需的指標 (點擊、曝光、點閱率等) 。您必須新增日期範圍的篩選器，才能查詢報表服務。下方的查詢範例會傳回單一資料列：匯總金額在指定日期範圍內納入新增條件的點擊次數。

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

回應範例

下列 JSON 程式碼回應範例顯示此商家獲得 4,440 次點擊所有目的地在市場上的所有產品總和 2020 年 12 月 1 日至 2020 年 12 月 21 日。

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

區隔查詢

除了指標以外，您也可以查詢區隔，產品 (offer_id、brand、category 等) 或所回報的屬性事件 (date，program)。系統記錄的事件是指產品。

區隔的運作方式與 SQL 中的 GROUP BY 類似。區隔選取的區隔指標，在 SELECT 子句中按每個區隔分組。下方查詢範例傳回每日點擊次數，並按加入條件遞減排序日期範圍內只有在至少一個要求指標不是零的資料列才會。

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

回應範例

下列 JSON 程式碼回應範例顯示此商家獲得 1,546 次點擊且在 2020 年 12 月 1 日當天透過所有產品及目的地放送所有產品旗下所有產品都獲得 829 次點擊 2020 年 12 月 2 日。自 2020 年 12 月 3 日起，系統不會傳回任何物件商家當天未獲得任何點擊。

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

查詢文法