小程序接入

在您的微信小程序中快速接入 456 数据,全面了解用户行为,驱动业务增长。

快速开始

1
注册账号
创建应用获取打点地址和应用编号
2
下载 SDK
集成 微信小程序 SDK 到您的小程序
3
验证接入
验证数据是否正常上报
4
查看数据看板
实时查看访客数据

1. 注册账号

登录 456 数据控制台,在「我的应用」中点击「创建应用」,然后点击该应用「操作」列里的「统计代码」,在弹出的窗口里获取您的 打点地址和应用编号。

2. 下载 微信小程序 SDK

方式一:npm 安装(推荐)
代码示例
npm install 456data-miniprogram

微信原生小程序安装后,需在微信开发者工具中点击「工具 → 构建 npm」。

方式二:下载 js 文件

微信原生小程序 sdk:请点击 这里 下载

uniapp/taro/Wepy 版 sdk:请点击 这里 下载

3. 初始化 SDK

SDK 需在 App() 调用之前引入:微信原生小程序、taro 在 app.js 中引入,uniapp 在 main.js 中引入,Wepy 在 app.wpy 中引入。

npm 安装:微信原生小程序使用 require('456data-miniprogram');uniapp/taro/Wepy 使用 import yhxwfx456 from '456data-miniprogram/uniapp'。

下载 js 文件:将 yhxwfx456data_wxapp.js 或 yhxwfx456data_uniapp.js 放在小程序的 utils 目录下,按下方示例引入。

代码示例
var yhxwfx456 = require('utils/yhxwfx456data_wxapp.js');

yhxwfx456.setPara({
  // 打点地址
  server_url: 'https://www.456.cn/logcount/logcount.html',
  //应用编号,用于识别应用数据
  website: '1000000X',
  //应用包名,用于识别多个应用数据,可以自定义名称;
  package: 'wx456.wxapp',
  //应用版本号
  version:'2.0',
  // 性能采集概率%,0-100
  performance_percent: 0,
  //是否打印日志,用于调试true|false
  logflag:false,
  //是否开启点击采集,用于采集鼠标点击和键盘输入true|false
  clickflag:false,
  // 需要自定义页面名称的页面,配置路径,其他页面自动采集,不需要传空
  custom_page: [
     'pages/news/news',
     'pages/user/user'
  ]
});

上线前还要在微信公众平台「开发管理 → 开发设置 → 服务器域名」的 request 合法域名里加上 https://www.456.cn,否则真机上的统计请求会被微信拦下,数据发不出去(开发者工具里勾选了「不校验合法域名」时看不出这个问题)。

4. 如何确认接入成功

  1. 测试时在 setPara 中把 logflag 设为 true,在微信开发者工具中编译运行小程序,打开几个页面。
  2. 在开发者工具的控制台(Console)中,出现包含「yhxwfx456 send log」的日志(如「页面 | 」「事件 | 」),说明 SDK 正在上报数据;如果出现「请配置打点地址」「请配置正确的站点编号」「请配置应用版本号」,请按提示检查 server_url、website(8 位应用编号)和 version。
  3. 登录 456 数据控制台,在「我的应用」中点击该应用的「查看报表」,进入「访问分析」→「用户轨迹」→「实时用户」,能看到这台设备的访问,即为接入成功。如果调用了自定义事件,可在「使用行为」→「事件分析」中查看。
  4. 正式发布前,请把 logflag 改回 false,关闭调试日志。

5. 进阶配置(可选)

用户属性设置

代码示例
var user_arr = { 'userid':'321','username':'Leo','性别':'男','年龄':'28'};//userid、username不可随意更改,其余属性自定义,支持中文

// 微信原生小程序
getApp().yhxwfx456.setUserSet(user_arr);

// uniapp / taro / Wepy
getApp().yhxwfx456.setUserMsg(user_arr);
            

自定义页面名称

代码示例
getApp().yhxwfx456.setWXPageurl("新闻详情页");
            

自定义事件设置

代码示例
//带属性的
getApp().yhxwfx456.track('event',['购物','加入购物车',{'商品id':'12876', '价格':'67.00'}]);

//不带属性
getApp().yhxwfx456.track('event', ['购物', '加入购物车']);
          
            

app和H5打通

App使用SDK ,采集到数据后,发往H5,H5 收到 App 发送的数据后,设置用户的Cookie,这样就保持了用户唯一识别标识的统一。

App端通过以下方法获取App中的用户唯一识别标识:

代码示例
//App使用SDK ,采集到数据后,发往H5,H5设置用户Cookie保持唯一标识统一。
let appCookie = yhxwfx456.getUserCookie();
            

H5端:

代码示例
apph5.html?yhxw456cookie=前面获取的appCookie&yhxw456counttype=app&yhxw456systemtype=uniapp
            
最后更新:2026-10-09