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