与其他广告类型一样,您可以使用
GoogleAdsService.SearchStream
至
检索 Google 购物产品的产品状态和效果数据。
为产品提供支持的广告系列具有以下专用报告:
。购物广告效果视图
购物效果视图提供
按属性(如
product_item_id
。
“购物效果视图”显示的是 相关指标都会得到记录。这包括 product_title、 可能在系统记录指标后发生了变化。
下面是一个检索展示次数、点击次数、费用、转化次数的示例查询
以及过去 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
产品组视图
产品组视图提供经过汇总的 购物清单的报告统计信息 groups(称为产品 群组)。请参阅效果最大化广告系列报告指南,了解 素材资源组的产品组视图 示例。
下面是一个检索展示次数、点击次数、转化次数和 按广告系列在购物信息组中获得的所有转化次数(在 过去 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 中的所有 Google 购物商品 账号:
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 中的商品状态 还可以查看效果指标 以及导致产品无法投放广告的问题
本部分介绍的一些典型用例与 “产品”视图。
“问题”与
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