从 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 中的竞争洞察视图发生了以下变化：