跨境行业技术赋能！谷歌广告API V23上线，助你广告效果全面提升。

谷歌广告API发布V23版本，跨境行业迎来新一轮技术赋能。在2026年伊始，谷歌广告平台加速了API的更新迭代步伐，推出了V23版本。此版本被定位为一次重大升级，包含了数十项功能改进，尤其在效果最大化（Performance Max）广告系列的报告数据细分、激励机制、报告功能及转化控制等方面实现了显著增强。这些更新为全球范围内的广告主，特别是深耕跨境领域的中国企业，提供了更为精细化的管理工具与更深层次的数据洞察。

此次版本迭代的加速，体现了谷歌在数字广告领域持续创新、响应市场需求的决心。回顾过去一年，从2025年10月的V22版本，到2025年8月的V21、6月的V20，再到2025年4月的V19.1和2月的V19，以及2024年的V18、V17.1、V17.0、V16.1和V16等，谷歌广告API始终保持着快速的更新节奏，不断为开发者和广告主提供最新的功能支持与技术接口，以适应不断变化的广告生态系统。

广告管理功能全面优化

在广告管理方面，V23版本引入了多项重要调整，旨在提升广告发布的规范性与灵活性。首先，AdGroupAdErrorEnum中新增的AD_SHARING_NOT_ALLOWED错误代码明确指出，不同广告组之间不再支持共享广告，这一变化要求广告主在创建广告时更加注重广告组的独立性与针对性。同时，AdFormatType新增了TEXT（文本广告）、VERTICAL_ADS_BOOKING_LINK（垂直行业预订链接广告）和VERTICAL_ADS_PROMOTION（垂直行业推广广告）等格式，这些新格式的加入，为广告主提供了更多元的广告创意空间，特别是针对特定垂直行业如旅游、住宿等，能够更精准地触达目标受众。此外，V23版本移除了对CallAd（来电广告）和CallAdInfo的支持，意味着广告主需要转向其他广告形式来引导用户进行电话联系，或通过站内转化路径实现同等效果。

资产与创意表现洞察深化

V23版本在资产管理与创意表现报告方面进行了显著增强。asset_group报告新增了metrics.engagements（互动次数）、metrics.engagement_rate（互动率）和metrics.average_cpe（平均每次互动成本）等指标，使广告主能更全面地评估资产组的整体表现与用户吸引力。asset_group_asset报告也增加了metrics.average_cpe、metrics.average_cpm（平均千次展示成本）、metrics.trueview_average_cpv（TrueView平均每次观看费用）、metrics.video_trueview_view_rate（视频TrueView观看率）和metrics.video_trueview_views（视频TrueView观看次数）以及metrics.interaction_event_types（互动事件类型）等指标，为广告主分析具体资产（如图片、视频）在不同维度下的表现提供了详尽数据。Asset中新增了图片和视频资产的只读字段orientation（方向），这对于自适应广告创意尤为重要，有助于确保不同设备上的展示效果。此外，V23版本现在支持通过field_type为HEADLINE和DESCRIPTION来检索CampaignAsset，提升了广告文案资产管理的效率。新的ServedAssetFieldType中增加了HEADLINE_AS_SITELINK_POSITION_ONE等四个字段，用于识别作为附加链接展示的标题和描述，优化了附加信息组件的报告能力。商业信息资产也得到了更新，以提供更优质的服务。

财务与发票管理精细化

在财务管理方面，V23版本通过InvoiceService.ListInvoices方法，允许在发票中返回更精细的详细信息。通过设置ListInvoicesRequest中的include_granular_level_invoice_details字段，广告主现在可以获取包括营销活动层面的成本细分、逐项列出的监管费用以及调整信息。同时，RegulatoryFeeTypeEnum和UnitOfMeasureEnum的加入，进一步提升了财务报告的准确性和透明度。新媒网跨境认为，这项功能对于大型企业和代理机构进行成本核算、预算分配以及合规性管理具有重要意义，尤其在全球化运营中，能够有效应对复杂的税务与法规要求。

营销活动设置与灵活性提升

营销活动（Campaigns）的设置也变得更加严谨和灵活。CampaignError中新增了DURATION_TOO_LONG_FOR_TOTAL_BUDGET（总预算过大导致时长过长）和END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET（总预算必须设置结束日期时间）错误代码，旨在规范营销活动的预算与时间管理，避免潜在的配置错误。更值得注意的是，Campaign.start_date_time和Campaign.end_date_time字段现在取代了之前的Campaign.start_date和Campaign.end_date，允许针对特定营销活动类型指定精确的时间组件。这项改动为广告主提供了更高的时间精度，对于开展全球性、跨时区或具有严格时间限制的营销活动而言，能够实现更精准的投放与管理。

