报告

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

支持商品的广告系列具有以下专用报告：

购物广告效果视图

“购物广告效果视图”按属性（例如 product_item_id）提供产品的汇总历史报告统计信息。

“购物效果”视图会捕获记录相关指标时商品的状态。这包括 product_title 等细分，这些细分可能自指标记录以来发生了变化。

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

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  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,
  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

产品组视图

产品组视图可提供商品详情组（在界面中称为产品组）的汇总报告统计信息。如需查看示例，请参阅效果最大化广告系列报告指南中的素材资源组产品组视图。

以下是一个查询示例，该查询会检索过去 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 账号中存在的产品对应的属性和报告统计信息。您可以使用此报告检查客户、广告系列和广告组级别的统计信息。

以下是一个查询示例，用于检索过去 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 界面中“产品”视图中可能出现的用例类似。

购物商品的“问题”字段与 Content API for Shopping 中的 productstatuses 提供的字段类似，但还添加了 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：

  • 购物
  • 效果最大化广告系列
  • 需求开发广告系列
  • 视频

通过此查询，您可以查看指定广告系列中包含的商品的状态。 借助此页面，您可以查看每件商品的状态，包括导致该状态的问题。例如，已暂停的广告系列会影响商品状态：

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 子句中同时指定广告组资源和广告系列资源，将返回所选广告系列中包含的所有商品。商品的指标、状态和问题将反映该商品是否包含在所选广告组中。

通过此查询，您可以了解商品相对于相应广告组的状态。 借助此功能，您可以确认产品组过滤条件（在广告组层级）是否正确应用，并查看每件产品的状态：

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 = '2024-01-01'

含购物车数据的产品效果报告

零售业广告客户可以查看相关销售和利润指标，例如收入、毛利润、毛利率和售出件数。 所有在购物广告系列中实现含购物车数据的转化的广告客户都可以使用这些指标，并且这些指标与以下报告兼容。

以下购物车数据指标可用于报告（例如 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

以下示例展示了如何使用购物车数据指标来分析过去 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
上一页
创建产品信息组