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

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

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

• 商品のパフォーマンスを測定する: Merchant API では、MerchantPerformanceView が product_performance_view になりました。
• 特定の商品をフィルタする: Merchant API では、 を除くすべての利用可能なフィールドに基づいてフィルタできます。item_issues
• 商品の価格設定を改善する: Merchant API では、金額マイクロと通貨のフィールドが 1 つのフィールドに統合されました タイプ Price。
• 市場を把握する: 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 の比較例を次に示します。

メソッド

ReportService.Search メソッドを呼び出すことで、Merchant Reports 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 の競合視認性ビューの変更点は次のとおりです。