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

此页面由 Cloud Translation API 翻译。

效果最大化广告系列报告

与其他广告系列类型一样，您可以使用 GoogleAdsService.SearchStream 检索效果最大化广告系列的属性和效果指标。请参阅 Google Ads API 报告指南，详细了解如何使用 Google Ads API 进行更广泛的报告。下表简要介绍了按目标整理的效果最大化广告系列报告选项。

衡量目标	关联的资源	示例
广告系列级效果	`campaign`	所有效果最大化广告系列效果
素材资源组级效果	`asset_group`	素材资源组的广告效力素材资源组效果
素材资源效果	`asset_group_asset` `asset_group_top_combination_view`	通过`asset_group_asset`报告素材资源效果效果最佳的素材资源组合
零售广告系列效果	`asset_group_product_group_view` `campaign` `shopping_performance_view`	所有零售广告系列的效果 `feed_label`的广告系列效果产品性能含购物车数据的商品推广情况含购物车数据的广告系列效果按素材资源组和产品组细分广告系列效果按产品组细分素材资源组效果产品信息组过滤条件维度性能
广告系列条件效果	`location_view`	地理位置条件效果

广告系列级效果

查看效果最大化广告系列的效果与查看任何其他广告系列类型的效果类似。但是，您必须添加一个过滤条件，以仅包含 advertising_channel_type 等于 PERFORMANCE_MAX 的广告系列。

效果最大化广告系列的所有效果

例如，以下查询会返回过去 30 天内所有效果最大化广告系列的效果。您还可以通过按 campaign.id 或 campaign.resource_name 进行过滤，将结果限制为单个广告系列。这对应于 Google Ads 界面中的效果最大化广告系列渠道素材资源报告。

SELECT
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros
FROM campaign
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'
  AND segments.date DURING LAST_30_DAYS

素材资源组一级效果

除了广告系列报告之外，您还可以为与效果最大化广告系列关联的 asset_group 资源生成报告。

素材资源组的广告效力

效果最大化广告系列会使用附加到该素材资源组的素材资源为每个素材资源组动态生成广告，因此无法查看各个广告的效果。不过，Google Ads API 提供的 asset_group.ad_strength 字段可用于评估关联的 asset_group 实体的设置是否合理，能够实现最佳广告效果。详细了解效果最大化广告系列的广告效力。

以下查询演示了如何查看所有素材资源组的广告效力。您可以在 asset_group.id 或 asset_group.resource_name 上进一步过滤此查询，以查看一个或多个特定素材资源组的广告效力。或者，您也可以如前所述添加一个 campaign 过滤条件，以比较指定广告系列中不同素材资源组的广告效力。

SELECT
  asset_group.id,
  asset_group.ad_strength
FROM asset_group
WHERE asset_group.status = 'ENABLED'

关于提升素材资源组效力的建议

Google Ads API 提供了 IMPROVE_PERFORMANCE_MAX_AD_STRENGTH 建议类型，其中突出显示了应改进以达到“极佳”强度评分的素材资源组。如果第三方广告客户支持用户创建和管理素材资源组，此功能尤其有用。

如需了解详情，请参阅优化得分和建议指南。

素材资源组效果

asset_group 资源提供了各种指标来衡量各个素材资源组的效果。以下示例查询演示了如何检索过去 7 天内指定广告系列中每个 asset_group 的效果指标。

SELECT
  asset_group.id,
  asset_group.name,
  asset_group.primary_status,
  metrics.conversions,
  metrics.conversions_value,
  metrics.cost_micros,
  metrics.clicks,
  metrics.impressions
FROM asset_group
WHERE campaign.id = CAMPAIGN_ID
  AND segments.date DURING LAST_7_DAYS

素材资源效果

您可以使用 asset_group_asset 资源获取素材资源一级的效果。

根据`asset_group_asset`提供的素材资源效果

在 asset_group_asset 资源中，performance_label 字段会根据其他同类资产对资产进行排名。如需了解详情，请参阅效果最大化广告系列的素材资源报告简介。

SELECT
  asset_group_asset.asset,
  asset_group_asset.performance_label,
  asset_group_asset.status
FROM asset_group_asset
WHERE asset_group.id = ASSET_GROUP_ID
  AND asset_group_asset.status != 'REMOVED'

效果最佳的素材资源组合

asset_group_top_combination_view 资源可用于查询素材资源组中效果最佳的素材资源组合。对应于 Google Ads 界面中的“组合”报告。例如，以下查询会生成指定 asset_group 中热门素材资源组合的列表。响应中的每一行都包含一个类型为 AssetGroupAssetCombinationData 的 asset_group_top_combination_view.asset_group_top_combinations 消息的列表。该列表中的每一项都包含相应组合中的资产列表，表示为 AssetUsage 消息。

SELECT asset_group_top_combination_view.asset_group_top_combinations
FROM asset_group_top_combination_view
WHERE asset_group.id = ASSET_GROUP_ID

