Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

购物广告的产品报告

与其他广告类型一样，您可以使用 GoogleAdsService.SearchStream 检索购物广告中宣传的商品的状态和效果数据。

支持 Google Merchant Center Feed 中的产品的广告系列具有以下专用报告：

购物效果视图
产品组视图
素材资源组产品组视图
购物产品
购物车数据销售视图（在 v24 及更高版本中提供）
最终到达网址扩展素材资源视图（适用于 v26 及更高版本中的购物广告系列）

此外，从 v26 开始，在购物广告系列中，如果启用了 AI Max (campaign.ai_max_setting.enable_ai_max = true) 和最终到达网址扩展 (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN)，final_url_expansion_asset_view 会报告投放的文案适配素材资源。如需了解查询要求和示例，请参阅最终到达网址扩展素材资源视图部分。

购物效果视图

购物效果视图按 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_* 购物车数据指标（用于报告所有转化 [包括不可用于出价的转化] 的购物车数据）。

以下是一个示例查询，用于检索过去 30 天内有点击次数的商品的展示次数、点击次数、费用、转化次数和所有转化次数（按 product_item_id 分组，并按所有转化次数、转化次数、点击次数、费用、展示次数的顺序降序排序）：

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。

以下示例查询会检索所有关联的 Google Merchant Center 账号中所有购物产品过去 30 天的展示次数、点击次数、转化次数和所有转化次数（按所有转化次数、转化次数、点击次数、展示次数的降序排序）：

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_group
ad_group_ad
campaign
cart_data_sales_view（在 v24 及更高版本中可用）
customer（所有广告系列的汇总数据）
product_group_view
shopping_performance_view
shopping_product（适用于 v24 及更高版本中的 metrics.all_* 购物车数据指标）

以下购物车数据指标可用于购物广告系列的报告（例如 shopping_performance_view）中：

metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold

在 v24 及更高版本中，以下购物车数据指标也可用于报告所有转化（包括不可出价的转化）：

以下示例展示了如何使用购物车数据指标来分析过去 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

最终到达网址扩展素材资源视图

从 v26 开始，当 AI Max (campaign.ai_max_setting.enable_ai_max = true) 和最终到达网址扩展 (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) 处于启用状态时，您可以使用 final_url_expansion_asset_view 衡量购物广告系列中文案适配素材资源的素材资源级效果。

查询 final_url_expansion_asset_view 时，请遵循以下过滤和字段选择规则：

对 final_url_expansion_asset_view 的查询必须至少过滤 campaign.advertising_channel_type、campaign（campaign.id、campaign.resource_name 或 final_url_expansion_asset_view.campaign）或 ad_group（ad_group.id、ad_group.resource_name 或 final_url_expansion_asset_view.ad_group）中的一个；如果省略所有这些字段，则会返回 FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER。
在账号或广告系列一级查询购物广告系列的 final_url_expansion_asset_view 时，您必须按 campaign.advertising_channel_type = 'SHOPPING' 进行过滤（或使用 = 按单个广告组进行过滤）。按广告系列（campaign.id、campaign.resource_name 或 final_url_expansion_asset_view.campaign）进行过滤也需要 campaign.advertising_channel_type = 'SHOPPING'；如果省略，则会返回 FinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER，而按单个 ad_group 进行过滤本身即可满足过滤要求。
针对 campaign.advertising_channel_type、campaign 或 ad_group 的过滤条件必须对单个值使用 = 运算符；对同一资源类型使用 IN 或多个条件会返回 FinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE。
对于购物广告系列，您可以选择 ad_group 字段并按其进行过滤，但无法选择 asset_group 字段。在购物广告系列中选择 asset_group 字段（或按 ad_group 过滤）会返回 FinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP（如果还选择了 ad_group 字段，则会返回 CANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP）。在选择 ad_group 字段时按 asset_group 过滤会返回 CANNOT_SELECT_AD_GROUP，同时按 ad_group 和 asset_group 过滤会返回 CANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP。

以下查询会检索过去 30 天内购物广告系列的素材资源级效果指标：

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  final_url_expansion_asset_view.asset,
  final_url_expansion_asset_view.field_type,
  final_url_expansion_asset_view.final_url,
  final_url_expansion_asset_view.status,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions
FROM final_url_expansion_asset_view
WHERE
  campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS

创建商品详情组