衡量性能

您可以使用 Reports 服务检索 效果 指标 您账号。

如需查看可用指标的完整列表,请参阅 metrics 文档。

要求

您需要具有“报告管理员 ”角色才能检索此报告。

如需为账号授予“报告管理员”角色,请使用 accounts.update 将 reportingManager 字段设置为 true。“报告管理员”角色相当于 Merchant Center 中的“效果和洞察”角色。

accounts.update 会替换整个 Account 资源。请使用 accounts.get 获取完整的 Account 资源,然后在 accounts.update 请求中提供所有字段,以免丢失信息。

示例查询

以下查询检索您账号中所有产品在特定 30 天内的 impressions、clicks 和 ctr。如需发出请求, 请将以下 Merchant Center 查询语言语句传递给 reports.search 方法:

SELECT
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'

运行

点击运行 ,即可在 API Explorer 中试用该示例。点击 运行后,请在 请求网址中将商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保留在一行中,才能与 API Explorer 搭配使用。

您还可以对查询中的指标进行细分,以获取更精细的效果报告。

如需了解如何使用 Reports 服务检索和过滤产品,请参阅产品指南。