当您选择以这种方式进行追踪时，需在落地页中添加由快手提供的 JS 代码。在代码检测准确无误后，便可上报转化事件，从而追踪落地页的转化效果。其推荐使用场景为：用户的转化行为在落地页完成。
一、使用前的注意要点
快手广告转化追踪的 JS 代码会对“表单”以及“微信复制”这两类转化事件进行统计。
二、对接流程
1.于快手广告后台的“工具 – 转化追踪 – 追踪线索 – 新建 JS 布码”中，创建 JS 代码的转化追踪目标。创建完成后，会生成一套 JS 代码（涵盖基础代码和转化代码两部分，每个转化代码均有独立的 ID）。
2.依照安装代码的说明直接部署，切不可自行改动代码，以免导致无法正常部署（基础代码需安装在页面的 <head></head> 之间，转化代码则在转化事件成功发生时进行调用）。
3.按照下方“线下校验”的流程先行离线校验，确保能看到相关请求正确上报。之后，再运用快手广告后台的联调工具进行线上联调。联调成功后，转化状态会变为已激活，未激活状态不可用于广告投放。
4.线上联调通过后，创建广告组时，在落地页链接的输入框下方，务必选择对应的转化目标。否则，投放时报表将不予统计。填写在投放系统的落地页不可携带 uniqueKey 或者 callback 参数，快手会自动添加。
三、安装代码
在投放平台填写转化名称后，平台会为您提供需添加至落地页的代码。代码分为以下两部分：
1.基础代码
添加在落地页的 <HEAD> 与 </HEAD> 之间，用于收集和上报转化行为。需注意：所有需上报转化的页面都要添加基础代码。
<script type="text/javascript">
(function (root) {
var ksscript = document.createElement(‘script’);
ksscript.setAttribute(‘charset’, ‘utf-8’);
ksscript.src = ‘https://static.yximgs.com/udata/pkg/ks-ad-trace-sdk/ks-trace.2.0.1.beta.js’;
var s = document.getElementsByTagName(‘script’)[0];
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 </iframe> 中，不然会无法统计数据。
代码安装示例
3.基础代码添加有误的常见原因：
代码添加的位置不正确，未添加在 <HEAD> 与 </HEAD> 之间，需调整代码位置。
未完全依照所提供的基础代码，存在书写错误，需检查代码内容。
页面代码存在报错，影响基础代码的加载，需要修复报错问题。
基础代码被嵌套在 iframe 中（不被支持的使用方式，需更换使用方法）。
4.转化代码添加有误的常见原因：
转化 ID（convert_id）不匹配：例如您上报的转化 ID 为 12345，但正确的转化 ID 为 67890，需修改代码，上报正确的转化 ID。
转化事件（event_type）不相符：例如您上报的转化事件为 button，但选定转化目标为 phone，需修改代码，上报正确的转化事件。
转化代码未放置在转化执行的位置，代码未生效或生效时机有误，需修改代码（技术人员可在添加转化代码的位置加埋点，确认发生转化行为时，代码是否正确执行到此处）。
基础代码的生效时机晚于转化代码，需修改代码。
转化代码被嵌套在 iframe 中（不支持的使用方式），需修改代码。
四、转化代码触发原理
1.在进行广告投放时，快手会自动在落地页 URL 上拼接 callback 参数（广告 ID）。
2.需确保转化代码触发时，页面 URL 带有 callback 参数，且基础代码已成功加载完成，否则代码无法正常触发。因此，建议广告组填写的落地页 URL 和代码触发的页面 URL 为同一页面，不建议发生跳转。若需跳转至其他页面发生转发行为时，请广告主自行将 callback（正式投放环境自动添加）和 uniqueKey（仅线上联调环境自动添加）的参数和参数值携带到触发转化代码时页面的 url 上。
五、联调流程
1.离线联调
a.直接访问落地页 URL，检查快手 JS 监测代码 SDK 的.js 文件（https://static.yximgs.com/udata/pkg/ks-ad-trace-sdk/ks-trace.xxx 版本号 xx.beta.js）是否加载，确认加载后，进行步骤 b，否则基础代码安装有误。
b. 在投放落地页链接上拼接 callback 参数，值为 123 即可（如遇参数名冲突问题，请联系快手），通过浏览器访问拼接后的 URL，依照实际转化流程进行操作。在完成转化时，查看是否有一个包含 https://le.kuaishou.com/rest/loglactivate?eventType=9 的请求发出，如果有，则安装正确，否则转化代码未被触发，可排查触发条件是否有误等。
2.线上联调
a.从“工具 – 转化追踪 – 追踪线索 – 新建 JS 布码”的界面，找到相应的转化目标，“点击右侧详情 – 点击页面下方去激活”开始联调。
b.联调时填写的页面需要部署当前转化目标的代码，且尽量与后续投放使用的落地页 URL 保持一致。
c.点击开始检测，会打开新的窗口（URL 上拼接的 uniqueKey 参数相当于投放时拼接的 callback 参数）。
d.基础代码检测完成后，会生成页面二维码，用于转化代码检测，使用移动设备扫码完成后续操作即可。
3.创建广告组时关联转化追踪
JS 转化追踪创建完并激活后，在创建广告组时即可进行关联。当累积到一定量的转化次数后，再次创建广告组时，就能够选择该转化目标作为优化目标进行投放。关联方式如下图所示。
六、数据差异优化方案
在对接过程中，有时会由于页面跳转过快，导致转化代码未成功执行，页面就发生跳转，致使转化数据未能成功上报。目前可提供的优化方案如下：
1.在转化代码外层添加一层延时函数，延时 500 毫秒再跳转。
2.运用转化代码中的 cb 参数，增加回调函数，在收到快手的回调后，再进行页面跳转或下一步操作。
3.将代码部署到二跳页（通常是成功页），在页面加载时执行转化代码。此方案需要广告主对二跳页 URL 进行特殊处理。
4.采用落地页 API 的方式，广告主技术按照文档拼接请求，通过 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 中的渠道参数进行了校验，不符合规则的无法触发快手代码，需要广告主技术协助提供渠道参数正确的投放链接（这是最常见的原因）。
2.快手广告后台填写的落地页链接和技术添加代码的页面不一致，例如“页面部署了 A 转化目标的代码，但广告组却选择了 B 转化目标”或“运营填写的落地页链接并非广告主技术部署代码的页面”等场景。
3.报表中需查看“落地页数据”中“表单提交数”一列。
4.广告组未正确关联转化目标。
Q:无法激活怎么办？
A:首先确保网页转化追踪代码安装正确，其中，下图步骤 1 的 js 脚本（版本以投放平台为准）需要保证在业务逻辑执行前加载。如果是单页面应用，把 script 标签里的逻辑放到单页面应用的入口文件执行即可。
然后检查是否有对应网络请求发出，在 network 面板查看请求是否发出，即可判断埋点是否成功上报。
联调/激活上报 url: https://ad.e.kuaishou.com/adsljs-convert-check/activate
如果触发对应行为后，在浏览器网络面板下能看到上述请求，说明激活的流程没有问题。此时若一直提示激活不成功，可以先检查一下，买点上报的 convertld 和要激活的转化追踪的 id 是否一致，只有两者一致，才能激活。
如果埋点代码的 convertld 和转化追踪的 id 一致，也能看到有上述请求发出，还是无法激活成功，请联系开发人员支持。
请注意：当您确认转化追踪代码的安装准确无误后，若后续对落地页代码进行了修改，请再次对转化追踪进行检测，以确保您的修改未影响转化数据的正确回传。
2 本站部分内容来源于网络，仅供学习与参考，如有侵权，请联系网站管理员删除
3 本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
4 精准获客感谢您的访问！希望本站内容对您有所帮助！
暂无评论内容