腾讯广点通接入总结及源码

接入文档地址：https://developers.e.qq.com/docs/start

由于腾讯的广告业务做的太大，所以接起来还挺麻烦的，比起百度难接入。页面上的客服也是爱答不理的，反正等了一下午也没回我消息！就自己看，也不知道投放部门准备怎么接，就让开发自己看文档！看的头大！！！

这是腾讯给出的文档说明。

1、用 公用 qq （这个不用说了为啥了吧）注册为开发者后，创建应用程序等着审核，创建的几个应用程序不要相似度太高，要不通过不了，一般一个就够了。或者一个申请一种权限。

2、创建数据源，（可以通过可视化界面申请创建，请看官方文档）

上传行为数据。重点说下这个步骤：

这个步骤的目的是为了在管理后台知道我们有多少用户的转化率，大概是为了腾讯更好的推广产品吧。

要想上传行为数据，必须有access-token，这个token有两种获取方式：

1、直接获取

2、通过refresh_token获取

这两种方式有何区别：

第一种建议第一次的时候使用，因为获取的时候需要授权码，授权码是通过回调带回到自己填写的地址的，当带回到自己填写的地址后，我们就可以使用redis等工具把它暂存器来，然后调用获取access-token方法，这个时候我们就可以去获取access-token和 refresh_token，然后把这两者都存起来，每经过23小时左右（access-token 有效期24小时）使用refresh_token 刷新一次 access-token，这样就不会再出现access-token 过期的情况了。

另外：难免出现意外情况，再token过期的时候，可以使用 Springboot 的邮件系统给自己或者组员发送一个带有授权验证的超链接，任何一个组员或者全部成员看到后，都可以手动认证（因为腾讯做了图片的滑块校验），最后跳转到自定义的授权成功页面即可，就不再影响业务了！

我们会及时上报行为数据，

我们会再接到用户的点击行为的时候，把需要的上报链接封装好，预留一些字段，如时间戳和token等，等用户激活的时候再替换下链接做个上传。

在开发人员这里需要的几个接口或自动任务

1、授权成功的回调接口

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

这是腾讯给出的引导客户进行授权认证时的链接，里面有一个redirect_url，这个算是需要开发的第一个接口，当认证成功后，腾讯还会回调的这个地址，示例如下

http://www.example.com/response?authorization_code=6a6b6c6d&state=112233

我们需要把这个 authorization_code 字段保存下，用来请求 access_token。

2、广告点击行为接收接口即feedback-url

这个用来获取用户的点击行为数据，在这里我们也可以定义自己的参数，如我们想知道这些数据是在哪投放的广告，可以加个 adcome=tencent 它会在调用的时候给我们带回来，这样我们就可以区分了。完整的url示例如下

http://www.example.com/feedback_url?adcome=tencent

3、自动任务使用refresh_token 刷新 access_token

这个可以使用 Springboot 开发，挺简单的，不懂的可以参考这个 SpringBoot 学习系列(五) - 快速开发定时任务程序

我们可以使用定时的自动任务多少毫秒刷新一次，如我的代码像这样：

我们是把这些需要的token存入了redis里面，这样我们使用的时候直接去取就行了。

另外需要注意的是：我们开发的程序难免会有意外情况，这时候我们最好加个邮件提醒，发邮件也很简单，可以参考：SpringBoot 学习系列(六) - 简单五步搞定邮件发送 像我们发邮件，在邮件里面注明链接，这样相关人员或者开发者本人收到邮件后，可以直接点击去获取最新的 au_code。

目前还不是很完善，等待激活程序搞定后再来补充！目前项目还未上线！

***********************************************************************************************

已经开始推广，有个小问题

数据对不上渠道

解决方法：数据上报的时候用了自定义的行为id字段，导致对不上，去掉即可。

页面上的客服依然那么的不懂业务！！！！

注意：在创建应用的时候，无需申请太多的权限，一般只需要数据上报权限即可，在说明里面最好别写测试等字眼，否则不容易被审核通过！

大部分关键源码如下：xxx 为公司名，YYY 为项目名请酌情替换

AuthController.java

