开发文档

为腾讯社交广告客户提供全面的技术和数据支持

升级指引

Marketing API在鉴权授权环节和通用参数两方面有全新处理,主要体现为:

  • 1、access_token获取方式有较大调整,Marketing API目前仅支持通过OAuth2.0方式获得access_token,具体请参考API文档的【权限认证】页面介绍
  • 2、接口中需要的通用参数有所变化,具体请参考API文档的【通用参数】页面介绍

如果您之前已经通过其他方式对接过 人群管理API v1.x 、广告投放API v2、广告投放API v3等,上述两点都需要详细了解并做升级处理。此外,对于不同旧版API,还需了解以下具体业务接口变更:

已接入人群管理v1.x API的客户

如果您已经对接了之前的广点通人群管理 v1.x版本API,该版本API已不再更新并即将下线服务,请尽快升级至Marketing API。原有人群管理 v1.x API相关功能,将由Marketing API的人群管理 和 用户行为数据等模块相关接口替代,请点击进入相关章节了解功能指引和接口具体说明。

已接入广告投放 V3 API的客户

如果您已经对接了之前的广告投放API V3版本,该版本API已不再更新,但还会继续提供服务一段时间,您可以继续使用,但建议您尽早安排升级至Marketing API。原有广告投放API V3相关功能大多在Marketing API中有继承和延续。其中:

  • 广告投放相关接口差异不大,将平移至广告管理模块。
  • 报表相关接口进行了较大精简合并,形成广告数据洞察模块相关接口。
  • 自定义人群相关接口将由Marketing API的人群管理 和 用户行为数据等模块相关接口替代,请点击进入相关章节了解功能指引和接口具体说明。

已接入广告投放 V2 API的客户

如果您已经对接了之前的广告投放 V2版本API,该版本API已不再更新并即将下线服务,请尽快升级至Marketing API。你除了需要关注上面广告投放 V3 API→Marketing API的差异外,还需要对以下内容进行详细了解和对比:

  • 接口名和字段名有较大差异
  • 枚举值命名有较大差异
  • 创意新建和修改有较大差异
  • 支持的流量、广告类型、定向条件有较大改观

如果您在API升级迁移过程中需要了解更详细的接口版本差异或者需要技术支持,请与接口的运营人员联系。