欢迎于 4 月 23 日上午 10:00（美国东部时间）加入我们的直播活动，届时您可以在 Google 广告和效果衡量社区服务器上的 Discord 中观看，也可以在 YouTube 上观看！我们将讨论 Google Ads API v24 中新增的功能。

报告

与其他广告类型一样，您可以使用 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

创建产品信息组