与其他广告类型一样,您可以使用 GoogleAdsService.SearchStream 来检索购物商品的商品状态和效果数据。
支持 Google Merchant Center Feed 中产品的广告系列具有以下专用报告:
- 购物效果视图
- 商品组视图
- 素材资源组商品组视图
- 购物商品
- “购物车数据销售情况”视图(适用于 v24 及更高版本)
“购物效果”视图
购物广告效果视图会按属性(例如 product_item_id)提供产品的汇总历史报告统计信息。
它支持所有使用 Google Merchant Center 产品 Feed 的广告系列类型,包括购物广告系列、效果最大化广告系列、需求开发广告系列、视频广告系列、应用广告系列和展示广告系列。
购物效果视图会捕获记录相关指标时商品的状态。这包括 product_title 等细分,这些细分自指标记录以来可能已发生变化。
shopping_performance_view 还支持以下细分和指标:
segments.ad_sub_network_type(也支持product_group_view和asset_group_product_group_view)。- 按转化日期细分的指标:
metrics.conversions_by_conversion_date、metrics.all_conversions_by_conversion_date、metrics.conversions_value_by_conversion_date、metrics.all_conversions_value_by_conversion_date、metrics.value_per_conversions_by_conversion_date和metrics.value_per_all_conversions_by_conversion_date。 - 竞争性展示次数份额指标:
metrics.search_budget_lost_impression_share、metrics.search_rank_lost_impression_share、metrics.search_budget_lost_absolute_top_impression_share和metrics.search_rank_lost_absolute_top_impression_share。 - 在 v24 及更高版本中提供:
segments.conversion_attribution_event_type细分和metrics.all_*购物车数据指标(用于报告所有转化中的购物车数据,包括不可用于出价的转化)。
以下是一个示例查询,用于检索 product_item_id 的产品在过去 30 天内的展示次数、点击次数、费用、转化次数和所有转化次数(按所有转化次数、转化次数、点击次数、费用和展示次数降序排序):
SELECT
segments.product_item_id,
metrics.clicks,
metrics.cost_micros,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.clicks > 0
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.cost_micros DESC,
metrics.impressions DESC
产品报告的归因逻辑
产品级报告使用特定的归因框架,以便在单个广告中展示多个产品时,将效果归因于各个产品。
财务指标
系统会计算财务指标(例如 metrics.cost_micros 和 metrics.conversions),以确保所有产品的这些指标之和不超过广告系列级报告中的相应指标。
- 直接互动
- 如果用户意图明确且与单个产品相关联(例如直接点击某个产品),则会将相关联的费用和转化功劳的 100% 归因于该特定产品。
- 间接互动
- 当用户意图针对的是整个广告时(例如,用户点击了标题、行动号召按钮或视频),相关费用和转化功劳会均匀分配给该特定广告中投放的所有商品。
互动指标
互动指标(例如 metrics.impressions 和 metrics.clicks)用于衡量特定于产品的互动情况。
对于展示,当事件发生时,系统会为广告中包含的每件产品递增计数,无论产品是否在用户的视口中可见。因此,报告中所有商品的展示次数之和可能明显高于相应的广告系列级总计。
相反,metrics.clicks 仅衡量该特定商品获得的点击次数。在 Google Ads 界面中,metrics.clicks 字段明确标记为产品点击次数。
产品组视图
“产品组视图”可提供购物商品信息组(在界面中称为产品组)的汇总报告统计信息。如需查看素材资源组产品组视图示例,请参阅效果最大化广告系列报告指南。
以下是一个示例查询,用于按广告系列检索购物广告组在过去 30 天内的展示次数、点击次数、转化次数和所有转化次数(按所有转化次数、转化次数、点击次数、展示次数降序排序):
SELECT
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.conversions,
metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.impressions > 0
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC
“购物商品”报告
购物商品报告会提供与 Google Ads 账号相关联的 Google Merchant Center 账号中商品的属性和报告统计信息。您可以使用此报告检查客户、广告系列和广告组级别的统计信息。它支持购物广告系列、效果最大化广告系列、需求开发广告系列、视频广告系列和(在 v24 及更高版本中)应用广告系列。您还可以查询 shopping_product.product_image_uri 以检索商家提供的商品图片 URI。
以下是一个示例查询,用于检索过去 30 天内所有已关联的 Google Merchant Center 账号中所有购物商品的展示次数、点击次数、转化次数和所有转化次数(按所有转化次数、转化次数、点击次数、展示次数降序排序):
SELECT
shopping_product.resource_name,
shopping_product.item_id,
shopping_product.feed_label,
shopping_product.merchant_center_id,
metrics.clicks,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC
如需详细了解查询,请参阅报告指南。
性能考虑因素
如果账号关联了大量商品,则“购物商品”报告可能会返回大量数据。以下建议可帮助您提升 GAQL 查询的性能:
- 广告系列级和广告组级查询通常比账号级查询更快,因为它们可能包含较少的产品,并且需要访问的数据也较少。
SELECT子句中的字段和指标越多,响应时间就越长。仅在查询中选择所需的字段和指标。- 存在一个或多个问题的商品会返回更多数据。您可以在
WHERE子句中使用shopping_product.status进行过滤,以了解哪些商品可能会返回导致相关状态的问题。
“购物商品”报告的常见应用场景
购物产品报告可让您灵活访问使用商品 Feed 的广告系列的商品信息。该视图可让您深入了解 Google Merchant Center 账号中商品的状态,以及广告专用信息,例如效果指标和阻止商品投放广告的问题。
本部分介绍了一些典型用例,这些用例与 Google Ads 界面中商品视图中的用例类似。
shopping_product 的 issues 字段与 Merchant API 中的 ProductStatus 类似,但添加了 Google Ads 特有的问题。
如需检查问题是否需要在 Google Merchant Center 或 Google Ads 中解决,请先检查响应的 shopping_product.issues.documentation 字段,其中包含一篇可提供帮助的帮助中心文章。
商品状态(账号级)
如果指定报告时未针对广告系列或广告组设置过滤条件,则会返回账号级的所有商品。
它支持以下类型账号中所有广告系列的指标、状态和问题:
- 购物
- 效果最大化广告系列
通过此查询,您可以查看商品的状态(例如 NOT_ELIGIBLE),以及导致该状态的特定于商品的问题列表:
SELECT
shopping_product.resource_name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
商品状态(广告系列级)
指定报告时,如果 WHERE 子句中包含广告系列资源,则会返回所选广告系列中包含的所有商品。
以下可利用商品 Feed 的广告系列类型支持此功能:
- 购物
- 效果最大化广告系列
- 需求开发广告系列
- 视频
- 应用(可在 v24 及更高版本中使用)
通过此查询,您可以查看指定广告系列中每件商品的状态,包括导致该状态的问题。例如,已暂停的广告系列会影响商品状态:
SELECT
shopping_product.resource_name,
shopping_product.campaign,
campaign.name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
WHERE
shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'
商品状态(广告组级)
在 WHERE 子句中同时指定广告组资源和广告系列资源,将返回所选广告系列中包含的所有商品。商品的指标、状态和问题反映了该商品是否包含在所选广告组中。
以下广告系列类型支持此功能:
- 购物
- 需求开发
- 视频
- 应用(适用于 v24 及更高版本;仅支持
impressions、clicks和ctr指标,不支持status或issues)
通过此查询,您可以了解商品相对于相应广告组的状态。 借助此功能,您可以确认产品组过滤条件(在广告组层级)是否正确应用,并查看每件商品的状态:
SELECT
shopping_product.resource_name,
shopping_product.campaign,
campaign.name,
shopping_product.ad_group,
ad_group.name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
WHERE
shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'
AND shopping_product.ad_group =
'customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>'
按日期过滤的产品指标(账号级)
在 WHERE 子句中指定包含日期或日期范围的报告会返回指定时间段内所有商品的账号级指标,无论这些指标是否为非零值。
您无法选择 segments.date;这样做会导致 UNSUPPORTED_DATE_SEGMENTATION 错误。
通过此查询,您可以查看指定日期或另一个兼容日期范围内每种产品的效果(汇总了所有广告系列的数据):
SELECT
shopping_product.resource_name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
metrics.clicks,
metrics.impressions,
metrics.cost_micros
FROM shopping_product
WHERE
segments.date DURING LAST_30_DAYS
含购物车数据的产品效果
零售业广告客户可以访问相关的销售和利润指标,例如收入、毛利润、毛利率和售出商品数量。所有在购物广告系列中实现含购物车数据的转化的广告客户都可以使用这些指标,并且这些指标与以下报告兼容:
ad_groupad_group_adcampaigncart_data_sales_view(在 v24 及更高版本中可用)customer(所有广告系列的汇总数据)product_group_viewshopping_performance_viewshopping_product(适用于 v24 及更高版本中的metrics.all_*购物车数据指标)
以下购物车数据指标可用于购物广告系列的报告(例如 shopping_performance_view):
metrics.average_cart_sizemetrics.average_order_value_microsmetrics.cost_of_goods_sold_microsmetrics.cross_sell_cost_of_goods_sold_microsmetrics.cross_sell_gross_profit_microsmetrics.cross_sell_revenue_microsmetrics.cross_sell_units_soldmetrics.gross_profit_marginmetrics.gross_profit_microsmetrics.lead_cost_of_goods_sold_microsmetrics.lead_gross_profit_microsmetrics.lead_revenue_microsmetrics.lead_units_soldmetrics.ordersmetrics.revenue_microsmetrics.units_sold
在 v24 及更高版本中,以下购物车数据指标也可用于报告所有转化(包括不可用于出价的转化):
metrics.all_average_cart_sizemetrics.all_average_order_value_microsmetrics.all_cost_of_goods_sold_microsmetrics.all_cross_sell_cost_of_goods_sold_microsmetrics.all_cross_sell_gross_profit_microsmetrics.all_cross_sell_revenue_microsmetrics.all_cross_sell_units_soldmetrics.all_gross_profit_marginmetrics.all_gross_profit_microsmetrics.all_lead_cost_of_goods_sold_microsmetrics.all_lead_gross_profit_microsmetrics.all_lead_revenue_microsmetrics.all_lead_units_soldmetrics.all_ordersmetrics.all_revenue_microsmetrics.all_units_sold
以下示例展示了如何使用购物车数据指标来分析过去 30 天内购物广告系列的产品级效果:
SELECT
segments.product_item_id,
segments.product_title,
metrics.average_cart_size,
metrics.average_order_value_micros,
metrics.conversions,
metrics.conversions_value,
metrics.gross_profit_micros,
metrics.gross_profit_margin,
metrics.revenue_micros,
metrics.units_sold,
campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS
AND metrics.conversions > 0
ORDER BY
metrics.gross_profit_margin DESC,
metrics.revenue_micros DESC,
metrics.conversions_value DESC
含购物车数据的广告系列效果
购物车数据指标可在广告系列一级使用,并且可以与其他效果指标(例如展示次数、点击次数和费用)结合使用:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
metrics.impressions,
metrics.clicks,
metrics.conversions,
metrics.cost_micros,
metrics.average_order_value_micros,
metrics.gross_profit_micros,
metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS
ORDER BY
metrics.gross_profit_margin DESC,
metrics.average_order_value_micros DESC,
metrics.cost_micros DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC