如需讨论我们的产品并提供反馈，请加入 Google 广告和衡量社区服务器中的官方 Google Ads Discord 频道。

此页面由 Cloud Translation API 翻译。

效果最大化广告系列报告

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

效果衡量目标	关联的资源	示例
广告系列级效果和展示位置	`campaign` `performance_max_placement_view`	所有效果最大化广告系列的效果效果最大化广告系列展示位置
素材资源组级效果	`asset_group`	素材资源组广告效力素材资源组效果
素材资源效果	`asset_group_asset` `asset_group_top_combination_view`	`asset_group_asset` 的素材资源效果效果最佳的素材资源组合
零售广告系列效果	`asset_group_product_group_view` `campaign` `shopping_performance_view`	所有零售广告系列的效果 `feed_label` 的广告系列效果商品表现含购物车数据的产品效果含购物车数据的广告系列效果按素材资源组和产品组划分的广告系列效果按商品组划分的素材资源组效果 Product Information Group Filter 维度效果
广告系列条件效果	`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

效果最大化广告系列展示位置

performance_max_placement_view 会显示效果最大化广告系列的展示位置展示次数指标，以便您深入了解广告系列的广告在哪些位置展示。以下查询演示了如何检索特定效果最大化广告系列在过去 30 天内的展示次数（按展示位置）。

SELECT
  performance_max_placement_view.display_name,
  performance_max_placement_view.placement,
  performance_max_placement_view.placement_type,
  performance_max_placement_view.target_url,
  metrics.impressions,
  campaign.id
FROM performance_max_placement_view
WHERE
  campaign.id = CAMPAIGN_ID
  AND segments.date DURING LAST_30_DAYS

素材资源组级效果

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

素材资源组广告效力

由于效果最大化广告系列会使用附加到每个素材资源组的素材资源为每个素材资源组动态生成广告，因此无法查看各个广告的效果。不过，Google Ads API 会公开 asset_group.ad_strength 字段和 asset_coverage 报告字段，以评估关联的 asset_group 实体在实现最佳广告效果方面的设置效果。详细了解效果最大化广告系列的广告效力。

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

SELECT
  asset_group.id,
  asset_group.ad_strength
  asset_group.asset_coverage
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

零售广告系列效果

您可以根据自己的报告目标，通过多种方式衡量零售类效果最大化广告系列的效果。

所有零售广告系列的效果

最基本的示例是，使用所有效果最大化广告系列效果示例中的方法检索所有效果最大化零售广告系列的效果。若要制作效果最大化零售广告系列，您必须在广告系列的 shopping_setting 字段中填写 Merchant Center 账号的 merchant_id。然后，将条件 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 维度细分效果指标。以下示例演示了如何按产品品牌检索效果指标，具体方法是将 asset_group_listing_group_filter.case_value.product_brand.value 添加到 SELECT 子句中，这还会自动过滤结果，使其仅包含具有产品品牌维度的 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'

发掘市场机会

效果最大化广告系列报告的主要用途之一是发掘可为您的广告系列和业务带来益处的市场机会。请观看以下视频，了解有关使用 PMax 报告来发掘市场机会的一些示例和指南。

最佳做法

在 Google Ads API 中为效果最大化广告系列生成报告时，我们建议您遵循以下最佳实践。其中包括：

有效使用 API。
使用建议优化广告系列。
查看实时数据，而不仅仅是历史报告数据。
添加尽可能多的素材资源（但不要超出每种素材资源类型的限制），然后等待 Google Ads 为您进行优化。

如需详细了解每种最佳实践，请观看以下视频。

商品详情组

结构请求