入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

术语介绍和技术准备

本节将为您介绍 Marketing API 中涉及的概念术语和技术能力,有助于您快速地理解和使用API。如果您是初次接触腾讯Marketing API,建议您在开始进行具体接口调试之前对本章节内容进行了解。

接下来,我们将对以下几块内容进行重点介绍:

    • 术语介绍
      介绍 Marketing API 中涉及的概念及术语。
    • 技术准备
      介绍 Marketing API 对接可能会需要用到的一些技术知识。

1、术语介绍

了解这些术语及其概念有助于您更好的了解接下来章节中介绍的内容,以及您可能即将调用的相关接口的字段含义。

术语 中文名 详细描述
Tencent Social Ads(TSA) 腾讯社交广告 腾讯公司提供的基于社交流量和数据的效果广告服务,其广告平台包括了广点通系统、微信公众平台广告服务系统等。
advertiser 广告主 为推广商品或者提供服务,自行或者委托他人设计、制作、发布广告的企业或个人。
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);
  • 通过开放丰富的数据能力,为合作方提供智能化的人群画像分析,打破数据孤岛,分享数据红利,提升行业整体价值。详见 de.qq.com
DPA 动态商品广告 特指动态商品广告(Dynamic Product Ads)
2、技术准备

Marketing API 文档所涉及接口均遵循HTTPS协议,请求和应答的数据格式如无特殊说明均为JSON,您可以使用任何支持HTTPS协议和JSON格式的编程语言开发应用程序。

Marketing API 文档中的请求示例均为通过cURL方式发起请求的示例,cURL的用法可参考 维基百科-cURL相关介绍。同时我们提供了可视化的调试工具,以便提高您调试和编码的效率,详见【工具和支持】栏目。