线索类JS上报快手广告平台

于 2023-11-30 由 emer 发布

采用该方式追踪时，您需要在落地页中添加快手提供的JS代码，代码检测无误后，即可上报转化事件，追踪落地页转化效果。推荐使用场景：用户转化行为是在落地页完成。

一、使用前注意事项
快手广告转化追踪JS代码统计“表单”以及“微信复制”这两种转化事件。

二、对接流程

在后台“工具-转化追踪-追踪线索-新建JS布码”，创建JS代码的转化追踪目标，创建好后会生成一套JS代码。（包括基础代码和转化代码两部分，每个转化代码有独立的ID）；
按照安装代码说明直接部署，避免自行改动代码导致的无法正常部署（基础代码安装在页面的head之间，转化代码在转化事件成功发生时再调用）；
按照下方“线下校验”的流程自行先离线校验，确保看到相关请求正确上报，再使用后台的联调工具进行线上联调，联调成功后转化状态变成已激活，未激活状态不可用于广告投放；
线上联调通过后，创建广告组时，在落地页链接的输入框下方，务必选择对应的转化目标，否则投放时报表不做统计。填写在投放系统的落地页不要携带uniqueKey或者callback参数，快手会自动添加。

三、安装代码
在投放平台填写转化名称后，平台会给出您需要添加在落地页上的代码。代码分为两部分：

基础代码
添加在您落地页的HEAD之间，用于收集与上报转化行为。注意：所有需要上报转化的页面中都需要添加基础代码。

<script type="text/javascript">
(function (root) {
var ksscript = document.createElement('script');
ksscript.setAttribute('charset', 'utf-8');
ksscript.src = 'https://p1-yx.adkwai.com/udata/pkg/ks-ad-trace-sdk/ks-trace.3.2.0.min.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ksscript, s);
})(window);
</script>

转化代码

_ks_trace.push({
event:"form",
convertId:convertid,
cb:function(){
    console.log('Your callback function here!')
}
});

备注：
1) cb参数为可选参数，可以在统计成功后执行回调函数；
2) 转化代码不能使用在iframe中，否则会无法统计数据。
代码安装示例：

<html lang="en">
<head>
<meta charset="UTF-8"/>
<meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=no"/>
<link rel="icon" href="image/moli32_32.ico" type="image/x-icon"/>
<script src="js/jquery-1.8.3.min.js"></script>
<title></title>
<script type="text/javascript">
(function (root) {    
    var ksscript = document.createElement('script');    
    ksscript.setAttribute('charset', 'utf-8');   
    ksscript.src = 'https://p1-yx.adkwai.com/udata/pkg/ks-ad-trace-sdk/ks-trace.3.2.0.min.js';    
    var s = document.getElementsByTagName('script')[0];   
    s.parentNode.insertBefore(ksscript, s);
})(window);
</script>
</head>
<style>
*{
    margin: 0px;
    padding: 0px;
    list-style: none;
    text-decoration: none;
}
.imgs{
    margin:0 auto;
    display:block;
    width:390px;
    height:auto;
}
.img1{
    margin:0 auto;
    display:block;
    width:100%;
    height:auto;    
}
</style>
<body>
<div style="margin:0 auto;">
    <form class="imgs">
            <img id="lingqu" class="img1" src="image/1.png" alt="图片">           
    </form>
</div>
</body>
</html>
<script>
$("#lingqu").on("click", function (){
    var pin = encodeURIComponent(getUrlParam('pin'));
    var _id = getUrlParam('id');
    var convertid = getUrlParam('convertid');   
    $.ajax({
        url: "../index.php?admin=0&dir=first&php=wxauth",
        type: "POST",
        data: {
            id: _id,
            pin: pin
        },
        dataType: 'json',
        headers: {
            'X-Requested-With': 'XMLHttpRequest'
        },
        success: function (res) {
            _ks_trace.push({
                event:"form",
                convertId:convertid,
                cb:function(){
                    console.log('Your callback function here!') 
                    if (res.code == 1) {
                        window.location.href = res.data.url;
                    }else{
                        alert(res.msg);
                    }
                }
            });
        }
    })
})
function getUrlParam(name) {
    var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)"); //构造一个含有目标参数的正则表达式对象
    var r = window.location.search.substr(1).match(reg); //匹配目标参数
    if (r != null) return unescape(r[2]);
    return null; //返回参数值
}
</script>

基础代码添加不正确的常见原因：
• 代码添加位置不正确，未加在HEAD之间，需调整代码
• 未完全参照所提供的基础代码，存在书写错误，需检查代码内容
• 页面代码存在报错，影响基础代码的加载，需要修复报错问题
• 基础代码被嵌套在iframe中（不支持的使用方式，需更换使用方法）
转化代码添加不正确的常见原因：
• 转化ID（convert_id）不符：例如您上报的转化ID为12345，但正确的转化ID为67890，需修改代码，上报正确的转化ID
• 转化事件（event_type）不符：例如您上报的转化事件为button，但选定转化目标为phone，需修改代码，上报正确的转化事件
• 转化代码未放在转化执行的位置，代码未生效或生效时机有误，需修改代码（技术人员可在添加转化代码的位置加埋点，确认发生转化行为时，代码是否正确执行到此处）
• 基础代码的生效时机晚于转化代码，需修改代码
• 转化代码被嵌套在iframe中（不支持的使用方式），需修改代码

参考：线索类JS上报

分类：技术
标签： HTML 编程 js PHP API 快手

0条评论

发表评论