王尘宇王尘宇

研究百度干SEO做推广变成一个被互联网搞的人

快手短视频广告:H5转化监测代码文档《01》


一、转化监测代码安装

转化监测代码分为两部分,基础代码复制并粘贴到网址代码的<head>和</head>之间,转化代码添加到相应的目标上。

基础代码:

<script type="text/javascript">


        (function (root) {


            var ksscript = document.createElement('script'); ksscript.type = 'text/javascript'; ksscript.async = true;


            ksscript.src = 'https://static.yximgs.com/udata/pkg/ks-ad-trace-sdk/ks-trace.0.0.8.beta.js';


            ksscript.onerror = function () {


                var request = new XMLHttpRequest();


                var cb = (function(t){var e=new RegExp("(^|&)"+t+"=([^&|#]*)(&|#|$)"),n=window.location.href.indexOf('?')>-1?window.location.href.split('?')[1].match(e):null;return null!=n?decodeURIComponent(n[2]):null}('callback'));


                var url = 'https://e.kuaishou.com/rest/log/activate?jsEventType=3&callback=' + cb + '&eventType=4&eventTime=' + Date.now();


                request.open('GET', url, true);


                request.send(null);


            }


            var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ksscript, s);


        })(window);


</script>


转化方式分为以下两种,二选一即可:

1)HTML方式 —— 用户点击某个组件一次就发送一次

转化代码(注意,data-ks-event仅支持click1、click2、click3):


<button type="submit" data-ks-click data-ks-event="click3">提交</button>


2)JS方式 —— 某一事件成功了才会统计,比如申请信用卡,表单提交成功后才发送log,而不是每点击提交按钮一次就发送。

转化代码(注意,event参数为必选参数,参数值仅支持click1、click2、click3;cb参数为可选参数,可以在统计成功后执行回调函数):


_ks_trace.push({ event: 'click3', cb: function(){

console.log('Your callback function here!')

}});


注意,转化代码不能使用在<iframe></iframe>中,否则会无法统计数据。


二、示例


1)    HTML 代码安装:

首先将基础代码复制,添加到您所需转化页面代码的<head>和</head>之间。然后添加转化代码,如:



上图红框代码不一定必须使用<button>,只要你的 Dom 节点中有这些属性就可以了,如:



效果(编写 CSS 后):每当用户点击一次“提交”就统计一次。(注意: 这种方式不能确保表单提交后统计转化,如果预期表单提交后统计转化,请使用 JS 方式添加代码。



2)    JS 代码安装:

首先将基础代码复制,添加到您所需转化页面代码的<head>和</head>之间。然后将转化代码复制到JS 触发事件相关函数中,如:



 【备注】

1.建议使用JS方式,以便确保统计到有效的转化数据;

2.两种代码中的参数值“click1/click2/click3”,建议优先使用“click3”,这样收集到的数据可呈现在投放报表中,“click1/click2”对应的转化数据,快手可正常收集,但目前不呈现在报表中。


三、自助校验


代码安装完成后,可通过以下两种方式进行测试校验,任意一种测试通过即可。建议广告主技术部署代码后直接进行线下校验.


1.线下校验

线下校验是指不经过快手投放系统,直接访问投放落地页进行代码检查校验。

具体步骤如下:

a.    检查快手JS SDK的.js文件是否加载,确认加载后,进行步骤b,否则SDK安装有误;

b.    在投放落地页链接上拼接callback参数,值为123即可(如遇到参数名冲突,请联系快手或使用线上校验方案),浏览器访问拼接后的URL,根据实际转化流程进行操作,完成转化时,是否有一个包含https://e.kuaishou.com/rest/log/activate?jsEventType=12 的请求发出,如果有,则安装正确,否则转化代码未被触发,可排查触发条件是否有误等。


2.线上校验

线上校验是指在快手投放平台开启小量投放进行测试,观察报表是否有统计到转化数据。账户开启投放后,可以使用后台体验功能自助进行线上广告全流程体验,完成转化操作后,如在后台报表看到转化数据,则说明代码安装成功。


 需要注意:

1. 线上投放的落地页链接,不能携带callback参数,否则会影响JS转化数据统计,如有冲突,请联系快手;

2. JS代码须部署在广告投放落地页,如需部署在跳转页面等,请联系快手;

3. 广告投放的落地页URL,访问时如有跳转行为,会影响代码触发及上报,如有需求,请联系快手。


四、Q&A


对接中若遇到问题,可查看Q&A文档,文档中包含了对接注意事项、数据差异原因、报表数据查看等内容,可帮助广告主快速定位并解决问题。



相关文章

评论列表

发表评论:
验证码

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。