從 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，您可以取得暢銷產品和品牌、具競爭力的價格點、特價建議，以及所屬產業的競爭情況等資料。
  • 探索您的競爭情況：您可以取得報表，瞭解產品類別層級的競爭情況，並採取行動提高曝光率。

如要將 Merchant Reports 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 要求比較範例：

Content API Merchant API
網址 https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search
ID {MERCHANT_ID} {PARENT}

方法

如要查詢 Merchant Reports API，請呼叫 ReportService.Search 方法。

觀看次數

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

MerchantPerformanceView 現已改名為 product_performance_view。

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

Content API Merchant API
MerchantPerformanceView product_performance_view
ProductView product_view
PriceCompetitivenesProductView price_competitiveness_product_view
PriceInsightsProductView price_insights_product_view
BestSellersBrandView best_sellers_brand_view
BestSellersProductClusterView best_sellers_product_cluster_view
CompetitiveVisibilityCompetitorView competitive_visibility_competitor_view
CompetitiveVisibilityTopMerchantView competitive_visibility_top_merchant_view
CompetitiveVisibilityBenchmarkView competitive_visibility_benchmark_view

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

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

Content API 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

以下是回覆範例：

Content API Merchant API 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
 
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

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

效能

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

Content API Merchant API 說明
segments.program：字串 marketing_method：字串 program 區隔會由新的 marketing_method 欄位取代。詳情請參閱「新的 marketing method 值」。
metrics.ctr：雙倍 clickThroughRate：雙倍 ctr 指標已重新命名為 clickThroughRate
metrics.conversionValueMicros：整數
segments.currencyCode：字串 		conversionValue: {
object (Price)
} 		金額 (以百萬分之一為單位) 和貨幣欄位會合併為一個 Price 類型的欄位
metrics.orders,
metrics.orderedItems,
… 		不支援 Merchant Reports API 不支援 Buy on Google 指標

新行銷方式值

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

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING 不支援

產品

Merchant Reports API 的產品檢視畫面異動如下：

Content API Merchant API 說明
productView.id：字串 id：字串 欄位格式從 channel:language:targetCountry:offerId 變更為
channel~language~feedLabel~offerId
productView.priceMicros：整數
productView.currencyCode：字串 		price: {
object (Price)
} 		金額 (以百萬分之一為單位) 和貨幣欄位會合併為一個 Price 類型的欄位
productView.aggregated_destination_status：字串 aggregated_reporting_context_status：字串 aggregated_destination_status 欄位已重新命名為 aggregated_reporting_context_status，值未變更
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		ItemIssue定義已變更
不支援 feedLabel：字串 加入 feedLabel 欄位

價格分析

Merchant Reports API 的價格分析檢視畫面異動如下：

Content API Merchant API 說明
productView.id：字串 id：字串 欄位格式從 channel:language:targetCountry:offerId 變更為 channel~language~feedLabel~offerId
productView.priceMicros：整數
productView.currencyCode：字串 		price: {
object (Price)
} 		金額 (以百萬分之一為單位) 和貨幣欄位會合併為一個 Price 類型的欄位
priceInsights.suggestedPriceMicros：整數
priceInsights.suggestedPriceCurrencyCode：字串 		suggestedPrice: {
object (Price)
} 		金額 (以百萬分之一為單位) 和貨幣欄位會合併為一個 Price 類型的欄位
priceInsights.predictedGrossProfitChangeFraction：double
priceInsights.predictedMonthlyGrossProfitChangeMicros：integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode：string 		不支援 Merchant Reports API 不支援與毛利變動相關的欄位

價格競爭力

Merchant Reports API 的價格競爭力檢視畫面異動如下：

Content API Merchant API 說明
productView.id：字串 id：字串 欄位格式從 channel:language:targetCountry:offerId 變更為 channel~language~feedLabel~offerId
productView.priceMicros：整數
productView.currencyCode：字串 		price: {
object (Price)
} 		金額 (以百萬分之一為單位) 和貨幣欄位會合併為一個 Price 類型的欄位
priceCompetitiveness.countryCode：字串 reportCountryCode：字串 countryCode 欄位已重新命名為 reportCountryCode
priceCompetitiveness.benchmarkPriceMicros：整數
priceCompetitiveness.benchmarkPriceCurrencyCode：字串 		benchmarkPrice: {
object (Price)
} 		金額 (以百萬分之一為單位) 和貨幣欄位會合併為一個 Price 類型的欄位

暢銷商品

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

Content API Merchant API 說明
bestSellers.countryCode：字串 reportCountryCode：字串 countryCode 欄位已重新命名為 reportCountryCode
bestSellers.categoryId: int reportCategoryId: int categoryId 欄位已重新命名為 reportCategoryId

競爭曝光率

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

Content API Merchant API 說明
competitiveVisibility.countryCode：字串 reportCountryCode：字串 countryCode 欄位已重新命名為 reportCountryCode
competitiveVisibility.categoryId：整數 reportCategoryId：整數 categoryId 欄位已重新命名為 reportCategoryId

上一頁
Migrate products management
下一頁
Migrate data sources management