腾讯广告
  1. 入门与指南
腾讯广告
  • 入门与指南
    • 快速入门
    • 术语介绍和技术准备
    • 业务流程
    • 发起请求
    • 接收应答
    • 接口清单
    • V1.3升级指引
  • 授权认证
    • OAuth授权
      • 获取 Authorization Code
      • 获取 Token
  • 账号管理
    • 广告账号
      • 添加腾讯广告服务商子客
      • 更新腾讯广告广告主信息
      • 查询腾讯广告广告主信息
      • 获取竞价广告账户日预算
      • 查询商务管家账号下广告主信息
      • 查询商务管家或同主体下广告主信息
    • 资质
      • 创建广告主资质
      • 更新广告主资质
      • 获取广告主资质
      • 删除广告主资质
    • 资金账户
      • 发起代理商与子客户之间转账
      • 获取资金账户信息
      • 获取资金账户日结明细
      • 获取资金账户日结明细(新,包含日终结余数据)
      • 获取资金流水
      • 获取微信资金账户信息
      • 获取微信资金账户流水信息
      • 获取实时消耗
      • 服务商当日分账户实时消耗
      • 服务商内部划账
      • 同商务管家子客间转账
      • 资金合并类型同商务管家子客间转账
      • 获取资金合并类型资金账户信息
      • 获取资金合并类型资金账户日结明细
      • 获取资金合并类型资金流水
  • 营销资产
    • 推广目标
      • 创建推广目标
      • 更新推广目标
      • 获取推广目标
      • 删除推广目标
      • 推广目标授权接口
      • 获取授权历史记录
      • 获取 Android 渠道包
    • 落地页
      • 获取落地页列表
      • 获取蹊径落地页模板列表
      • 获取蹊径落地页模板
      • 获取蹊径落地页互动模板配置
      • 蹊径-获取落地页列表
      • 蹊径-基于模板创建落地页
      • 蹊径-基于组件创建落地页
      • 蹊径-创建互动落地页
      • 蹊径-送审落地页
      • 蹊径-删除落地页
      • 生成虚拟人
      • 生成点击特效
      • 生成预览 token
    • 落地页号码包
      • 获取蹊径号码包列表
      • 添加蹊径号码包
      • 更新蹊径号码包
      • 获取蹊径微信号列表
      • 更新蹊径微信号
    • 视频
      • 添加视频文件
      • 获取视频文件
      • 修改视频信息
      • 删除视频
    • 图片
      • 添加图片文件
      • 获取图片信息
      • 修改图片信息
      • 删除图片
    • 品牌形象
      • 创建品牌形象
      • 获取品牌形象列表
    • 互动推广页
      • 获取互动推广页
    • 商品库
      • 创建商品库
      • 获取商品库
      • 添加商品
      • 行业列表
      • 获取商品
      • 获取商品详情
      • 更新商品信息
      • 批量更新商品信息
      • 获取审核失败的商品
      • 获取商品类目
      • 创建商品系列
      • 获取商品系列
    • 动态商品图片
      • 创建用于广告投放的动态广告图片
      • 获取动态广告图片信息
    • 动态商品视频
      • 创建用于广告投放的动态广告视频
    • 微信原生页
      • 基于模板创建微信原生页
      • 基于组件创建微信原生页
      • 获取微信落地页列表
      • 删除微信落地页
    • 广告应用分包
      • 创建应用分包
      • 更新应用子包版本
      • 查询应用分包列表
    • 优量汇流量包
      • 联盟流量包模块
      • 联盟流量包模块
      • 联盟流量包获取接口
      • 联盟流量包删除接口
    • 资产授权
      • 资产权限授予
      • 资产权限回收
      • 获取待确认接收授权列表接口
      • 资产预授权确认
      • 更新资产授权权限
    • 朋友圈头像昵称跳转页
      • 创建朋友圈头像昵称跳转页
      • 删除朋友圈头像昵称跳转页
      • 获取朋友圈头像昵称跳转页
    • 附加创意
      • 创建表单组件
      • 获取表单组件详情
      • 获取表单组件列表
    • 弹幕
      • 添加弹幕
      • 获取弹幕
      • 查询运营推荐弹幕列表
    • 本地门店
      • 批量录入门店
      • 批量更新门店信息
      • 批量删除门店信息
      • 查询门店信息
      • 解析门店地址
      • 搜索门店
      • 查询微信支付商户号
      • 查询门店类目
    • 创意组件
      • 创建创意组件
      • 更新创意组件
      • 查询创意组件信息
      • 删除创意组件
      • 更新创意组件状态
  • 广告管理
    • 推广计划
      • 创建推广计划
      • 更新推广计划
      • 获取推广计划
      • 删除推广计划
    • 广告组
      • 创建广告组
      • 更新广告组
      • 获取广告组
      • 删除广告组
    • 广告创意
      • 创建广告创意
      • 更新广告创意
      • 获取广告创意
      • 删除广告创意
    • 动态创意
      • 创建动态创意
      • 更新动态创意
      • 获取动态创意
    • 广告
      • 创建广告
      • 更新广告
      • 获取广告
      • 删除广告
    • 定向
      • 创建定向
      • 更新定向
      • 获取定向
      • 删除定向
      • 分享定向
      • 获取定向分享记录
    • 关键词
      • 创建关键词
      • 替换关键词
      • 删除关键词
      • 获取关键词
    • 否定词
      • 新增推广计划否定词
      • 新增广告组否定词
      • 修改推广计划否定词
      • 修改广告组否定词
      • 查询推广计划否定词
      • 查询广告组否定词
    • 批量操作
      • 创建批量请求
      • 更新广告主日限额信息
      • 更新推广计划日限额信息
      • 更新广告组日限额信息
      • 更新推广计划状态
      • 更新广告组状态
      • 更新广告状态
      • 更新广告组投放时间
      • 更新广告组出价
      • 创建批量异步请求任务
      • 获取批量异步请求任务列表
      • 获取批量异步请求任务详情
    • 出价
      • 获取分人群出价标签
  • 创意工具
    • 文案助手
      • 获取广告文案
    • 图片处理
      • 进行图片处理
    • 广告素材预审
      • 获取广告素材预审结果
    • 视频加字幕
      • 创建视频加字幕任务
    • 创建智能调整
      • 创建智能调整任务
    • 视频封面画图
      • 生成视频封面图
    • 词包
      • 获取词包
    • 通配符
      • 获取落地页通配符
    • 创意示例商品
      • 获取创意示例商品列表
    • 动态商品图片模板
      • 获取动态商品图片模板
    • 动态商品视频模板
      • 获取动态商品视频模板
    • 创意工具通用接口
      • 视频工具任务查询
    • 自动生成创意
      • 创建模板预览接口
      • 更新模板预览接口
      • 获取模板预览接口
      • 获取模板列表接口
    • 素材标签
      • 素材标签列表
      • 素材标签保存
  • 数据洞察
    • 广告数据洞察
      • 获取日报表
      • 获取小时报表
      • 获取定向标签报表
      • 落地页报表数据接口
      • 联盟广告位报表接口
      • 视频流失分析接口
      • 创建异步报表任务
      • 获取异步报表任务
      • 获取文件接口
    • 人群数据洞察
      • 人群洞察分析
    • 订单数据
      • 获取订单
      • 更新订单
    • 线索管理平台
      • 获取线索列表
      • 回传线索状态
      • 获取中间号
      • 获取通话结果
      • 获取一个账号下的全部通话结果
      • 获取网络电话 token
      • 网络电话呼叫
      • 外部线索数据导入
      • 外部线索状态更新
      • 更新线索基本信息
      • 获取无效赔付明细
    • 人群价值分析
      • 人群价值分析
  • 人群管理
    • 客服人群
      • 创建客户人群
      • 更新客户人群
      • 更新客户人群
      • 删除客户人群
    • 客户人群数据文件
      • 上传客户人群数据文件
      • 获取客户人群数据文件
    • 客户人群数预估
      • 人群覆盖数预估
    • 人群授权
      • 添加人群授权
      • 获取人群授权信息
    • 标签人群
      • 标签广场标签获取
    • 客户标签
      • 创建客户标签
      • 获取客户标签
      • 更新客户标签
      • 删除客户标签
    • 标签数据文件
      • 上传客户标签人群数据文件
      • 获取客户标签人群文件
    • 用户属性数据源
      • 创建用户属性数据源
      • 更新用户属性数据源
      • 获取用户属性数据源
    • 用户属性数据
      • 上传用户属性数据
  • 数据上报
    • 用户行为数据源
      • 创建用户行为数据源
      • 获取用户行为数据源
      • 获取用户行为数据源报表
      • 添加数据集
      • 获取数据集
      • 数据源分发关系更新
      • 数据源分发关系获取
    • 用户行为数据
      • 上传用户行为数据
    • 属性数据源
      • 创建属性数据源
      • 获取属性数据源
    • 属性数据源schema
      • 创建属性数据源 schema
      • 更新属性数据源 schema
      • 获取属性数据源 Schema
    • 属性数据文件上传
      • 创建属性数据文件上传会话
      • 提交属性数据文件上传会话
      • 上传属性数据文件
  • 附近推
    • 附近推开户
      • 附近推商家开户
      • 更新附近推商家信息
      • 查询附近推商家信息
    • 附近推账户资金
      • 微信服务商子客之间转账
    • 附近推账户资质
      • 添加附近推商家资质
      • 删除附近推商家资质
      • 查询附近推商家资质信息
    • 附近推广告投放
      • 创建广告
      • 拉取广告列表
      • 更新广告
      • 手动结束广告
      • 拉取曝光预估数据
    • 附近推门店
      • 批量录入门店
      • 批量更新门店信息
      • 批量删除门店信息
      • 查询门店信息
      • 解析门店地址
      • 搜索门店
      • 查询微信支付商户号
      • 查询门店类目
  • 审核工具
    • 素材风险检测
      • 获取元素的预审结果
    • 广告申诉复审
      • 发起广告申诉复审
      • 获取广告申诉复审结果
      • 获取广告申诉复审配额
  • 投放辅助工具
    • 定向标签
      • 获取定向标签
      • 获取行为/兴趣/意向标签覆盖人群数
    • 场景定向标签
      • 获取场景定向标签
    • 创意形式
      • 获取创意规格详情
      • 获取创意规格列表
    • 广告投放能力
      • 查询优化目标权限
    • 预估能力
      • 人数预估
      • 获取出价模拟信息
      • 获取当日转化效果预估数据
    • 广告预览
      • 创建预览
      • 获取预览受众
      • 获取广告预览二维码
    • ·异步任务
      • 创建异步任务
      • 获取异步任务
      • 获取文件接口
    • 拆分对比实验
      • 创建拆分对比实验
      • 更新拆分对比实验
      • 删除拆分对比实验
      • 获取拆分对比实验
    • 广告诊断
      • 获取广告诊断信息
    • 广告创意预览
      • 获取广告创意预览
    • 微信广告标签
      • 获取微信广告标签
    • 广告标签
      • 获取广告标签
    • 转化归因
      • 新增转化归因
      • 获取转化归因
    • 微信原生页
      • 获取原生页授权方信息
      • 获取企业微信客服组列表
      • 增加企业微信组件客服组
      • 更新企业微信组件客服组
      • 获取企业微信组件客服列表
      • 更新企业微信组件客服状态
    • 微信公众号账户升级
      • 获取微信公众号账户升级状态
    • 腾讯广告账户报表指标升级
      • 获取腾讯广告平台广告账户升级状态
    • 探索推广工具
      • 查询关键词流量接口
      • 获取关键词推荐结果
      • 查询行业业务点信息
    • 视频号精选评论管理
      • 设置视频号评论管理
    • 游戏特征信息
      • 获取游戏特征标签
      • 新增游戏 app 特征
      • 更新游戏 app 特征
      • 获取游戏 app 特征
  • 附录
    • 更多信息
  1. 入门与指南

