腾讯广告广点通API接入文档(Android)

官方文档地址

如果能够看懂文档的也没有必要再往下面看了。本篇文章就到此结束。

下面记录的是本人在上面锁踩过的坑，因为我发现Mac电脑上面的联系客服不是我想要的。

本来只是内部使用的文档，后来想想还是公开出来，希望能够帮助到人。

进入正式的接入流程吧！！！

Step 1: 注册成为开发者

Step 2: 创建应用

这两步建议可以直接看文档，坑不在这一块。但是创建应用的时候有几个点可以注意下

• 应用介绍：这个不只是简单的介绍一下应用，还需要表明创建应用以后需要用到哪些接口，并且是干嘛使用的

  应用介绍说明(自己的应用介绍说明),主要使用到的接口有：1、https://developers.e.qq.com/oauth/authorize 通过这个接口获取到 authorization_code ；2、调用接口 https://api.e.qq.com/oauth/token 获取到 access_token 和 refresh_token ； 3、最后在调用 https://api.e.qq.com/v1.0/campaigns/add 发送请求

• 回调地址：这个可以是你们公司的域名之类的，可以是不正确的，没有很大的关系。
• 创建应用以后会向邮箱里面给你发送一些数据，我整个过程中没有使用这个数据，直接使用的是正式流程中的数据。主要还是看自己吧！

应用创建成功以后并且审核通过的话，就可以进行接下来的步骤了。

Step 3：授权认证

授权认证就是用浏览器去调用一个接口

https://developers.e.qq.com/oauth/authorize?client_id=123456&redirect_uri=https://www.example.com&state=&scope=

其中：

• client_id：开发者创建的应用唯一标识id，必填，可通过 [应用程序管理页面] 查看；
• redirect_uri：回调地址，由开发者自行提供和定义（地址主域需与开发者创建应用程序时登记的回调主域一致），用于跳转并接收回调信息，必填；
• state：开发者自定义参数，可用于验证请求有效性或者传递其他自定义信息，回调的时候会原样带回，可选；
• scope：授权的能力范围，可选，不传时表示授权范围为当前应用程序所拥有的所有能力；

OAuth 2.0 授权页面如下图所示：

同意授权以后，页面将会跳转到以下链接：

https://www.test.com/?authorization_code=1066a051ea8fbaf011b892c202ae1c93&state=

https://www.test.com 表示你所填写的回调地址。

authorization_code=1066a051ea8fbaf011b892c202ae1c93 这个参数将会在接下来的步骤中有这很大的作用。

点击进入你的腾讯社交平台->应用程序管理->应用test，进入应用test详情页面，会在页面的最底下绑定帐号管理栏里面多出刚刚授权的账号，

我这边有两个是因为我授权了两个账号。注意到图片上面有个广点通账号，这个将会对你有用的。

Step 4：使用 authorization_code 获得 access_token 和 refresh_token

腾讯文档关于获取这个还是说的很清楚的，具体可以查看文档。直接贴一个我这边请求的图：

这个接口的请求方式是GET

Step 5：上报用户行为数据

上报用户行为数据之前需要广点通人员在DMP后台新建App用户行为数据源，这一步骤将会取得 用户属性数据源 id ，接口会要用到的。

请求地址：

https://api.e.qq.com/v1.0/user_properties/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>'

对参数进行讲解一下

• access_token：就是上一个接口获取到的数据
• timestamp ： 时间戳 (秒级别)
• nonce ： 32位随机码

请求方式：POST

请求参数：

名称	类型	描述
account_id(必填)	integer