微信小程序怎么埋点：一行代码接入教程

小程序上线后，官方后台只能看到访问量、来源这些宏观数字，看不到用户在哪个页面流失、功能点被点了几次、分享带来了多少新客。要回答这些问题，需要自己埋点。

传统做法是在每个页面、每个按钮手写上报代码，页面一多就乱。更省事的方案是接入一个带 SDK 自动采集 的分析平台：把 SDK 放进项目，初始化后自动采集页面浏览、停留、分享，关键事件再手动 track。下面以 Iris · 瞳 为例，完整走一遍（约 5 分钟）。

第 1 步：把 SDK 放进项目

在 Iris 平台注册后创建项目，拿到 app_id；然后把 iris-sdk-wx.js 下载放到小程序的 utils/ 目录。

miniprogram/
├── app.js
├── utils/
│   └── iris-sdk-wx.js   <-- 放这里

第 2 步：app.js 里初始化（一行）

在 app.js 顶部引入并初始化，endpoint 填 Iris 的上报域名：

const iris = require('./utils/iris-sdk-wx.js');
iris.init({
  app_id: 'app_你的项目id',
  endpoint: 'https://iris.teown.com/api/collect'
});
App({ ... });

初始化之后，SDK 会自动包装小程序全局的 Page / App，无需在每一页加代码。

第 3 步：自动采集了哪些事件

第 4 步：关键事件手动 track

转化相关的关键动作（下单、报名、点击核心按钮）手动埋一次即可：

// 例：用户点击「立即报名」
iris.track('signup_click', { activity_id: 'A1001', from: 'home_banner' });

想关联登录后的真实用户，用 identify 绑定：

iris.identify('user_10086');

第 5 步：配置 request 合法域名

接入后能看什么

• 页面：哪个页面 PV/UV 最高、停留多久
• 漏斗：浏览 → 报名 → 支付，哪一步流失最多
• 留存：新用户第 7 天还回来多少人
• 事件：每个按钮、每个功能的触发量与趋势
• 回放：单个用户在小程序里的行为时间轴