腾讯广告-web转化数据api自归因对接记录

news2024/11/26 22:40:40

文章目录

前言
一、参考文档记录
二、使用步骤
- 1.整体流程（可以根据官方最新的文档来做）
- 2.关于上报代码参考
- 3.关于uniapp网页在history模式下接收不到url参数的问题
总结

前言

项目中需要做对扫码加粉的监测，于是用到了腾讯广告的Web转化数据API自归因功能对接，这个功能需要开发人员跟运营打好配合，第一次写遇到了很多不理解的内容，也踩了不少的坑，最终得以实现。

提示：以下是本篇文章正文内容，下面案例可供参考

一、参考文档记录

官方文档：广告点击
官方文档：web转化数据api自归因
联调测试类文档：广告在线预览
参考文档：腾讯广点通广告投放-转化归因API回传接口对接踩坑指南
参考文档：【腾讯广告】监测链接和API自归因回传接口逻辑

二、使用步骤

1.整体流程（可以根据官方最新的文档来做）

新建广告
配置转化归因网页链接
配置监测链接（这个链接是后端的接口地址（用来接收点击广告时，腾讯回调传过来的数据），链接格式如下： https://xxx.com/data-nexus/ad-back/?account_id=ACCOUNT_ID&click_id=CLICK_ID&click_time=CLICK_TIME&callback=CALLBACK&request_id=REQUEST_ID）最后这个参数request_id是请求id,可以跟点击广告跳转到二跳页面时传的参数traceid对应上，为数据上报做准备。
根据获取到的回调参数和前台页面下发的参数作对应，对应上后进行数据上报
在线预览，进行测试，腾讯平台显示归因成功，即完成归因了

这个是h5落地页自归因的一些内容，至于运营那边建立蹊径落地页，添加二跳地址等这边就不多讲了

2.关于上报代码参考

参考官方文档，把重要参数传过去就行，比如cb,clickid等，这一步最好是在后端做处理，前端做的话会存在跨域问题。

在这里插入图片描述
新建转化归因时生成的示例代码如下

curl -X POST \
http://tracking.e.qq.com/conv \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
   "actions":[
        {
        "outer_action_id": "outer_action_identity", // 客户唯一行为id
        "action_time": 1492998081,
        "user_id": { // user_id，可采集到的设备标示
        "hash_imei": "f9efca36a3c30e1cf28170d86ecbf5e9",
        "hash_idfa": "f9efca36a3c30e1cf28170d86ecbf5e9",
        "hash_android_id": "",
        "wechat_openid":"", // wechat_openid 和 wechat_unionid 二者必填一
        "wechat_unionid":"", // 企业微信必填
        "wechat_app_id":"", // 微信类上报必填，且必须通过授权。授权请参考微信数据接入
        "oaid":""
        },
        "action_type": "", // 必填 行为类型
        "url": "www.my.com", // Web必填 网页域名。其他选填
        "trace": {
        "click_id":"abc" // 必填 请将点击id/曝光id填充在 click_id字段上报。企业微信选填
        },
        "action_param": {
        "value": 123,
        "int_example": 123,
        "int_array_example": [
         123,
         234
        ],
        "string_example": "123",
        "string_array_example": [
        "123",
        "234",
        "abc"
         ]
       }
    }
   ]
}'

获取到的数据大概长这个样，request_id是后来加的没截图，腾讯的文档里并没有提这个字段，也是运气好蒙对了，正好能对应上，要不还得浪费更多时间去查去试用，另外监测链接那里填的字段好像必须是它文档里规定的那些字段，不然会显示不符合之类的，小小吐槽一下，客服工单的回应速度是真的慢，等的时间差不多自己就研究出来了（费劲巴拉的，友情建议对接的时候耐心多一点）
在这里插入图片描述