Merchant Center 自定义报告中提供的细分功能可通过向查询添加相应的字段,在 Reporting API 中实现。例如,查询 segments.program
生成的报告会为每个计划(购物广告、非付费商品详情等)生成一行,其中包括 SELECT
子句中指定的计划指标(展示次数、点击次数等)。
与 Merchant Center 中的自定义报告一样,您可以使用 Reporting API 在同一查询中指定多个细分。
以下示例查询会检索您帐号中所有商品在 30 天内的点击次数(按 program
和 offer_id
细分):
SELECT
segments.program,
segments.offer_id,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'
点击运行,在 API Explorer 中试用该示例。点击运行后,将请求网址中的商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。与 API Explorer 搭配使用时,完整查询必须保持在一行。
将此查询发送到 reports.search
的结果是一个行,指定了 offer_id
和 program
的每个组合的点击次数,如以下示例 JSON 字符串所示:
{
"results": [
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12345"
},
"metrics": {
"clicks": "38"
}
},
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12346"
},
"metrics": {
"clicks": "125"
}
},
{
"segments": {
"program": "FREE_PRODUCT_LISTING",
"offerId": "12346"
},
"metrics": {
"clicks": "23"
}
},
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12347"
},
"metrics": {
"clicks": "8"
}
},
{
"segments": {
"program": "FREE_PRODUCT_LISTING",
"offerId": "12347"
},
"metrics": {
"clicks": "3"
}
}
]
}
类别和产品类型
Merchant Center 查询语言支持按两组属性对指标进行细分,您可以定义这两组属性来整理商品目录:
- 类别级别(
segments.category_l1
、segments.category_l2
等) - Google 商品类目中的类别。如果未提供任何类别,Google 可能会自动为您的商品分配类别,或者进一步优化提供的类别。
- 产品类型级别(
segments.product_type_l1
、segments.product_type_l2
等) - 您根据分类分配的商品类型。与类别级别不同的是,类别级别不存在预定义的一组支持值。
“类别”属性和“商品类型”属性都按照包含多个层级的层次结构进行组织。产品规范使用 >
字符分隔每个级别,但您可以在报告中单独选择层次结构的每个级别。
例如,假设某个产品具有以下产品类型级别:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
报告将在自己的字段中返回各个级别,如下所示:
分割部分 | 价值 |
---|---|
segments.product_type_l1 |
Home & Garden |
segments.product_type_l2 |
Kitchen & Dining |
segments.product_type_l3 |
Kitchen Appliances |
segments.product_type_l4 |
Refrigerators |
货币和价格指标
ReportRow
的 segments.currency_code
字段指示返回价格指标(例如 metrics.conversion_value_micros
)所使用的币种。由于这对于正确解读这些指标很重要,因此无论您何时选择下面的某个价格指标,返回的 ReportRow
都会自动包含 segments.currency_code
。
metrics.conversion_value_micros
metrics.aov_micros
metrics.ordered_item_sales_micros
metrics.returns_micros
metrics.shipped_item_sales_micros
Google 易购指标
Merchant Center 查询语言支持 Google 易购订单的两类指标:商品级指标和订单级指标。
- 商品级指标
根据订单中的商品计算得出的指标,与每个订单中商品的产品维度相关联。
metrics.item_days_to_ship
metrics.item_fill_rate
metrics.ordered_items
metrics.ordered_item_sales_micros
metrics.rejected_items
metrics.returned_items
metrics.return_rate
metrics.returns_micros
metrics.shipped_items
metrics.shipped_item_sales_micros
metrics.unshipped_items
- 订单级指标
按订单计算的指标。
metrics.aos
metrics.aov_micros
metrics.days_to_ship
metrics.orders
metrics.shipped_orders
metrics.unshipped_orders
订单级指标与每个订单中商品的产品尺寸没有关联。
您可以选择商品级指标以及任何可用的细分。 但是,如果选择订单级指标与以下任意产品维度细分,则会失败:
segments.brand
segments.category_l1
、segments.category_l2
、segments.category_l3
、segments.category_l4
、segments.category_l5
segments.custom_label1
、segments.custom_label2
、segments.custom_label3
、segments.custom_label4
、segments.custom_label5
segments.offer_id
segments.product_type_l1
、segments.product_type_l2
、segments.product_type_l3
、segments.product_type_l4
、segments.product_type_l5
segments.title
了解详情
如需查看细分的完整列表,请参阅文档。