2026 年 1 月 29 日，星期四
继昨天发布 Google Ads API v23 之后，我们很高兴能分享有关其中一项最受期待的功能的更多详细信息：效果最大化广告系列的渠道级报告。
此次更新为开发者和广告客户提供了前所未有的透明度，让他们能够清楚了解效果最大化广告系列广告的投放位置，从而进行更深入的优化并获得更精细的效果分析。
通过渠道细分提高透明度
从 v23 开始，您现在可以检索按渠道（例如 Google 搜索、搜索网络合作伙伴、Gmail、YouTube、展示广告网络、Google 探索和 Google 地图）细分的广告效果数据。此功能可在广告系列、素材资源组和素材资源一级使用，让您能够了解特定广告素材资源在不同环境中的效果。
在以前版本的 API 中，对效果最大化广告系列使用 ad_network_type 细分通常会返回 MIXED 枚举值。随着 v23 的发布，API 现在将返回具体的渠道细分数据。
开发者须知：这是一项重大行为变更。将查询升级到 v23 后，您会看到比之前版本更详细的结果。请确保您的报告系统已准备好处理这些特定的枚举值，而不是通用的 MIXED 结果。
可考虑的其他细分
虽然渠道细分是 v23 中的新功能，但它可与 v22 中引入的强大细分字段 ad_using_product_data 和 ad_using_video 搭配使用。
ad_using_product_data：使用此细分可区分使用 Merchant Center 商品 Feed 的广告与未使用该 Feed 的广告的效果。ad_using_video：此细分可让您单独查看包含视频组件的广告展示的效果数据。
通过将这些细分维度与新的 v23 渠道报告相结合，您现在可以获得高度具体的分析洞见，例如了解视频广告在 YouTube 频道与展示广告网络中的具体转化价值。如果您是零售商，则可以使用 ad_using_product_data 细分，查看搜索网络上的购物广告、展示广告网络上的动态再营销广告以及在 YouTube 上展示产品的视频广告的数据。
实现细节
如需开始使用这些新的报告功能，您应将客户端库更新到 v23。您可以在我们的效果最大化广告系列报告指南中找到详细的技术文档和查询示例。
重要注意事项：
- 效果报告仅会返回 2025 年 6 月 1 日及之后日期的渠道级数据。
- 虽然您可以通过 API 在广告系列、素材资源组和素材资源级别获取渠道报告，但素材资源组级别的报告仅可通过 API 获取，无法在 Google Ads 网页界面中查看。
如果您有任何疑问或想讨论此帖子，请联系 Google Ads API 支持团队，或在我们的“Google 广告和效果衡量社区”Discord 服务器上发起讨论。