用户体验监控 React Native SDK（
tdem-rn-sdk）由腾讯云可观测团队提供技术支持。本文介绍如何在 React Native 平台接入用户体验监控 SDK。接入 SDK 后，验证数据上报成功，即可在控制台使用相关分析功能。SDK 简介
SDK 功能：专业的移动跨端用户体验监控工具，采用 JS 采集层 + Android / iOS 原生桥接架构，提供 JS 错误与 Promise 未捕获异常监控、原生崩溃监控、接口测速（
fetch / XMLHttpRequest）、路由页面浏览（PV）、用户行为监控（点击、滑动、长按、表单交互）、用户挣扎检测及 Session Replay 会话回放等数据的采集与分析服务，帮助开发者及时发现并解决体验问题，打造高质量 React Native 应用。服务提供方：腾讯云计算（北京）有限责任公司
监控能力 | 采集来源 | 能力说明 |
错误监控 | JS 层 + 原生层 | 自动采集 JS 运行时错误、未处理的 Promise rejection，以及所在系统的 Android（Java / Native）与 iOS 原生崩溃。 |
接口监控 | JS 层 | 自动监控 fetch 与 XMLHttpRequest 请求耗时、状态码与业务返回码。 |
页面与用户行为 | JS 层 | 支持 React Navigation / Expo Router 路由切换自动采集，以及点击、滑动、长按和表单输入长度分桶统计。 |
会话回放与挣扎检测 | 原生层 | 复用 Android / iOS 原生录屏与挣扎检测引擎，还原用户操作画面与异常前后的交互轨迹。 |
自定义上报 | JS 层 → 原生层 | 提供自定义事件、自定义耗时测量、日志、异常、用户标识与全局标签接口。 |
说明：
React Native 应用同时承载 Android 与 iOS 两个系统的数据。JS 错误、接口测速、页面访问、用户旅程与漏斗分析支持按应用汇总查看，也可按平台筛选；原生崩溃按所选操作系统查看。
React Native 应用不采集浏览器特有的 Web Vitals（LCP / INP / CLS）或静态资源瀑布图指标，控制台应用总览中的综合评分固定显示为
-，不代表接入异常。接入前准备
1. 在接入 SDK 之前，请务必认真阅读 用户体验监控 SDK 合规使用指南 与 用户体验监控 SDK 个人信息保护规则。
2. 登录用户体验监控控制台创建 React Native 类型的应用，获取项目标识（
id，即 project_key）与对应地域的上报域名（url）。客户端接入仅使用项目标识，请勿将腾讯云 API 密钥（SecretId / SecretKey）写入客户端代码。3. 完成 SDK 集成。
4. 完成 SDK 初始化。SDK 在初始化过程中可能会采集部分设备与用户信息，请在用户同意个人信息保护规则之后再创建并初始化 SDK 实例。
5. 验证 数据上报。
6. 详细了解其他 SDK 功能，请参见 API 说明。