package com.XXX.YYY.controller;import com.XXX.YYY.schedulertask.GetAndRefreshTokenTask;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.HashOperations;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;import javax.servlet.http.HttpServletRequest;@Controller
@RequestMapping("/")
@Slf4j
public class AuthController {@Autowiredprivate GetAndRefreshTokenTask task;// redis 操作类@Autowiredprivate RedisTemplate redisTemplate;// refresh_token access_token 的键private final String TOKEN_KEY ="tf_token_key";// 修改支持多账户 规则 authorization_code_+账户id  state_+账户idprivate final String AUTHORIZATION_CODE_PREFIX ="authorization_code_";private final String AUTHORIZATION_CODE ="authorization_code";private final String STATE_PREFIX ="state_";private final String STATE="state";/*** 授权成功跳转页面* 特殊说明：目前请求授权地址为：* 安卓 https://developers.e.qq.com/oauth/authorize?client_id=xxxxxxxx&redirect_uri=http://YYY.XXX.com/tf_auth&state=xxx_tf_auth_ida* IOS https://developers.e.qq.com/oauth/authorize?client_id=xxxxxxxx&redirect_uri=http://YYY.XXX.com/tf_auth&state=xxx_tf_auth_idb* @param mv 视图* @param request 请求* @return 成功页面*/@GetMapping("/tf_auth")public ModelAndView test(ModelAndView mv,HttpServletRequest request) {String domain="http://YYY.XXX.com/tf_auth";String url = domain+"?"+request.getQueryString();log.info("获取 authorization_code 的url: "+url);// 分账户String state = request.getParameter(STATE).trim();// 操作类HashOperations<String, String, Object> hashOperations = redisTemplate.opsForHash();mv.setViewName("authSuccess");String authorization_code = request.getParameter(AUTHORIZATION_CODE);String accountId = state.substring(state.lastIndexOf("_")+1);hashOperations.put(TOKEN_KEY, AUTHORIZATION_CODE_PREFIX+accountId, authorization_code);hashOperations.put(TOKEN_KEY, STATE_PREFIX+accountId, state);// 授权成功更新下 tokentask.autoTaskJob();return mv;}
}

2、GetAndRefreshTokenTask.java

