芒果 TV JS 布码上报数据文档
目录 一 适用场景... 3 二 新建 js 转化... 3 三 安装代码... 3 四 代码安装示例... 4 五 代码监测...... 6 六 新建投放...... 8 七 常见问题...... 8
一 适用场景 广告主投放自有落地页, 通过在落地页内添加芒果 TV 的 JS 代码来追踪页面内的转化事件 采用该方式追踪时, 您需要在落地页中添加芒果 TV 提供的 JS 代码, 代码检测无误后, 即可上报转化事件, 追踪落地页转化效果 推荐使用场景 : 用户转化行为是在广告主自有的落地页完成 二 新建 js 转化 在芒果启明后台找到数据 -JS 布码转化跟踪, 填写转化名称, 选择转化目标, 然后再提交 具 体操作如下图所示 : 三 安装代码 新建 js 布码后, 平台会给出您需要添加在落地页上的代码 代码分为两部分 : 基础代码 : 添加在您落地页的 <head> 与 </head> 之间, 用于收集与上报转化行为 注意 : 所有需要上报转化的页面中都需要添加基础代码 转化代码 : 添加在用户触发转化行为之后 例如您将某个点击按钮定义为转化行为, 那么用户在点击该按钮后, 通过执行转化代码来通知基础代码, 基础代码收到通知后记录本次转化行为, 发送给芒果 TV 启明, 记录为一个转化 代码分为两部分 : 1. 基础代码 :
添加在您落地 页的 <head> 与 </head> 之间, 用于收集与上报转化 行行为 注意 1: 所有需要上报转化的页面中都需要添加基础代码, 否则会造成转化上报失败 2. 转化代码 : 在广告主的代码中, 添加在用户触发转化行为之后 例如广告主将某个点击按钮定义为转化行为, 那么就把转化代码添加在点击按钮的位置 用户实际访问页面时, 点击该按钮就会触发转化代码, 转化代码会通知基础代码, 基础代码收到通知后记录本次转化行为, 发送给芒果 TV 启明, 记录为一个转化 注意 1:convert_id 值为动态生成的值, 且每次新建转化生成都不一样, 每个落地页需要 配置对应的正确的转化代码 注意 2: 同一个页面在多条广告计划中用于投放时, 可以只创建一个转化跟踪, 芒果 TV 启明可以区分出转化来自哪一个广告投放 注意 3: 上图中红框圈出的部分分别对应所选转化目标对应的事件名称 ( 例如电话拨打对应 phone, 表单提交对应 form), 和当前转化的转化 ID(convert_id), 页面添加转化代码时, 这两个地方填写错误会导致转化上报失败 同一个页面可以添加多个转化代码, 需要注意把所需的事件名称和转化 ID 都填写正确 四 代码安装示例 表单提交 <tite> 转化跟踪 </tite> <!-- 安装基础代码 --> <!-- Mgtv Tracking --> <script> (function() { var mga = document.createeement("script");mga.src = "//tb.mgtv.com/sdk/mg a/stats.js"; mga.setattribute("cid", "914"); var s = document.geteementsbytagname("script") [0]; s.parentnode.insertbefore(mga, s);)(); </script> <!-- End Mgtv Tracking --> <form> 姓名 :<input type="text" name="" pacehoder=" 请输入姓名 " id="uname">
地址 :<input type="password" pacehoder=" 请输入地址 " id="address"> <input type="button" vaue=" 提交表单 " id="btn"> </form> <script type="text/javascript"> window.onoad = function () { var btn = document.geteementbyid("btn"); var uname = document.geteementbyid("uname"); var address = document.geteementbyid("address"); // 点击提交表单按钮 btn.addeventlistener("cick", function () { var xhr = new XMLHttpRequest(); xhr.onreadystatechange = function () { if (xhr.readystate == 4 && xhr.status == 200) { var data = JSON.parse(xhr.responseText); // 判断表单正确提交成功后执行转化代码 if (data.status == "success") { aert(" 表单提交成功 "); // 安装转化代码 ") MgaH5.track("form",{convert_id: "ec65a5fa99f1c081f7dc45bd05e5f122 e + "", true); xhr.open("get", "path/to/fie" + uname.vaue + "&address=" + address.vau xhr.send(); ) </script> 微信复制 <tite></tite> <script type="text/javascript" src="http://ajax.aspnetcdn.com/ajax/jquery/jquery-2.1.1.mi n.js"></script> <!-- 安装基础代码 --> <! Mgtv Tracking --> <script> (function() { var mga = document.createeement("script"); mga.src = "//tb.mgtv.com/sdk/m ga/stats.js"; mga.setattribute("cid", "914"); var s = document.geteementsbytagname("script") [0]; s.parentnode.insertbefore(mga, s);)(); </script> <!-- End Mgtv Tracking -->
<div> <span> 请长按复制 </span> <!-- 当页面有多个微信号时每个微信号都要绑定复制事件 --> <span cass="wei_xin">jk83123</span> <span cass="wei_xin">jk83123</span> <span cass="wei_xin">jk83123</span> </div> <script type="text/javascript"> // jquery 方式 : $(".wei_xin").bind('copy', function(e) { aert(" 复制成功 "); // 复制成功后执行转化代码 MgaH5.track("wechat",{convert_id: "ec65a5fa99f1c081f7dc45bd05e5f122") ); /** js 方式 var weixin = document.geteementsbycassname("wei_xin"); var en = weixin.ength; for (var i = 0;i < en;i++) { weixin[i].i = i; weixin[i].addeventlistener("copy", function() { aert(this.i + " 复制成功 "); // 复制成功后安装转化代码 meteor.track("wechat", { convert_id: "1234567890" ) ); */ </script> 五代码检测 安装完代码后, 您可通过 检测转化上报 功能来判断是否正确安装
检测转化上报可在安装代码后检测, 建议您在 5 分钟内完成检测, 超时需重新开始 基础代码添加不正确的常见原因 1 代码添加位置不正确, 未加在 <head> 与 </head> 之间, 需调整代码 2 未完全参照所提供的基础代码, 存在书写错误, 需检查代码内容 3 页面代码存在报错, 影响基础代码的加载, 需要修复报错问题 4 账号 cid 不符, 请务必填写正确 转化代码添加不正确的常见原因 1. 转化 ID(convert_id) 不符 : 例如您上报的转化 ID 为 12345, 但正确的转化 ID 为 67890, 需修改代码, 上报正确的转化 ID 2. 转化事件 (event_type) 不符 : 例如您上报的转化事件为 button, 但选定转化目标为 phone, 需修改代码, 上报正确的转化事件
码 3. 页面存在跳转, 跳转后的页面未正确安装基础代码, 需要在每个上报转化的页面上都添加基础代 4. 转化代码未放置在转化执行的位置, 代码未生效或生效时机有误, 需修改代码 ( 技术人员可在添 加转化代码的位置加埋点, 确认发生转化行为时, 代码是否正确执行到此处 ) 5. 基础代码的生效时机晚于转化代码, 需修改代码 如广告主修改代码需要重新进行联调 六新建投放 在芒果启明后台找到广告 - 新建广告 - 选择广告系列, 填写落地页地址 ( 落地页地址就是 JS 布码 检测网页 ), 选择开启 JS 转化, 具体操作如下图所示 : 七常见问题 Q1. 数据 gap 广告投放平台转化数比广告主统计的转化数多 一般是广告主转化代码埋点位置不对或者广告主统计的与芒果 TV 启明统计的口径不一致 例 : 1. 广告主把成功提交表单作为一次转化并统计, 而转化代码却埋点在提交按钮的点击上, 所以芒果启明统计的是埋点的位置也就是提交按钮点击的转化数, 与广告主统计的表单提交数不一致 此类情况, 是广告主埋转化代码的位置不对造成, 可在添加转化代码的位置加埋点, 以便查找转化上报与转化统计不一致的原因
2. 选择微信复制作为转化目标的广告主, 经常用微信号的复制数与实际加粉数做对比 首先广告主如果埋点在微信号的复制上, 那就应该用他们收集的复制数据来和广告投放平台的数据做对比, 而不是实际的加粉数, 实际的加粉数和复制的数量是两个概念, 不能对比 3. 广告主突然转化数突增爆量导致转化率高消耗很高, 一般是因为广告主修改了页面, 造成转化突然增长 Q2. 数据 gap 广告投放平台转化数比广告主统计的转化数少或不稳定( 有时正常有时数量少 ) 一般是广告主统计的与芒果 TV 启明统计的口径不一致 例 : 1. 广告主的统计的口径是所有来源 ( 包括浏览器或其他平台 ) 的转化数, 没有区分是否是来自广 告投放平台的转化数 我们统计的是在投放 app 内产生的转化 Q3: 联调问题 为什么在检测转化上报过程中显示代码安装有误, 但实际投放时转化数据没有问题? 检测转化上报功能是为了帮助检测代码安装情况, 但是可能会因为页面结构和设置问题, 导致 无法正常检测 如果实际投放时转化数据没有问题, 可跳过检测过程