有兴趣分享您对 Google Ads API 的反馈吗？注册即可获邀参与用户调研！

此页面由 Cloud Translation API 翻译。

报告

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

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

购物广告效果视图

购物效果视图会按product_item_id等属性为商品提供汇总的历史报告统计信息。

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

下面的查询示例会按 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

产品组视图

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

下面的查询示例会按广告系列检索购物商品详情群组的展示次数、点击次数、转化次数和所有转化次数（按所有转化次数、转化次数、点击次数、展示次数的降序排序）：

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 账号中存在的产品的属性和报告统计信息。此报告可用于检查客户、广告系列和广告组级的统计信息。

下面是一个查询示例，它会检索所有关联的 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 界面中的“产品”视图中可能的用例类似的典型用例。

购物商品的“问题”字段与 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

创建产品信息组