转化追踪与归因深化

在转化追踪方面，V23版本在ConversionActionCategory中新增了YOUTUBE_FOLLOW_ON_VIEWS，以支持追踪用户在观看广告后，是否进一步观看了同一YouTube频道上的其他视频。此项更新意味着，广告主现在可以捕捉更深层次的用户互动行为，而不仅仅局限于首次点击或观看。这种对后续观看行为的追踪，有助于广告主更全面地评估视频广告的品牌影响力与用户参与度，从而优化其内容策略与转化路径，尤其对于以品牌建设和长效用户关系培养为目标的跨境电商企业，其价值不言而喻。

需求挖掘广告与伴随元素

在需求挖掘（Demand Gen）广告方面，V23版本新增了DemandGenVideoResponsiveAdInfo.companion_banner字段，允许视频响应式广告配置伴随横幅。伴随横幅可以在视频播放时同步展示，提供额外的视觉信息或行动号召，从而增强广告的吸引力和转化潜力。同时，DemandGenMultiAssetAdInfo中移除了lead_form_only字段，这可能意味着需求挖掘多素材广告在引导潜在客户方面，将不再局限于单一的表单提交形式，而会支持更多样化的互动方式。

激励机制与伙伴合作深化

新媒网跨境获悉，V23版本首次支持了“选择你自己的（CYO）”激励措施，这是谷歌广告API一项重要的战略性更新。此功能允许合作伙伴以程序化的方式，为客户获取并应用谷歌广告激励。
具体而言：

1. FetchIncentive方法允许基于国家、语言以及可选的用户电子邮件，为用户获取可用的激励措施。这可以返回个性化的CYO激励选项。
2. ApplyIncentive方法允许将用户选择的激励措施应用于特定的谷歌广告客户账户。
   此外，新增了只读资源AppliedIncentive，可通过GoogleAdsService.Search和GoogleAdsService.SearchStream进行查询，它提供了已兑换激励措施的详细信息，包括状态、完成进度、奖励金额和相关日期。IncentiveErrorEnum中也新增了错误代码，以处理激励措施获取或应用过程中出现的问题。AuthenticationErrorEnum中增加了INVALID_EMAIL_ADDRESS。这些更新显著提升了合作伙伴管理客户激励活动的效率和透明度，对于代理商或多账户管理者而言，可以更系统地利用谷歌提供的激励政策，从而优化客户的广告投入回报。

规划与洞察工具全面升级

V23版本在规划（Planning）和洞察工具方面进行了全面升级，大量引入了人工智能（AI）驱动的功能，旨在提供更智能、更精准的营销策略支持。

1. AudienceInsightsDimension新增了LIFE_EVENT_USER_INTEREST，允许用户利用“生活事件”维度构建受众，例如针对新婚夫妇、新搬迁用户等，实现更为精细化的目标受众定位。
2. ReachPlanService.GenerateConversionRates的响应现在包含“展示面”（surfaces），允许根据不同的展示面控制（例如Gmail、Shorts）提供不同的转化率建议，目前仅支持需求挖掘营销活动。这有助于广告主更精准地评估和规划不同平台上的广告效果。
3. YouTubeChannelInsights新增了LanguageDistribution，提供了YouTube频道内容的语言分布情况，对开展多语言营销的广告主具有参考价值。
4. 新增了BenchmarksService，用于将YouTube广告数据与行业基准进行比较，帮助广告主了解自身表现并发现改进空间。
5. AudienceInsightsService.GenerateAudienceDefinition利用生成式AI技术，能够将目标受众的自由文本描述翻译成匹配的受众属性，极大地简化了受众构建流程，降低了专业门槛。
6. YouTubeChannelInsights新增了relevance_score，评估创作者对于某一主题的相关性，并根据观看次数进行加权，为网红营销和内容合作提供了更科学的评估依据。
7. TrendInsightMetrics新增了trend_change_percent，表示趋势值在比较周期内的百分比变化，有助于广告主及时捕捉市场热点和消费者兴趣变化。

推荐系统智能化提升

在推荐（Recommendations）方面，V23版本在GenerateRecommendationsRequest中新增了is_new_customer字段。当此字段为真时，针对类型为CAMPAIGN_BUDGET的推荐，系统将使用为新客户量身定制的模型生成推荐。此功能特别推荐给那些尚未创建任何营销活动的客户。这意味着谷歌的推荐系统将更加智能地为新进入者提供启动指导，帮助他们根据最佳实践配置初始预算，从而降低新广告主的入门难度，并提升其首次广告体验的成功率。

