采用该方式追踪时，您需要在落地页中添加快手提供的JS代码，代码检测无误后，即可上报转化事件，追踪落地页转化效果。推荐使用场景:用户转化行为是在落地页完成。
一、使用前注意事项
快手广告转化追踪JS代码统计“表单"以及"微信复制"这两种转化事件。
二、对接流程
1.在快手广告后台“工具-转化追踪-追踪线索-新建JS布码”，创建JS代码的转化追踪目标，创建好后会生成一套JS代码。(包括基础代码和转化代码两部分，每个转化代码有独立的ID);
⒉.按照安装代码说明直接部署，避免自行改动代码导致的无法正常部署(基础代码安装在页面的<head></head>之间，转化代码在转化事件成功发生时再调用);
3.按照下方"线下校验"的流程自行先离线校验，确保看到相关请求正确上报，再使用快手广告后台的联调工具进行线上联调，联调成功后转化状态变成已激活，未激活状态不可用于广告投放;
4.线上联调通过后，创建广告组时，在落地页链接的输入框下方，务必选择对应的转化
目标，否则投放时报表不做统计。填写在投放系统的落地页不要携带uniqueKey或者callback参数，快手会自动添加。
三、安装代码
在投放平台填写转化名称后，平台会给出您需要添加在落地页上的代码。代码分为两部分:
1.基础代码
添加在您落地页的<HEAD>与</HEAD>之间，用于收集与上报转化行为。注意:所有需要上报转化的页面中都需要添加基础代码。
<script type="textljavascript">
(function (root) {
var ksscript = document.createElement('script');ksscript.setAttribute('charset', 'utf-8');
ksscript.src = 'https:llstatic.yximgs.com/udata/pkg/ks-ad-trace-sdk/ks-trace.2.0.1.beta.js';var s = document.getElementsByTagName('script')[O];
s.parentNode.insertBefore(ksscript, s);
})(window);
</script>
2.转化代码
_ks_trace.push({event: "form', convertld: xxxxxx, cb.: function(){console.log(Your callback function herel'))
备注:
1) cb参数为可选参数，可以在统计成功后执行回调函数;
2)转化代码不能使用在<iframes </liframe>中，否则会无法统计数据。
代码安装示例
3.基础代码添加不正确的常见原因:
代码添加位置不正确，未加在<HEAD>与</HEAD>之间，需调整代码
未完全参照所提供的基础代码，存在书写错误，需检查代码内容
页面代码存在报错，影响基础代码的加载，需要修复报错问题
基础代码被嵌套在iframe中(不支持的使用方式，需更换使用方法)
4.转化代码添加不正确的常见原因:
转化ID(convert_id)不符:例如您上报的转化ID为12345，但正确的转化ID为67890，需修改代码，上报正确的转化ID
转化事件(event_type)不符:例如您上报的转化事件为button，但选定转化目标为phone，需修改代码，上报正确的转化事件
转化代码未放在转化执行的位置，代码未生效或生效时机有误，需修改代码(技术人员可在添加转化代码的位置加埋点，确认发生转化行为时，代码是否正确执行到此处)
基础代码的生效时机晚于转化代码，需修改代码
转化代码被嵌套在iframe中(不支持的使用方式)，需修改代码
四、转化代码触发原理
1.广告投放时，快手会自动在落地页URL上拼接callback参数(广告ID);
⒉需要确保转化代码触发时，页面URL带有callback参数，且基础代码已成功加载完成，否则代码无法正常触发。故建议广告组填写的落地页URL和代码触发的页面URL是同一页面，不建议发生跳转。若需要跳转至其他页面发生转发行为时，请广告主自行将callback(正式投放环境自动添加)和uniqueKey(仅线上联调环境自动添加)的参数和参数值携带到触发转化代码时页面url上。
五、联调流程
1.离线联调
a.直接访问落地页URL，检查快手JS监测代码SDK的.js文件（https:lstatic.yximgs.com/udata/pkg/ks-ad-trace-sdk/ks-trace.xxx版本号xx.beta.js）是否加载，确认加载后，进行步骤b，否则基础代码安装有误;
b. 在投放落地页链接上拼接callback参数，值为123即可(如遇到参数名冲突问题，请联系快手)，浏览器访问拼接后的URL，根据实际转化流程进行操作，完成转化时，是否有一个包含https:lle.kuaishou.com/rest/loglactivate?eventType=9的请求发出，如果有，则安装正确，否则转化代码未被触发，可排查触发条件是否有误等。
2.线上联调
a.从“工具-转化追踪-追踪线索-新建JS布码”的界面，找到相应的转化目标，“点击右侧详情-点击页面下方去激活”开始联调;
b.联调时填写的页面需要部署了当前转化目标的代码，且尽量与后续投放使用的落地页URL一致;
c.点击开始检测，会打开新的窗口(URL上拼接的uniqueKey参数相当于投放时拼接的callback参数);
d.基础代码检测完成后，会生成页面二维码，用于转化代码检测，使用移动设备扫码完成后续操作即可。
3.创建广告组时关联转化追踪
JS转化追踪创建完、并激活后，在创建广告组时就可以进行关联了。当累积够一定量的转化次数后，再次创建广告组时，就可以选择该转化目标为优化目标进行投放。关联方式如下图所示。
六、数据差异优化方案
对接时，有时会出现因为页面跳转过快，导致转化代码未成功执行，页面就发生跳转，这样，转化数据未能成功上报。目前可提供的优化方案:
1.转化代码外面套—层延时函数，延时500毫秒再跳转;
⒉.使用转化代码中的cb参数，增加回调函数，收到快手的回调后，再进行页面跳转或下—步操作;
3.代码部署到二跳页(通常是成功页)，页面加载时执行转化代码，这一方案需要广告主对二跳页URL进行特殊处理;
4.使用落地页APl的方式，广告主技术按照文档拼接请求，通过JS代码或服务器上报落地页的转化数据。
七、返回信息
数据格式:JSON返回样例:
上报成功
{"result": 1,"host-name": "bjm7-rs514.jxq"}
result为1即表示上报成功，
host-name信息可忽略
上报失败
{"result":10001 , "error_msg":
"缺少参数callback" ,"host-name":"bjm7-rs514.jxq"}
host-name信息可忽略
上报失败
{"result":10002,"error_msg":"参数purchaseAmount类型错误，
参数类型应为long" ," bjm7-rs514.jxq"}
host-name信息可忽略
上报失败
{"result":10005,"error_msg":"callback字段不合法" ,
"bjm7-rs514.jxq"}
host-name信息可忽略
上报失败
{"result":20001 , "error_msg":"内部错误，
请稍后重试"."host-name":"bjm7-rs514.jxq""}
host-name信息可忽略
八、常见问题
Q:转化代码可以部署在非落地页吗?
A:可以，有以下两种方法可以实现:1.落地页及各个中间跳转页均需要部署基础代码;2.自行抓取URL上的callback参数(线上联调时为uniqueKey参数）并存储，转化事件成功发生时，自行拼接请求上报。
Q:落地页URL可以使用包了一层监测代码的页面可以做对接吗?
A:如果落地页URL外面包了一层监测代码，投放时快手会把callback参数拼接到监测链接末尾，需要广告主技术自行获取，并传递到后续页面的URL上，否则转化代码无法正常触发。
Q:请求上报后，请求的Respone里面有提示"result":11 ,"error_msg""请检查下网络连接是否正常"，影响上报吗?
A:请求状态码为200即可，可忽略这部分信息。
Q:快手广告后台看不到转化数据?
A:常见的几点原因:1.广告主在部署代码时，对URL中的渠道参数加了校验，不符合规则的不能触发快手代码，需要广告主技术协助提供渠道参数正确的投放链接（*常见原因);
⒉.快手广告后台填写的落地页链接和技术添加代码的页面不一致，如“页面部署了A转化目标的代码，但广告组却选择了B转化目标"或"运营填写的落地页链接并非广告主技术部署代码的页面"等场景;
3.报表中需查看"落地页数据"中“表单提交数"一列;
4、广告组未正确关联转化目标。
Q:无法激活怎么办?
A:先确保网页转化追踪代码安装正确，其中，下图步骤1的js脚本(版本以投放平台为准)需要保证在业务逻辑执行前加载。如果是单页面应用，把script标签里的逻辑放到单页面应用的入口文件执行可。
然后检查有没有对应网络请求发出，在network面板查看请求是否发出，即可判断埋点是否成功上报。联调/激活上报url: https:/llad.e.kuaishou.com/adsljs-convert-check/activate
如果触发对应行为后，在浏览器网络面板下能看到上述请求，说明激活的流程是没问题的。这时候如果一直提示激活不成功，可以先检查一下，买点上报的convertld和要激活的转化追踪的id是否一致，只有两者一致，才能激活。
如果埋点代码的convertld和转化追踪的id一致，也能看到有上述请求发出，还是无法激活成功，请联系开发人员支持。
请注意:当您对转化追踪代码的安装正确性、检测通过后，若您后续对落地页代码进行了修改，请再次对转化追踪进行检测，确保您的修改没有影响转化数据的正确回传
本文标题：快手推广线索类JS上报 | 快手开户后台
本文链接：https://www.eatui.cn/xinxiliu/15610.html