术语介绍和技术准备

本节将为您介绍 Marketing API 中涉及的概念术语和技术能力,有助于您快速地理解和使用API。如果您是初次接触腾讯Marketing API,建议您在开始进行具体接口调试之前对本章节内容进行了解。 接下来,我们将对以下几块内容进行重点介绍:
术语介绍介绍 Marketing API 中涉及的概念及术语。
技术准备介绍 Marketing API 对接可能会需要用到的一些技术知识。

术语介绍#

了解这些术语及其概念有助于您更好的了解接下来章节中介绍的内容,以及您可能即将调用的相关接口的字段含义。
术语中文名详细描述
agency代理商为广告主投放并管理广告的代理机构。 通过代理商创建帐号的广告主称之为子客,未通过代理商创建帐号的广告主称之为直客。
account客户帐号通过腾讯广告平台开展推广业务的客户,包括代理商、直客、子客三种类型。每个客户在腾讯广告平台上可能有一个或多个帐号,每个帐号对应唯一的 account_id。 仅广告主帐号(直客以及子客)才能投放广告。
developer开发者特指基于 TSA Marketing API 进行相关功能开发的企业; 开发者可以是客户(代理商、直客、子客)本人,也可以是第三方的技术公司; 所有开发者需要通过腾讯广告开发者官网进行注册才能拥有 Marketing API 的使用权限。立刻注册
client_id应用程序id开发者官网为在官网中创建并审核通过的应用程序分配的id,每个应用程序对应唯一的 client_id ; 应用程序可以是网站、PC应用、手机应用,如广告客户自有的内部系统、广告代理商的 Trading Desk 系统等等; Marketing API 的接口权限、资源授权等均基于应用程序进行控制。
client_secret应用程序密钥每个应用程序对应的密钥,在开发者创建的应用程序被审批通过时由系统分配; 用于在 Marketing API 的鉴权认证过程中获得调用API的 access_token; 每个应用程序对应唯一的 client_secret。
access_token授权令牌Marketing API 每次接口调用中用于鉴别权限的参数,包含客户授予当前应用程序访问其帐号的信息; 通常需要应用程序引导客户通过完成 OAuth 2.0 授权后才能获得。
campaign推广计划一系列相似或相关推广内容的集合。例如,您可以将推广某一款产品的所有广告放在一个推广计划中,也可以将某一期推广活动相关的广告都放在一个推广计划中。
adgroup广告组共享相同的推广时间、受众目标、投放广告版位、出价等信息的多个广告的集合。
ad广告广告主可以管理的最小的展示单元; 每个广告必须属于一个广告组,必须且只能引用一个创意。
adcreative广告创意呈现给受众的元素集合,可能是文字、图片、视频等一种或多种元素的组合;
adcreative_template创意形式对创意中元素的具体描述和限定。一般情况下,不同创意形式具有的元素或其属性(如图片的尺寸、字符限制等)不同; 每个创意形式对应唯一的 adcreative_template_id,例如 adcreative_template_id=2 时,限制创意中必须包含一个长度小于 18 的文本和一张尺寸为 160*210 的图片两个元素; 一个广告创意只能对应一个创意形式。
promoted_object推广目标待推广的具体目标,比如某个网页 http://www.qq.com 、微信 Android 版等。
promoted_object_type推广目标类型待推广标的物的类型,例如普通链接、腾讯开放平台移动应用、苹果应用、微信品牌活动页等。
targeting定向用于筛选广告受众的条件组合; 可以根据多个维度筛选出合适的受众并应用在广告投放环节。
DMP腾讯广告数据管理平台特指腾讯广告数据管理平台(Data Management Platform); 通过开放丰富的数据能力,为合作方提供智能化的人群画像分析,打破数据孤岛,分享数据红利,提升行业整体价值。详见 dmp.qq.com。
DPA动态商品广告特指动态商品广告(Dynamic Product Ads)

技术准备#

Marketing API 文档所涉及接口均遵循HTTPS协议,您可以使用任何支持HTTPS协议和JSON格式的编程语言开发应用程序。
有关标准HTTPS协议,可参考 RFC818 或 维基百科-HTTPS 相关介绍。
有关JSON数据格式,可参考 JSON.ORG 或 维基百科–JSON 相关介绍。
Marketing API 文档中的请求示例均为通过cURL方式发起请求的示例,cURL的用法可参考 维基百科-cURL相关介绍。同时我们提供了可视化的调试工具(登录后可在每篇文档页面中使用),以便提高您调试和编码的效率。另外,接口文档中所描述的integer类型代表整型,并不一定代表开发语言的int类型。对于某些字段可能存在长度问题,详情可参考 广告相关ID取值升级通知。
修改于 2023-11-01 02:43:42
上一页
快速入门
下一页
业务流程
Built with