帮你快速理解、总结文档立即下载

SDK 集成

最近更新时间:2026-09-30 17:29:02
本文档已由 AI 辅助审校
我的收藏
用户体验监控微信小程序 SDK 通过 npm 安装引入,并在微信开发者工具中构建 npm。

前提条件

已开通小程序开发者账号,并使用微信开发者工具开发。
小程序基础库建议 2.11.0 及以上(页面性能依赖基础库 Performance API),setData 更新性能统计建议 2.12.0 及以上。

集成方式

npm 安装(推荐)

npm install --save tdem-mp-sdk
安装后需在微信开发者工具中执行「工具 - 构建 npm」。构建产物位于 miniprogram_npm/tdem-mp-sdk,可直接引入:
import TDEM from 'tdem-mp-sdk';
注意:
使用 npm 包前,需在小程序根目录的 project.config.json 中确认已开启 setting.npm,并在开发者工具中执行一次「构建 npm」,否则 miniprogram_npm 不会生成。
包名统一为 tdem-mp-sdk,不带 @tencent 前缀。

手动拷入(备选)

若项目不使用 npm,也可直接将构建产物 lib/tdem.min.js 拷入小程序目录,用相对路径引入:
import TDEM from './lib/tdem.min.js';

配置 request 合法域名

小程序仅允许请求已配置的合法域名。请将采集域名加入小程序后台 - 开发 - 开发设置 - 服务器域名 - request 合法域名:
https://dem.rumt-zh.com # 国内站
https://dem.rumt-sg.com # 新加坡站
https://dem.rumt-us.com # 美国站
SDK 会在所选站点域名下请求以下三个端点,供排查时对照。合法域名只需填写域名本身(如 https://dem.rumt-zh.com),不要附带路径:
/api/v1/config:远程配置。
/api/v1/collect/mp-weixin:录制事件,回放原料。
/api/v1/collect/events:标准事件。
注意:
正式环境未配置合法域名时,配置拉取会失败,SDK 默认关闭回放上报。