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 の比較例を次に示します。

メソッド

販売者レポート API をクエリするには、ReportService.Search メソッドを呼び出します。

視聴回数

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 の競合視認性ビューの変更点は次のとおりです。