再进一步，您可以调整此查询以生成数据分析，帮助您选择素材资源并更好地优化效果最大化广告系列的效果。以下查询会按素材资源组生成单个广告系列中效果最好的素材资源组合，但将结果限制为 asset_group.ad_strength 为 GOOD 或 EXCELLENT 的素材资源组。生成的素材资源组合表示广告系列中效果最佳的素材资源组中效果最佳的素材资源组合。

SELECT
  asset_group_top_combination_view.asset_group_top_combinations,
  asset_group.ad_strength,
  asset_group.id
FROM asset_group_top_combination_view
WHERE asset_group.ad_strength IN ('GOOD', 'EXCELLENT')
  AND campaign.id = CAMPAIGN_ID

零售广告系列效果

您可以通过多种方式衡量效果最大化零售广告系列，具体取决于您的报告目标。

所有零售广告系列的效果

最基本的例子是使用所有效果最大化广告系列效果示例中的方法检索所有效果最大化广告系列零售广告系列的效果。如需制作效果最大化零售广告系列，您必须使用 Merchant Center 帐号的 merchant_id 填充广告系列中的 shopping_setting 字段。将条件 campaign.shopping_setting.merchant_id IS NOT NULL 添加到 WHERE 子句可对结果集进行过滤，使其仅包含零售广告系列。

SELECT
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros
FROM campaign
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'
  AND campaign.shopping_setting.merchant_id IS NOT NULL
  AND segments.date DURING LAST_30_DAYS

`feed_label`的广告系列效果

campaign.shopping_setting.feed_label 字段可用于定位 Merchant Center 帐号中的特定产品 Feed。您可以对此字段进行过滤，以获取与特定产品 Feed 相关联的所有广告系列的报告指标。例如，以下查询演示了如何检索定位要在冬季宣传的产品的所有效果最大化广告系列的指标。

SELECT
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros
FROM campaign
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'
  AND campaign.shopping_setting.merchant_id IS NOT NULL
  AND campaign.shopping_setting.feed_label = 'WINTER-PRODUCTS'
  AND segments.date DURING LAST_30_DAYS

产品业绩

您可以使用 shopping_performance_view 检索所有效果最大化广告系列零售广告系列中的产品级指标，如下面的查询所示。按 campaign.advertising_channel_type 过滤会将结果限制为效果最大化广告系列；添加 segments.product_item_id 后，系统会自动过滤这些结果，使其仅包含零售广告系列，因为非零售广告系列没有任何关联的产品。

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'
  AND 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

含购物车数据的商品推广效果数据

零售广告客户可以访问相关的销售和利润指标，例如收入、毛利润、毛利润率和售出数量。这些指标适用于跨效果最大化广告系列实现含购物车数据的转化的所有广告客户，并且与以下报告兼容。

以下购物车数据指标可用于零售广告系列效果最大化广告系列的报告（例如 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 = 'PERFORMANCE_MAX'
  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 = 'PERFORMANCE_MAX'
  AND campaign.shopping_setting.merchant_id IS NOT NULL
  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

按素材资源组和产品组细分广告系列效果

以下示例演示了如何使用 asset_group_product_group_view 通过 asset_group 和 asset_group_listing_group_filter 检索性能指标。该示例按指定广告系列中的每个 asset_group 的产品划分树节点对结果进行细分。

SELECT
  asset_group.id,
  asset_group_listing_group_filter.id,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros
FROM asset_group_product_group_view
WHERE campaign.id = CAMPAIGN_ID
  AND segments.date DURING LAST_30_DAYS

素材资源组效果（按产品组）

或者，您也可以使用 asset_group_product_group_view 通过 asset_group_listing_group_filter 获取性能指标，但通过向 WHERE 子句添加 asset_group 过滤条件，将结果限制为单个 asset_group。

SELECT
  asset_group_listing_group_filter.id,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros
FROM asset_group_product_group_view
WHERE asset_group.id = ASSET_GROUP_ID
  AND segments.date DURING LAST_30_DAYS

产品信息组过滤条件维度效果

根据上一个示例，您可以按 asset_group_listing_group_filter 维度对性能指标进行细分。以下示例演示了如何按产品品牌检索效果指标，这是通过向 SELECT 子句添加 asset_group_listing_group_filter.case_value.product_brand.value 实现的，该子句也会自动过滤结果，使其仅包含具有产品品牌维度的 asset_group_listing_group_filter 实体。

您可以通过将 asset_group_listing_group_filter.case_value.product_brand 替换为其他维度（例如 asset_group_listing_group_filter.case_value.product_condition.condition）来执行类似的分析。

SELECT
  asset_group_listing_group_filter.case_value.product_brand.value,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros
FROM asset_group_product_group_view
WHERE asset_group.id = ASSET_GROUP_ID
  AND segments.date DURING LAST_30_DAYS

广告系列条件效果

系统只会针对受支持的条件类型填充广告系列条件报告，您可以在“制作广告系列条件”指南中找到这些类型。

地理位置条件效果

以下示例展示了如何从 location_view 报告中查询效果最大化广告系列的地理位置条件数据：

SELECT
  campaign.id,
  campaign.name,
  metrics.clicks,
  metrics.impressions,
  campaign_criterion.location.geo_target_constant
FROM location_view
WHERE campaign.status != 'REMOVED'

商品详情组

结构请求