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
了解详情
如需查看完整的细分列表,请参阅文档。