报告与数据分析能力增强

V23版本对报告功能进行了多维度增强，提供了更细致的数据洞察：

1. AdGroupAdAssetView和AdGroupAdAssetCombinationView现在支持响应式展示广告（RESPONSIVE_DISPLAY_AD）的展示次数、表现和转化指标。
2. 新增了ad_sub_network_type细分，用于在广告网络内部进行更细粒度的效果分解。初始阶段，此细分适用于YouTube上的需求挖掘营销活动（插播广告、信息流广告、Shorts）。选择此细分时，必须同时选择ad_network_type。
3. 效果最大化营销活动（Performance Max campaigns）现在启用了广告网络类型细分。这是备受广告主期待的一项功能，它允许广告主更清晰地了解效果最大化营销活动在谷歌各广告网络（如搜索、展示、YouTube、发现等）中的具体表现，从而更好地理解其自动化策略和资源分配。
4. UserLocationView和GeographicView现在支持按转化日期细分的指标，有助于更准确地进行归因分析。
5. 针对垂直行业广告新增了细分。
6. 新增了PerStoreView，用于查询门店位置详情。
7. 新增了MatchedLocationInterestView，适用于AI Max营销活动，提供用户兴趣所在地理位置的表现指标。
8. 移除了聚合资产表现标签指标。搜索和展示广告不再返回表现标签枚举。这些变化共同为广告主提供了更深入、更灵活的报告工具，有助于其进行数据驱动的决策。

购物广告功能拓展与竞争洞察

购物（Shopping）广告功能在V23版本中也得到进一步拓展。ShoppingPerformanceView现在支持按转化日期细分的多种转化指标，包括conversions_by_conversion_date（按转化日期计算的转化次数）、all_conversions_by_conversion_date（按转化日期计算的所有转化次数）等，这些指标对于电商广告主进行准确的业绩评估和归因分析至关重要。
此外，ShoppingPerformanceView新增了多项竞争指标，如search_budget_lost_impression_share（因预算丢失的搜索展示份额）、search_rank_lost_impression_share（因排名丢失的搜索展示份额）等。新媒网跨境了解到，这些指标能够帮助购物广告主深入了解其在搜索结果中的可见性，以及与竞争对手相比的市场份额表现，从而优化预算分配和竞价策略，提升市场竞争力。ShoppingProduct中新增的product_image_uri字段，则为产品信息管理提供了便利。

垂直行业广告与视频广告更新

垂直行业广告（Vertical ads）得到了特别增强，以更好地服务特定领域。

1. 针对使用旅行数据源的搜索营销活动，AdGroup中新增了vertical_ads_format_setting，允许控制可投放的广告格式。
2. AdGroupCriterion中新增了vertical_ads_item_group_rule_list条件类型。
3. SharedCriterion中新增了vertical_ads_item_group_rule。这些条件允许以旅行数据源中的特定商品组作为定位目标，实现更精准的广告投放。
4. 现在可以将垂直行业广告数据源连接到运行AI Max的搜索营销活动，使其能够与文本广告一同展示房产推广和预订链接旅行广告。在广告组层面，广告主可以通过vertical_ads_format_setting控制展示的格式，并定义一组商品组规则以定位垂直行业广告数据源中的实体子集。
5. 报告功能现在可以按AdFormatType和垂直行业广告数据源中的维度进行细分，提供更全面的效果分析。

视频（Video）广告也获得了更新。

1. AdVideoAssetInfo中新增了ad_video_asset_feature_control字段。
2. CampaignCriterionError中新增了INVALID_VIDEO_LINEUP_ID错误代码。
3. YouTube音频广告引入了可听度指标（audibility metrics），报告广告是否可听以及有多少展示能够衡量可听度。这项指标对于评估音频广告的实际效果至关重要，确保广告主支付的费用能够真正带来有效的曝光和用户感知。

总结来看，谷歌广告API v23版本体现了谷歌持续深化数字广告平台智能化、精细化管理的战略方向。从更细致的报告数据、更灵活的广告管理，到人工智能驱动的规划工具和精准的转化追踪，这些更新旨在赋能全球广告主，特别是广大的中国跨境电商企业，在日益复杂的全球市场中，能够更高效地制定策略、优化投放，并最终实现更高的投资回报率。

新媒网（公号: 新媒网跨境发布），是一个专业的跨境电商、游戏、支付、贸易和广告社区平台，为百万跨境人传递最新的海外淘金精准资讯情报。

本文来源：新媒网 https://nmedialink.com/posts/google-ads-api-v23-live-for-global-ecom-ad-boost.html