立即报名参加将于 7 月 17 日举办的效果最大化广告系列和 Google Ads API 研讨会！

此页面由 Cloud Translation API 翻译。

报告

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

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

购物广告效果视图

购物效果视图可按 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

产品组视图

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

下面是一个查询示例，该查询按过去 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 帐号中的产品提供属性和报告统计信息。此报告可用于检查客户、广告系列和广告组级别的统计信息。

以下示例查询检索所有关联的 Google Merchant Center 帐号中所有 Google 购物商品在过去 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”字段类似于 Content API for Shopping 中 productstatuses 提供的字段，只是增加了 Google Ads 特有的问题。如需检查问题是否需要在 Google Merchant Center 或 Google Ads 中解决，请先检查响应的 shopping_product.issues.documentation 字段，其中包含可提供帮助的帮助中心文章。

产品状态（账号级别）

如果为广告系列或广告组指定不带过滤条件的报告，系统将返回帐号一级的所有产品。

它支持以下类型的帐号中所有广告系列的指标、状态和问题：

Shopping
效果最大化广告系列

通过此查询，您可以查看商品的状态（例如 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：

Shopping
效果最大化广告系列
需求开发
视频

通过此查询，您可以查看指定广告系列中包含的产品的状态。它可让您检查每个产品的状态，包括导致状态的问题。例如，已暂停的广告系列会影响产品状态：

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

创建产品信息组