标准版小程序SDK接入指南

1.1 配置 SDK


下载 SDK,将解压得到的文件 ald-stat.jsald-stat-conf.js 拷贝到小程序项目的 utils文件夹中。

使用编辑器打开 ald-stat-conf.js 文件,填写在阿拉丁申请的 app_key并配置pluginfalse

  //ald-stat-conf.js
  exports.app_key = ""; //请在引号中填写从阿拉丁后台获取的appkey
  exports.getLocation = false; //默认不获取用户坐标位置
  exports.plugin = false;  //您的小程序中是否使用了插件。根据是否启用插件会有不同的接入方式,请参考文档文档。

在app.js中引入SDK,将下段代码放到app.js顶部

// app.js
const ald = require('./utils/ald-stat.js')

1.2 添加微信request合法域名

管理员或开发者身份在微信小程序后台→设置→开发者设置中添加 request合法域名log.aldwx.com

1.3 检查是否集成成功

在小程序开发编辑器中,查看控制台中的Network是否有信息上报,且status状态为200。

1.4 接入完成

请注意:二维码和分享的相关数据需要在已部署阿拉丁 SDK 的小程序正式发布以后才可 以查看到。

二. 高级功能

2.1 事件功能

仅需统计事件,不统计参数时,可使用如下方法:

aldstat.sendEvent();
参数 类型 描述
事件名称 string 描述用户的动作名称,不超过255个字符,支持特殊字符
参数 string 动作的参数,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)
参数值 string 动作的参数值,不超过255个字符,支持特殊字符但不包括(英文逗号 , 英文冒号 : 点 .)

如何在App周期内进行埋点

//app.js
var ald = require('./utils/ald-stat.js');
var startTime = Date.now();//启动时间
App({
  onLaunch: function () {
  },
  onShow : function(){
    // 比如记录小程序启动时长
    this.aldstat.sendEvent('小程序的启动时长',{
      time : Date.now() - startTime
    })
  },
  globalData: {
    userInfo: null
  }
})

如何在Page周期内进行埋点

//index.js
var app =  getApp();
Page({
  data : {
      // ...
  },
  onLoad(){
      // ...
  }

  onShow : function(){
      // ...
  },
  // 支付
  pay(){
      // ....
      app.aldstat.sendEvent('支付',{
        "用户ID" : "123456",
        "支付金额" : "8000",
        "商品"    : "iphoneX"
        // ....
      })
    },
    // 记录小程序内,某个tab或者按钮被用户点击的次数。 可对小程序热点功能进行分析
    searchFocus(){
      app.aldstat.sendEvent('用户点击了搜索')
      // 或者
      app.aldstat.sendEvent('用户行为','点击了搜索输入框')

    }
})

检查自定义埋点是否上报成功,在开发者工具中

2.2 设置是否获取用户坐标(可选)

阿拉丁统计 SDK 默认不会在小程序启动时获取用户的坐标信息。
请注意:
a.不获取用户坐标信息会影响用户地域分布的分析准确性;
可以通过修改配置文件启用这两项功能:使用编辑器打开ald-stat-conf.js 文件,修改 getLocation(位置信息)配置项为 true 即可开启应功能(缺省为 false,即关闭)。

© aldwx.com 北京阿拉丁未来科技有限责任公司 all right reserved,powered by Gitbook修订时间: 2018-12-13 10:30:52

results matching ""

    No results matching ""