大数跨境

Google Ads API 第21版现已推出

Google Ads API 第21版现已推出 谷歌google快讯
2025-08-07
0
导读:Google已发布Google Ads API的第21版,这是一个包含数十项更新的主要版本。更新内容包括针对搜索广告的AI Max、PMax变更、报告更新等更多内容。

Google Ads API v21 正式发布,本次更新涵盖搜索广告 AI Max、Performance Max 优化、欧盟政治广告合规及多项报告与素材功能升级。开发者需注意,AdWords API 已于今年 4 月停用,并将于 7 月底彻底停止运行,请尽快完成迁移。

搜索广告 AI Max 全面升级

  • 启用与控制:支持通过 Campaign.ai_max_setting.enable_ai_max 字段为搜索广告系列启用 AI Max。该功能通过搜索词匹配扩大覆盖范围,同时允许在设置时保留定向和创意控制。若未启用 AI Max 而选择 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION,系统将抛出 CampaignError.AI_MAX_MUST_BE_ENABLED 错误。
  • 广告组级定向:新增广告组级别定向控制,支持添加品牌列表、地理位置及网页(URL 规则)条件。可通过 AdGroup.ai_max_ad_group_setting.disable_search_term_matching 禁用特定广告组的搜索词匹配。
  • 数据报告:新增 ai_max_search_term_ad_combination_view,用于追踪搜索词、标题与着陆页组合的性能表现。search_term_match_type 分段新增 AI_MAX 值。

素材与资产管理优化

  • PromotionAsset 扩展:新增条款文本(terms_and_conditions_text)、URI、条形码及二维码信息字段,丰富促销素材展示维度。
  • 自动化资产控制:AssetAutomationTypeEnum 新增 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION,支持从最终 URL 自动生成文本资产和落地页;新增 AutomaticallyCreatedAssetRemovalService,允许移除自动创建的最终 URL 扩展资产。
  • 枚举修正:ServedAssetFieldType 新增 DESCRIPTION_PREFIX,修复 ad_group_ad_asset_combination_view 中描述前缀资产显示为 UNKNOWN 的问题。

广告系列配置与出价策略更新

  • 位置定位限制:CampaignPrimaryStatusReason 新增 MISSING_LOCATION_TARGETING,针对未指定位置的位置受限广告系列返回状态提示;在允许区域外添加定位将触发 LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN 错误。
  • 第三方集成与排除:Campaign 及 VideoCustomer 层级支持 third_party_integration_partners;现有广告系列可直接设置 advertising_partner_ids;支持通过经理账户共享列表在客户账户中批量排除展示位。
  • 出价策略增强:MaximizeConversionValue 和 TargetRoas 策略新增 target_roas_tolerance_percent_millis 字段,仅适用于搜索广告系列的投资组合策略。
  • 资源与错误码:新增 LocationInterestView 汇总位置兴趣表现;ProductGroup 部分失败请求的错误码变更为 LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION。

转化追踪与需求生成调整

  • 转化归因:conversion_attribution_event_type 新增 ENGAGED_VIEW 分段值;ConversionUploadService 不再支持 debug_enabled 模式。
  • 预算下限:Demand Gen 广告系列新增 BUDGET_BELOW_DAILY_MINIMUM 错误代码,当预算低于最低限额时触发,详情可参考 budgetDailyMinimumErrorDetails。

欧盟政治广告合规要求

本变更已同步至 v19.2 和 v20.1 版本,v21 进一步强化执行:

  • 自我声明必填:创建新广告系列必须设置 contains_eu_political_advertising 字段,否则返回 REQUIRED 错误。若标记为 CONTAINS_EU_POLITICAL_ADVERTISING,自 2025 年 9 月 22 日起将在欧盟停投。
  • 定向修改限制:未完成自我声明的现有广告系列,在修改地理或位置定向时将触发 MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 错误。
  • 实验广告:Trials and Experiments 同样强制执行上述自我声明检查。

Performance Max 与规划工具迭代

  • PMax 默认设置:新建 PMax 广告系列的 brand_guidelines_enabled 默认值设为 true。
  • 搜索词报告:新增 campaign_search_term_view,支持 PMax 广告系列层级的搜索词指标聚合;search_term_match_type 新增 PERFORMANCE_MAX 值。
  • ReachPlan 增强:ListPlannableUserInterests 支持查询用户兴趣名称与路径;ListPlannableUserLists 新增 AdditionalApplicationInfo 可选输入。
  • AudienceInsights 升级:支持一方用户列表获取受众洞察与触达建议;TrendInsightMetrics 新增受众份额指标;KnowledgeGraphAttributeMetadata 新增相关类别筛选。

报告视图与视频广告新功能

  • 报告指标完善:AssetGroupAsset 等视图新增多项指标,PMax 展示量恢复真实值;支持按 ChangeStatus 筛选 AssetSet 资源;新增 final_url_expansion_asset_view、landing_page_source 段及 search_term_targeting_status 等细分维度。
  • YouTube 视频资产:新增 YouTubeVideoListAsset 及相关链接字段;公开 VIDEO_RELATED_VIDEOS_CLICK 等新点击类型。
  • 视频投放控制:VideoAdInventoryControl 新增 allow_non_skippable_in_stream,支持不可跳过前贴片混合投放;新增视频广告序列只读字段。
  • 白名单功能:CampaignCriterion 和 AdGroupCriterion 新增 VIDEO_LINEUP 标准类型,仅限白名单账户使用。
  • 内容适宜性:新增明细与分组层级的内容适宜性报告。
【声明】内容源于网络
0
0
谷歌google快讯
谷歌官方更新资讯
内容 3766
粉丝 0
谷歌google快讯 谷歌官方更新资讯
总阅读451
粉丝0
内容3.8k