從 Content API for Shopping 遷移報表

以下說明如何將 Merchant Reports API 與現有的 Content API for Shopping 導入作業整合。

要求

請使用下列要求網址格式來使用 Merchant Reports API：

POST https://merchantapi.googleapis.com/reports/v1beta/{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/v1beta/{PARENT}/reports:search
ID {MERCHANT_ID} {PARENT}

方法

您可以呼叫 ReportService.Search 方法，查詢 Merchant Reports API。

觀看次數

在 Merchant API 中，資料表名稱已從 CammelCase 變更為 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：double clickThroughRate：double 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: 雙精度
priceInsights.predictedMonthlyGrossProfitChangeMicros: 整數
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: 字串 		不支援 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

上一頁
遷移轉換來源管理
下一頁
遷移店面動態饋給合作夥伴管理