Title: 数据接入准备
Locale: zh
URL: https://sensorswave.cn/docs/getting-started/data-integration-preparation/
Description: 数据接入前的准备工作和最佳实践
在开始大规模数据埋点之前，建议先规划哪些数据真正重要。完善的数据接入方案不仅能帮助您回答业务问题，还能为未来的分析需求打下基础。本指南将帮助您制定完整的数据采集策略。

## 为什么需要数据接入准备？

科学的数据接入规划能够帮助您：

- **聚焦核心问题**：明确要解决的业务问题，避免数据冗余
- **确保数据质量**：从源头保证数据的准确性和完整性
- **节约成本**：避免无效数据占用存储和计算资源
- **支撑业务决策**：为产品优化、运营策略提供可靠依据

## 从两个核心事件开始

建议从两个最基础的事件开始埋点，它们能提供最大的业务价值：

### 1. 用户注册事件

**为什么重要**：这是了解产品增长的关键指标，能帮助您回答「每天有多少新用户加入？」

**推荐事件名称**：
- `SignUp`（注册）

### 2. 价值时刻事件

**为什么重要**：这是评估产品核心价值的关键，能帮助您回答「用户是否体验到产品价值？」

**如何选择价值时刻**：

根据您的产品类型，选择最能体现用户价值的操作：

#### 电商平台
- `Purchase`（购买完成）
- `OrderCompleted`（订单完成）
- `PaymentSuccess`（支付成功）

#### 内容平台
- `ArticleRead`（文章阅读）
- `VideoWatched`（视频观看）
- `ContentShared`（内容分享）

#### SaaS 工具
- `DocumentCreated`（文档创建）
- `TaskCompleted`（任务完成）
- `FeatureUsed`（功能使用）

#### 社交应用
- `PostCreated`（发布内容）
- `FriendAdded`（添加好友）
- `MessageSent`（发送消息）

## 埋点策略建议

### 客户端埋点 vs 服务端埋点

**客户端埋点**（前端/移动端）
- (优势) 采集用户交互行为的必要手段（点击、浏览、滑动、导航路径）
- (优势) 实时性好，用户行为立即记录
- (优势) 自动采集丰富的设备上下文（屏幕分辨率、浏览器版本、来源渠道）
- (优势) 天然支持匿名用户（未登录）行为追踪，SDK 自动分配匿名 ID
- (劣势) 容易受广告拦截器影响，数据可能丢失 15-30%
- (劣势) 无法收集服务端业务逻辑数据

**服务端埋点**（后端）
- (优势) 数据准确可靠，送达率接近 100%
- (优势) 可以收集完整的业务逻辑数据
- (优势) 集中管理，修复立即生效，无需等待客户端更新
- (劣势) 无法直接收集用户界面交互行为
- (劣势) 追踪匿名用户（未登录）需要额外的会话管理和 Cookie/Token 传递机制

**最佳实践**：推荐**从客户端埋点入手**——集成 SDK 并开启 `autoCapture`，几分钟即可开始采集数据，无需改动后端代码。随着分析需求的深入，再为核心业务事件（如支付、注册）补充服务端埋点，以获得更高的数据可靠性。当一个事件可以在两端都进行采集时，推荐使用服务端埋点以确保数据准确性。详细指南请参考[埋点方案选择](../data-integration/tracking-strategy.mdx)。

### 数据采集原则

1. **从核心业务流程开始**
   - 用户注册 → 登录 → 核心功能使用 → 付费转化

2. **遵循「对象-动作」命名规范**
   - (推荐) `UserLogin`、`ProductView`、`OrderCreate`
   - (不推荐) `login_success`、`view_product`、`create_order`

3. **属性命名使用蛇形命名法**
   - (推荐) `user_id`、`product_name`、`order_amount`
   - (不推荐) `userId`、`productName`、`orderAmount`

## 制定您的数据接入方案

### 第一步：梳理业务流程

1. **绘制用户旅程图**：从用户进入产品到完成核心目标的全流程
2. **识别关键节点**：找出对业务最重要的转化节点
3. **确定数据需求**：每个节点需要收集哪些信息

### 第二步：设计事件体系

1. **核心事件**：2-3 个最重要的业务事件
2. **辅助事件**：支持核心事件分析的配套事件
3. **预置事件**：SDK 自动采集的基础事件

### 第三步：规划属性结构

1. **通用属性**：所有事件都需要的基础属性
   - `user_id`、`timestamp`、`platform`、`version`

2. **业务属性**：特定于业务的属性
   - 根据您的产品特点自定义

3. **用户属性**：描述用户特征的信息
   - `registration_date`、`user_level`、`membership_type`

## 注意事项

- **合规第一**：确保数据采集符合隐私法规（GDPR、CCPA 等）
- **性能影响**：避免在关键业务路径上添加过多埋点
- **数据质量**：建立数据校验机制，及时发现异常数据
- **版本管理**：记录埋点方案的变更历史，便于回溯
- **跨平台一致性**：确保不同平台的埋点逻辑保持一致

## 检查清单

在开始实施前，确认以下事项：

- [ ] 已明确要解决的业务问题
- [ ] 已选择 2 个核心事件进行埋点
- [ ] 已为事件设计完整的属性结构
- [ ] 已为每个事件确定埋点策略（客户端、服务端或两者结合）
- [ ] 已评估数据合规性要求
- [ ] 已准备数据验证方案

## 下一步

完成数据接入准备后，您可以：

1. **[选择埋点方案](../data-integration/tracking-strategy.mdx)**：了解不同的数据采集方式
2. **集成 SDK**：开始在您的产品中集成 Sensors Wave SDK
3. **验证数据**：确认数据正确采集并开始分析

---

**最后更新时间**：2026 年 4 月 14 日