package com.XXX.YYY.schedulertask;import com.alibaba.fastjson.JSONObject;
import com.XXX.YYY.utils.HttpUtil;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.env.Environment;
import org.springframework.data.redis.core.HashOperations;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import org.thymeleaf.TemplateEngine;
import org.thymeleaf.context.Context;import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Map;@Component
@Slf4j
public class GetAndRefreshTokenTask {// refresh_token access_token 的键private final String TOKEN_KEY ="tf_token_key";// hash keyprivate final String ACCESS_TOKEN ="access_token";private static final String REFRESH_TOKEN ="refresh_token";private final String AUTHORIZATION_CODE ="authorization_code";// 通过 Authorization Code 获取 Access Token 或刷新 Access Tokenprivate static final String GET_TOKEN_URL="https://api.e.qq.com/oauth/token?";private String ACCOUNT_PREFIX ="aso.tencent.account";// 请求需要的几个字段private static final String CLIENT_ID="client_id";private static final String CLIENT_SECRET ="client_secret";private static final String CLIENT_ID_VALUE="1108034188";private static final String CLIENT_SECRET_VALUE="xLfe83U0xzwHCXLl";// 请求的类型，可选值： authorization_code （授权码方式获取 token ）、 refresh_token （刷新 token ）private static final String GRANT_TYPE="grant_type";private static final String REDIRECT_URI="redirect_uri";private static final String REDIRECT_URI_VALUE="http://YYY.XXX.com/tf_auth";// 直接获取private static String getAccessTokenUrl = "";// 通过 refresh_token u获取private static String getAccessTokenFromRefreshTokenUrl = "";static {StringBuilder sb = new StringBuilder(GET_TOKEN_URL);sb.append(CLIENT_ID);sb.append("=");sb.append(CLIENT_ID_VALUE);sb.append("&");sb.append(CLIENT_SECRET);sb.append("=");sb.append(CLIENT_SECRET_VALUE);sb.append("&");sb.append(GRANT_TYPE);sb.append("=");sb.append("grant_type_value");getAccessTokenFromRefreshTokenUrl = sb.toString();sb.append("&");sb.append(REDIRECT_URI);sb.append("=");sb.append(REDIRECT_URI_VALUE);getAccessTokenUrl = sb.toString();}// 发件人地址@Value("${spring.mail.fromMail.addr}")private String from;// 收件人地址@Value("${spring.mail.toMail.addr}")private String toMail;@Autowiredprivate TemplateEngine templateEngine;@Autowiredprivate Environment env;@Autowiredprivate JavaMailSender mailSender;@Autowiredprivate RedisTemplate redisTemplate;private static final SimpleDateFormat dateFormat = new SimpleDateFormat("HH:mm:ss");// 23小时执行更新一次@Scheduled(fixedRate = 82800000)public void reportCurrentTime() {autoTaskJob();}// 封装成方法 便于认证成功也可以调用public void autoTaskJob(){System.out.println("现在时间：" + dateFormat.format(new Date()));HashOperations<String, String, Object> hashOperations = redisTemplate.opsForHash();String[] accountArr = env.getProperty(ACCOUNT_PREFIX).split(",");for(String account : accountArr){String  getTokenType = hashOperations.get(TOKEN_KEY, REFRESH_TOKEN+"_"+account) == null?"access":"refresh";String requestUrl = "";if("access".equals(getTokenType)){String authorization_code = hashOperations.get(TOKEN_KEY, AUTHORIZATION_CODE+"_"+account).toString();requestUrl = getAccessTokenUrl.replace("grant_type_value",AUTHORIZATION_CODE );requestUrl += "&"+AUTHORIZATION_CODE+"="+authorization_code;}else {String refresh_token = hashOperations.get(TOKEN_KEY, REFRESH_TOKEN+"_"+account).toString();requestUrl = getAccessTokenFromRefreshTokenUrl.replace("grant_type_value",REFRESH_TOKEN );requestUrl += "&"+REFRESH_TOKEN+"="+refresh_token;}String returnMsg = HttpUtil.httpClientGet(requestUrl);Map map = JSONObject.parseObject(returnMsg,Map.class);if("0".equals(map.get("code").toString())){Map data = (Map)map.get("data");String access_token = data.get(ACCESS_TOKEN).toString();String refresh_token = data.get(REFRESH_TOKEN).toString();hashOperations.put(TOKEN_KEY, ACCESS_TOKEN+"_"+account, access_token);hashOperations.put(TOKEN_KEY, REFRESH_TOKEN+"_"+account, refresh_token);log.info(account+":更新token成功！");}else {// 发送邮件提醒重新认证sendReAuthMail(account);log.error(account+":token更新失败！");}}}// 发送重新认证邮件private void sendReAuthMail(String content){//创建邮件正文Context context = new Context();context.setVariable("id", content);String emailContent = templateEngine.process("emailTemplate", context);sendHtmlMail( toMail,"广点通需要重新认证，请尽快处理！", emailContent);}/*** 发送html邮件 目前支持发送给单个接收者* @param to 收件人* @param subject 邮件主题* @param content 邮件内容*/private void sendHtmlMail(String to, String subject, String content) {MimeMessage message = mailSender.createMimeMessage();try {//true表示需要创建一个multipart messageMimeMessageHelper helper = new MimeMessageHelper(message, true);helper.setFrom(from);helper.setTo(to);helper.setSubject(subject);helper.setText(content, true);mailSender.send(message);log.info("html邮件发送成功");} catch (MessagingException e) {log.error("发送html邮件时发生异常！", e);}}
}

3、HttpUtil.java

