大数跨境

Google Ads API 第 16 版现已可用

Google Ads API 第 16 版现已可用 谷歌google快讯
2024-02-23
0
导读:Google 昨日发布了 Google Ads API 的第 16 版。此次更新包括更多推荐类型、对时间相关细分的支持、对广告主验证的支持,以及更多内容。

Google 近日正式发布 Google Ads API v16。作为继 2023 年 10 月 v15 版本后的重大更新,v16 重点增强了广告主身份验证、推荐系统智能化及时间维度细分能力,并针对 Demand Gen、购物及本地服务广告进行了多项功能扩展与错误处理优化。

账户管理与资产优化

在账户管理层面,API 强化了合作伙伴链接结构与身份验证流程。advertising_partner 已从 AccountLink 迁移至 ProductLink 和 ProductLinkInvitation,同时移除了原 AccountLink 中的 data_partner 和 google_ads 字段。新增 AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT 以明确暂停账户的操作限制。

核心变更在于新增 IdentityVerificationService 用于管理广告主验证。通过 StartIdentityVerification() 可基于指定 verification_program 启动会话;GetIdentityVerification() 则返回包含程序类型、截止日期要求、当前状态(program_status)、操作链接(action_url)及其过期时间的完整验证信息。相关枚举值包括 IdentityVerificationProgram 和 IdentityVerificationProgramStatus,并配套定义了 IdentityVerificationError 错误代码。

资产方面,asset_group 新增对 segments.year 和 segments.month 等时间相关细分的支持,并将 campaign 从细分资源调整为属性资源,提升了数据查询的灵活性。

广告系列与实验功能升级

Demand Gen 广告系列获得显著增强:支持为现有活动设置 Campaign.shopping_setting,并通过 ShoppingSetting.disable_product_feed 控制产品信息流的启用状态。同时新增 Ad.demand_gen_product_ad 及 DemandGenProductAdInfo,专门服务于配置了购物设置的 Demand Gen 活动。

投放状态透明度提升,AdGroup 和 AdGroupAd 均新增 primary_status 及 primary_status_reasons 字段,便于开发者精准判断广告组或广告的投放状态及未投放原因。AdGroupError 也相应增加了 CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE 和 INVALID_STATUS 两个错误值。

实验模块引入 Experiment.sync_enabled 参数,允许在实验期间自动同步原始活动的变更至实验活动。为此新增了 ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE 以及 CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL 错误提示。

行业垂直领域与规划工具更新

酒店与旅行板块中,Things to do 广告的 ListingDimensionInfo 新增 activity_state 和 activity_city 字段,支持按州和城市创建列表组。travel_activity_performance_view 也同步增加了对这三个地理维度的细分支持。

本地服务广告新增 LocalServicesVerificationArtifact.business_registration_check_verification_artifact 及 BusinessRegistrationCheckArtifact,帮助广告主监控业务注册验证进度。同时提供 local_services_employee 资源,支持检索已添加的员工信息。

规划工具 AudienceInsightsAttributeMetadata 已移除 score 字段,简化了受众洞察数据结构。

推荐系统与购物广告增强

RecommendationService 新增 GenerateRecommendations() 方法,支持根据推荐类型和渠道自定义获取建议,尤其适用于广告系列构建阶段。新增 RecommendationMetrics.conversions_value 指标,并将未设置匹配类型的推荐关键词默认值由 UNKNOWN 修正为 UNSPECIFIED。

v16 新增了七类实用推荐:MAXIMIZE_CONVERSION_VALUE_OPT_IN(最大化转化价值出价)、IMPROVE_GOOGLE_TAG_COVERAGE(扩大代码部署范围)、PERFORMANCE_MAX_FINAL_URL_OPT_IN(开启最终网址扩展)、REFRESH_CUSTOMER_MATCH_LIST(更新客户匹配列表)、CUSTOM_AUDIENCE_OPT_IN(创建自定义受众)、LEAD_FORM_ASSET(添加潜在客户表单素材)以及 IMPROVE_DEMAND_GEN_AD_STRENGTH(提升 Demand Gen 广告强度)。

购物广告针对比较购物服务关联账户优化了错误提示,新增 CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT 等错误码。AssetGroupListingGroupFilterError 也补充了 DIMENSION_TYPE_NOT_ALLOWED、DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP 等多个校验规则,提升了配置准确性。

生命周期目标操作规范化

CustomerLifecycleGoalOperation 和 CampaignLifecycleGoalOperation 已完成更新,使其操作逻辑与 API 中其他标准操作类型保持一致,提高了开发集成的统一性与稳定性。

【声明】内容源于网络
0
0
谷歌google快讯
谷歌官方更新资讯
内容 3766
粉丝 0
谷歌google快讯 谷歌官方更新资讯
总阅读451
粉丝0
内容3.8k