接入协作
按以下步骤确认事件定义、完成 SDK 集成并验收接收结果。各平台安装步骤见快速接入。
| 步骤 | 负责方 | 应确认的结果 |
|---|---|---|
| 准备环境 | 项目负责人、接收服务负责人 | 测试/正式环境的 endpoint、公开 projectKey、可用 SDK 包与版本 |
| 定义身份 | 业务研发、数据负责人 | 匿名、登录、切换账号和退出后的身份语义;服务端使用宿主已认证身份 |
| 定义事件 | 产品、数据、业务研发 | 事件名、触发时机、属性类型、必填项和敏感信息处理 |
| 集成 SDK | 接入开发者 | 初始化、事件调用、授权及生命周期配置;服务端还需完成实例关闭 |
| 验证并上线 | 开发、测试、接收服务负责人 | 测试事件的字段、身份、上传响应及目标服务记录;保存环境和版本信息 |
事件与身份
客户端事件保存创建时的身份和 Session 快照。登录、切换用户和退出分别使用对应公开 API,见身份与生命周期。服务端事件由宿主提供身份,见服务端身份与多租户。
事件定义应包含业务含义、触发条件和属性口径。可参考事件与属性字典及。需要客户端规则校验时,再配置可选的本地 。
投递与验收
服务端默认批量队列适用于可容忍进程退出丢失的分析事件;必须与业务事务一起提交的订单、支付事件,使用宿主事务 Outbox。选择方式见服务端 SDK 概览。