从 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 请求对比示例：

方法

您可以通过调用 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 中竞争对手的曝光度视图发生了以下变化：