小程序

腾讯有数数据统计小程序端接入记录

2020-03-19  本文已影响0人  Haraway

  腾讯有数是由腾讯智慧零售推出，为品牌商、零售商打造的数据分析与管理平台，融合腾讯数据、技术与生态优势，提供全链路经营数据分析、消费者洞察、精准营销等能力，让企业经营更“有数”。

1 SDK引入

1.1 获取 SDK，将该SDK下载后重命名，引入小程序工程中，如下图。

图片.png

1.2 添加可信域名

  登录微信公众平台，进入<开发><开发设置><服务器域名>，将 https://zhls.qq.com 添加为 request 合法域名。

  在开发环境中还有SDK版本检查，所以会提示 https://sr-home-1257214331.cos.ap-guangzhou.myqcloud.com 不在以下 request 合法域名列表中 , 可以通过设置不校验域名来处理。

2 init 初始化

init(options: object)

  配置接口，用来调整SDK的基础机制。官方建议init初始化应该在App()调用之前调用，如果自己改造，只要测试通过即可。

  在app中初始化如下：

let sr = require('./libs/sr-sdk-wxapp.js').init({ // 腾讯有数,建议在App()调用之前调用。
  appid: 'wxxxx', // 微信小程序appID，以wx开头
  token: 'bidxxx', // token是唯一必须配置的参数，请联系有数数据服务sr_data_service@tencent.com提供
  trackApp: true, //SDK 默认上报小程序的 启动 、显示 、隐藏 事件， false 关闭该功能。
  proxyPage: true, // 是否开启自动代理 Page，默认是：false。
  usePlugin: true,// 是否使用插件，默认是：false。
  debug: true
})

3 数据上报

  有数小程序数据上报SDK是一个小程序环境的数据采集工具，它提供了简单的接口帮助你快速将数据接入数据中心。

通过 track 上报行为图例

3.1 App 相关

  SDK 默认上报小程序的 启动 、显示 、隐藏 事件，可以在初始化的时候配置 trackApp: false 关闭该功能。

3.2 Page 相关

  注意：在小程序里有如下几种异步数据容易导致问题：通过wx.login获取 openid ，通过wx.getShareInfo获取 openGId 。

3.3 Element相关

3.3.1 方法一：SDK上报(详见官方文档：事件元素上报)

  通过这种手动埋点的方式对代码有较强的侵入性，另外，由于PM会频繁调整埋点信息，而埋点是一个繁琐又无聊的工作，基于Don't Repeat Yourself 原则，可以采用方法二自动埋点方案。

sr.track('element',
{
    "type": "change",
    "element_id": "secKillPage-banner1_1",
    "index": "1",
    "name": "秒杀页面-轮播1_1",
    "page": "pages/product?sku_id=AOdjf7u",
    // more...
})

3.3.2 方法二：配置上报（实现原理参考文档：xbosstrack 小程序自动埋点）

  实现思路：监听用户点击或方法调用-->读取埋点配置JOSN，判断是否需要上报--> 上报数据

  目前已实现监听页面和组件中的元素点击事件或方法调用，自动上报埋点数据。

  使用时需添加需要埋点的点击事件上报如下。

const trackConfig = [{
    title: '会员商城首页',
    path: 'pages/Home/Home',
    elementTracks: [{//这是页面中的元素点击配置
      element: '.home-page',
      elementName: '首页点击埋点测试',
      dataKeys: ['env1'],
    }, {
      element: '.home-contact>>>.lxkf',//这是组件中的元素点击配置
      elementName: '首页组件中点击埋点测试',
      dataKeys: ['level'],
    }],
    methodTracks: [{
      method: 'initHomePage',
      element: 'initHomePage',
      elementName: '首页方法埋点测试',
      dataKeys: ['addtominiprogram'],
    }],
    comMethodTracks: [{
      method: 'getLevel',
      element: 'getLevel',
      elementName: '首页组件中方法埋点测试',
      dataKeys: ['ysf'],
    }]
  }
export default trackConfig;

  另外，使用时要在需埋点页面wxml最外层插入监听方法。示例：

<view catchtap='elementTracker'>
    
</view>

  通过配置上报完成有数通用点击事件埋点，例如点击立即购买按钮时，上报数据示例如下：

courseId: "1"
element_id: ".list-item"
index: "1"
lesson: 2
name: "课程章节"
page: "pages/Course/CourseList/CourseList?courseId=1"
page_title: "课程列表"
sr_sdk_version: "1.1.8"
time: 1587535443662
type: "tap"

3.4 用户身份上报

  有数要求所有的上报接口必须上报open_id，但允许部分行为可能产生无法获得 open_id, page 为空的情况

  用户注册行为 register_wxapp，绑定手机号看成是注册，用户授权手机号获取到userId后上报用户userId。

  用户登录行为 login_wxapp，在获取到用户unionid登录后上报用户unionId。

  接入时在需要上报用户指定身份信息上报的位置调用指定公共方法即可，调用方法如下：

// 设置每个上报必须的用户信息
        sr.setUser({
          open_id: openId,//必传，字符串类型
          union_id: unionId',//非必传，字符串类型
          user_id: userId'//非必传，字符串类型
        })

3.5 渠道上报

  有数要求所有的上报接口必须上报chan_wxapp_scene：小程序场景值。
  如果未使用自定义渠道手动设置上报，则有数SDK会自动获取渠道信息上报。

  渠道可用于区分流量来源。主要分为三种渠道类型：场景值渠道、引流渠道、自定义渠道。

  其中引流渠道ID由有数后台-渠道管理-新增渠道时系统生成，有数渠道管理后台地址传送门： https://lingshou.tencent.com；

  由于有数渠道参数使用场景值带参方式，需要兼容原自定义带参，在扩展页面类 onLoad方法中添加公共场景值取参方法如下：

      if (options.scene) { //如果获取到场景值，则将场景值取出赋值给自定义参数
        let scene = decodeURIComponent(options.scene).split('&')
        let param = {}
        for (let i in scene) {
          let item = scene[i].split('=')
          let itemKey = item[0]
          let itemVal = item[1]
          options[itemKey] = itemVal
        }
      }

总结记录

  关于自动化埋点方案可参考Github：https://github.com/XieXiePro/XP-MINI-Track

上一篇下一篇

猜你喜欢

热点阅读