Content API for Shopping からレポートを移行する

Merchant Reports API を使用すると、提供されるデータビューを通じて、Google での商品、パフォーマンス、競合環境について知ることができます。

Merchant Reports API を使用すると、次のことができます。

  • 商品のパフォーマンスを測定する: Merchant API では、MerchantPerformanceView が product_performance_view になりました。
  • 特定フィールドで商品をフィルタする: Merchant API では、item_issues 以外のすべての利用可能なフィールドに基づいてフィルタできます。
  • 商品価格の改善: Merchant API では、金額（マイクロ単位）フィールドと通貨フィールドが Price 型の 1 つのフィールドに統合されます。
  • 市場を把握する: Merchant API を使用すると、ベストセラー商品やブランド、競合他社の価格帯、セール価格の提案、業界の競合状況に関するデータを取得できます。
  • 競合状況を把握する: 商品カテゴリレベルの競合状況を把握し、視認性の改善を図るためのレポートを取得できます。

Merchant Reports API を既存の Content API for Shopping 実装と統合する方法は次のとおりです。

リクエスト

Merchant Reports API には次のリクエスト URL 形式を使用します。

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

search リクエストの Content API for Shopping と Merchant Reports API の比較例を次に示します。

Content API Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search
識別子 {MERCHANT_ID} {PARENT}

メソッド

販売者レポート 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: double clickThroughRate: double ctr 指標の名前が clickThroughRate に変更されました
metrics.conversionValueMicros: 整数
segments.currencyCode: 文字列 		conversionValue: {
object (Price)
} 		金額マイクロ秒と通貨フィールドが Price 型の 1 つのフィールドに統合されます。
metrics.orders,
metrics.orderedItems,
… 		サポート対象外 Merchant Reports API で「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 型の 1 つのフィールドに統合されます。
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 型の 1 つのフィールドに統合されます。
priceInsights.suggestedPriceMicros: 整数
priceInsights.suggestedPriceCurrencyCode: 文字列 		suggestedPrice: {
object (Price)
} 		金額マイクロ秒と通貨フィールドが Price 型の 1 つのフィールドに統合されます。
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 型の 1 つのフィールドに統合されます。
priceCompetitiveness.countryCode: 文字列 reportCountryCode: 文字列 countryCode フィールドの名前が reportCountryCode に変更されました
priceCompetitiveness.benchmarkPriceMicros: 整数
priceCompetitiveness.benchmarkPriceCurrencyCode: 文字列 		benchmarkPrice: {
object (Price)
} 		金額マイクロ秒と通貨フィールドが Price 型の 1 つのフィールドに統合されます。

ベストセラー

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 conversion sources management
次へ
Migrate local feeds partnership management