從 Content API for Shopping 遷移報表

你可以透過 Merchant Reports API 提供的資料檢視畫面，瞭解 Google 上的產品、產品成效和競爭環境。

你可以使用 Merchant Reports API 執行下列操作：

• 評估產品成效： 在 Merchant API 中，MerchantPerformanceView 現在是 product_performance_view。
• 依特定欄位篩選產品： 透過 Merchant API，你可以根據所有可用欄位進行篩選，但 item_issues 除外。
• 改善產品價格： 透過 Merchant API，金額 (以百萬分之一為單位) 和幣別欄位會合併為一個欄位，並採用 Price 類型。
• 瞭解市場： 透過 Merchant API，你可以取得暢銷產品和品牌、 具競爭力的價格點、建議的特價價格，以及所屬產業的 競爭情況資訊。
• 掌握競爭情況： 你可以取得報表，瞭解產品類別層級的競爭情況，並採取行動提高曝光率。

以下說明如何將商家報表 API 與現有的 Content API for Shopping 實作項目整合。

要求

Merchant Reports API 的要求網址格式如下：

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

以下是 Content API for Shopping 與 Merchant Reports API search 要求比較的範例：

方法

你可以呼叫 ReportService.Search 方法，查詢商家報表 API。

觀看次數

在 Merchant API 中，資料表名稱已從 CamelCase 變更為 snake_case。

MerchantPerformanceView 現已改名為 product_performance_view。

以下是 Content API for Shopping 和 Merchant API 中的資料表名稱對應：

在 Merchant API 中，不再需要指定欄位前置字元，例如 segments.offer_id。請改用欄位名稱 offer_id。

以下是 Content API for Shopping 和 Merchant API 中查詢的比較範例：

   SELECT
     segments.offer_id,
     metrics.clicks
   FROM MerchantPerformanceView
   WHERE segments.date DURING LAST_7_DAYS
   

   SELECT
     offer_id,
     clicks
   FROM product_performance_view
   WHERE date DURING LAST_7_DAYS
   

回覆範例如下：

{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

資料表名稱可用做欄位前置字串。舉例來說，Merchant API 查詢可接受 offer_id 和 product_performance_view.offer_id。

成效

Merchant Reports API 的成效檢視畫面異動如下：

新的行銷方式值

以下是 segments.program 和 marketing_method 值的對應關係：

產品

Merchant Reports API 中的產品檢視畫面有以下異動：

價格分析

以下是 Merchant Reports API 中價格洞察檢視畫面的異動內容：

價格競爭力

以下是 Merchant Reports API 中價格競爭力檢視畫面的異動內容：

暢銷商品

Merchant Reports API 的暢銷商品檢視畫面有以下異動：

競爭曝光率

Merchant Reports API 中的競爭曝光率檢視畫面有以下異動：