SDK 接入

在“接入指南”的“选择接入方式”区域可以看到当前环境对应的初始化模板。复制模板前，先确认项目、环境、Collector 地址和密钥类型。

操作路径：项目 → 接入指南 → 选择接入方式。代码中的 YOUR_*_KEY 必须替换为当前环境的真实值。

平台选择

运行位置	SDK	推荐用途
网站、SPA	Browser 0.7.0	页面与交互自动采集、自定义事件、身份透传、Feature Flag
Go 后端	Go 0.6.0	可信服务端事件、客户 IP、浏览器身份关联、Feature Flag
Android	Android 0.1.1	应用生命周期、页面、自定义事件和可选设备标识
iPhone/iPad	iOS 预览	应用生命周期、页面、自定义事件、IDFV/经授权 IDFA
微信/支付宝/抖音	小程序预览	平台生命周期、页面和自定义事件

同一个业务动作可以同时产生浏览器事件和服务端事件，但应使用不同事件名或明确的属性区分语义。例如浏览器记录 checkout_submitted，支付服务确认后记录 invoice_paid。

通用原则

• 在应用生命周期中只初始化一次 SDK。
• 登录态恢复后调用 identify，退出登录时调用 reset。
• 需要用户授权时以 pending 初始化，收到同意后切换到 grant。
• 生产退出前调用对应的 flush、Close 或 shutdown。
• 不上报密码、Cookie、访问 Token、手机号、邮箱等非分析必需数据。

从左侧选择具体 SDK 继续。