package com.XXX.YYY.utils;import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;public class HttpUtil {public static String  httpClientGet(String url) {String str = "";try{// 获取http客户端CloseableHttpClient client = HttpClients.createDefault();// 通过httpget方式来实现我们的get请求HttpGet httpGet = new HttpGet(url);// 通过client调用execute方法，得到我们的执行结果就是一个response，所有的数据都封装在response里面了CloseableHttpResponse Response = client.execute(httpGet);// HttpEntity// 是一个中间的桥梁，在httpClient里面，是连接我们的请求与响应的一个中间桥梁，所有的请求参数都是通过HttpEntity携带过去的// 所有的响应的数据，也全部都是封装在HttpEntity里面HttpEntity entity = Response.getEntity();// 通过EntityUtils 来将我们的数据转换成字符串str = EntityUtils.toString(entity, "UTF-8");// EntityUtils.toString(entity)System.out.println(str);// 关闭Response.close();return str;}catch (Exception ex){ex.printStackTrace();return str;}}
}

4、application.yml

server:port: 8081# 邮件发送设置
spring:mail:host: smtp.xxx.comusername: name@staff.xxx.compassword: passwddefault-encoding: UTF-8fromMail:addr: name@staff.xxx.comtoMail:addr: daguang0822@126.com# ida idb 分别为申请的应用的id 七位数字 storeid1 storeid2 分别为上报的数据库的id 十位数字tencent:# ida 安卓第一个账户 qq: qq1  idb IOS第一个账户 qq:qq2account: ida,idbuser_action_set_id_ida: storeid1user_action_set_id_idb: storeid2

5、emailTemplate.html

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org" >
<html lang="en">
<head><meta charset="UTF-8"><title>广点通重新认证</title>
</head>
<body><br/><h3>账号异常，请及时处理</h3><br/>如果您看到这封邮件！点击<a th:href="@{ https://developers.e.qq.com/oauth/authorize?client_id=xxxxxxxx&redirect_uri=http://XXX.YYY.com/tf_auth&state=xxx_tf_auth_{id}(id=${id})}">广点通链接</a>进行认证！提示：qq和账户的对应关系<br/>qq：qq1 账户：ida<br/>qq: qq2 账户：idb<br/>
<h3>谢谢！</h3>
</body>
</html>

腾讯广点通接入总结及源码相关推荐

移动推行利器——腾讯广点通移动战略解读
近日,第九届中国互联网创业者大会移动推行专场在京举行,很多移动推行专家和一线创业者齐聚,一同讨论移动推行之道.现场,腾讯作用广告渠道部总经理罗征启动了腾讯广告联盟,并环绕广点通移动联盟宣告了讲演. 腾 ...
腾讯广点通到底是做什么的
越来越多的人关注并加入腾讯广点通,大部分人其实对其没有多深入的了解.都比较怀疑广点通怎么样,带来的用户质量如何,量多大.下面是一组腾讯广点通几个投放渠道的数据: 1.广点通五大渠道数据: QQ,月活8 ...
腾讯广点通广告投放-转化归因API回传接口对接踩坑指南
对于腾讯广点通广告平台的文档,实在是忍不住要吐槽一番.本来接收到回传接口文档,看到给的PDF文档没有备注说明,但是看到回传方式,挺简单的.以为一下就能搞定了,但是对接下来才发现,各个字段根本不知道什么 ...
2020交友聊天PHP代码社交网络网站源代码聊天即时通源代码送APP源码
2020交友聊天PHP代码社交网络网站源代码聊天即时通源代码送APP源码这是一款社交网络系统,你可以在简短的几分钟内创建自己的社交平台,支持发布视频.音频.文件.图片,用户之间可以相互关注加好友 ...
JAVA计算机毕业设计南京新东方学校家校通系统（附源码、数据库）
JAVA计算机毕业设计南京新东方学校家校通系统(附源码.数据库) 目运行环境项配置: Jdk1.8 + Tomcat8.5 + Mysql + HBuilderX(Webstorm也行)+ Ecli ...
随心所记：记一次微信小程序对接腾讯广点通的虐心经历
广点通是啥?简单说就是一个广告的投放途径后台要做统计,需要我这里拿到他们的id 简单说就是这样的小程序路径 pages/index/index 根据他们提供的文档,他们的系统会拼接一个参数 ...
Unity3D使用腾讯广点通广告
目前,游戏开发平台有很多,今天咱们主要介绍Unity3d开发的Android游戏加广点通广告. 1. 下载广点通SDK 广点通网址:http://e.qq.com/dev/index.html 在流 ...
腾讯广点通开屏广告错误码
Android SDK错误码错误码错误类型描述 3XX 具体类型可联系GDT移动联盟排查初始化错误 403 HTTP_STATUS_ERROR HHTP状态码错误:建议检查网络状态 404 T ...
百度SEO站群腾讯短网址w.url.cn生成源码|仿红源码
源码介绍: 腾讯短网址,微信公众号接口w.url.cn短网址生成示例,编辑Creat-dwz.php,修改你的appid和appsecret即可,要求认证的服务号才拥有接口权限,订阅号均无权限使用,可 ...

腾讯广点通接入总结及源码

腾讯广点通接入总结及源码相关推荐

最新文章

热门文章