Title: 常见问题
Locale: zh
URL: https://sensorswave.com/docs/analytics/faq/
Description: 数据洞察使用过程中的常见问题解答
本文汇总了数据洞察使用过程中的常见问题和解答。

## 基础问题

### 数据洞察和传统 BI 工具有什么区别？

**数据洞察**：
- 专为用户行为分析设计
- 内置事件分析、留存分析、漏斗分析等分析模型
- 支持从指标下钻到具体用户
- 与埋点数据无缝集成

**传统 BI 工具**：
- 通用数据可视化工具
- 需要自行设计分析逻辑
- 通常无法下钻到用户级别
- 需要额外的数据接入工作

### 不同分析模型应该怎么选择？

| 分析目标 | 推荐模型 |
|---------|---------|
| 分析事件发生次数、趋势 | 事件分析 |
| 分析用户的持续使用情况 | 留存分析 |
| 分析多步骤流程的转化 | 漏斗分析 |
| 复杂的自定义分析 | SQL 查询 |

详见 [找到合适的分析模型](choosing-analysis-model.mdx)。

### 分析结果的数据延迟是多少？

- **实时数据**：最新数据通常在 1 分钟内可查询
- **数据缓存**：查询结果可能存在 5 分钟左右的缓存

如果发现数据延迟较长，请检查：
- 数据上报是否正常
- 是否命中查询缓存结果

### 分析结果可以导出吗？

可以。支持以下导出方式：

1. **数据表导出**：
   - 点击数据表区域的「导出」按钮
   - 支持 CSV 和 Excel 格式

2. **图表导出**：
   - 右键点击图表
   - 选择「导出图片」

3. **API 导出**：
   - 使用 API 批量导出分析结果
   - 适合自动化场景

## 事件分析相关

### 查询结果为空怎么办？

**排查步骤**：

1. **检查时间范围**：
   - 确认所选时间范围内有数据上报
   - 尝试扩大时间范围

2. **检查事件选择**：
   - 确认选择的事件名称正确
   - 在数据中心中验证事件是否有数据

3. **检查筛选条件**：
   - 筛选条件是否过于严格
   - 尝试去掉筛选条件查看是否有数据

4. **检查数据上报**：
   - 使用调试工具验证数据是否正常上报
   - 检查 SDK 版本和配置

### 事件分析支持分析多少个事件？

- 单次分析最多支持 **10 个指标**
- 建议每次分析聚焦 1-3 个相关事件
- 复杂的多事件分析建议使用 SQL 查询

### 分组维度太多导致查询慢怎么办？

**优化建议**：

1. **减少分组维度**：
   - 一次分析不超过 2 个分组维度
   - 先用单个维度定位问题

2. **使用 Top N**：
   - 只展示前 N 个维度值
   - 合并长尾数据

3. **缩小时间范围**：
   - 减少查询的数据量
   - 先做小范围验证

4. **使用筛选条件**：
   - 筛选出关心的数据子集
   - 减少计算量

### 如何对比不同时间段的数据？

1. 在时间选择器中点击「对比」
2. 选择对比类型：
   - **上周同期**：对比上周的同一天
   - **上月同期**：对比上月的同一天
   - **自定义**：选择任意时间段
3. 图表将同时展示两个时间段的数据

### 如何计算占比和人均指标？

**占比计算**：

在事件分析中无法直接计算占比，推荐：
- 使用 SQL 查询计算占比
- 或分别查询分子分母后手动计算

**人均指标**：

1. 度量方式选择「人均次数」
2. 系统自动计算「总次数 / 触发用户数」

## 留存分析相关

### 留存率的计算逻辑是什么？

**N 日留存率** = 第 N 日回访用户数 / 初始事件用户数 × 100%

**示例**：
- 1 月 1 日有 1000 个用户触发了初始事件
- 1 月 2 日（第 1 日）有 400 个用户触发了回访事件
- 次日留存率 = 400 / 1000 = 40%

### 初始事件和回访事件有什么区别？

**初始事件**：
- 定义用户「开始」的行为
- 用于确定用户的起始时间
- 常见选择：注册、首次启动、首次购买

**回访事件**：
- 定义用户「回来」的行为
- 用于判断用户是否留存
- 常见选择：应用启动、任意事件、核心功能使用

### 为什么留存率会超过 100%？

在某些计算方式下（如「回访事件发生次数」），数值可能超过 100%，这是因为：
- 一个用户可能在同一天多次触发回访事件
- 这种情况通常出现在看「回访次数」而非「回访用户数」时

如果使用「触发用户数」作为度量，留存率不会超过 100%。

### 如何分析留存的影响因素？

**方法 1：分组对比**

1. 添加分组维度（如渠道、设备类型）
2. 对比不同群体的留存曲线
3. 找出留存较高的群体特征

**方法 2：行为对比**

1. 创建两个分群：使用某功能的用户 vs 未使用的用户
2. 分别查看两个分群的留存率
3. 验证功能对留存的影响

### 留存分析支持多长时间的留存周期？

- 默认支持 **0-30 日** 留存
- 可以切换到「周留存」或「月留存」查看更长周期
- 超过 90 天的留存建议使用 SQL 查询

## 漏斗分析相关

### 漏斗步骤之间有顺序要求吗？

**有顺序要求**。漏斗分析只统计按照定义顺序完成步骤的用户。

**示例**：
- 漏斗步骤：A → B → C
- 用户行为：A → C → B
- 该用户只会被统计到步骤 A，因为没有按顺序完成

### 转化窗口是什么意思？

**转化窗口**：用户完成整个漏斗需要的最长时间。

**示例**：
- 设置 7 天转化窗口
- 用户在第 1 天完成步骤 A
- 需要在第 7 天之前完成步骤 B、C 才算转化成功
- 超过 7 天完成的不计入转化

**选择建议**：
- 快速决策场景（如即时购买）：1-3 天
- 考虑周期较长的场景（如大额商品）：7-14 天
- 长周期场景（如 B2B 销售）：30 天或更长

### 漏斗支持多少个步骤？

- 最少 **2 个步骤**
- 最多 **20 个步骤**
- 建议控制在 5-7 个步骤，太多步骤会影响可读性

### 如何查看每一步流失的用户？

1. 点击漏斗图中某个步骤的柱状图
2. 选择「查看流失用户」
3. 系统跳转到用户细查页面
4. 可以查看这些用户的属性和行为

### 漏斗分析可以排除重复转化吗？

可以。在设置中选择：
- **首次转化**：只统计用户的第一次转化
- **每次转化**：统计用户的所有转化

大多数场景建议使用「首次转化」，避免重复计算。

## SQL 查询相关

### SQL 查询支持哪些语法？

Sensors Wave 的 SQL 查询基于 Apache Doris，支持：
- 标准 SQL 语法
- 常用聚合函数（SUM、COUNT、AVG 等）
- 窗口函数
- 子查询和 CTE
- JOIN 操作

详见 [SQL 查询](sql-query.mdx)。

### 可以查询哪些数据表？

主要数据表包括：

| 表名 | 说明 |
|-----|------|
| `events` | 事件表，存储所有用户行为事件 |
| `users` | 用户表，存储用户属性 |
| `cohorts` | 分群表，存储用户分群信息 |

使用 `SHOW TABLES` 查看所有可用表。

### SQL 查询有性能限制吗？

有以下限制：

- **查询超时**：默认 5 分钟
- **返回行数**：默认最多 10000 行
- **并发限制**：同时运行的查询数有限

**优化建议**：
- 添加时间范围筛选
- 使用 LIMIT 限制返回行数
- 避免全表扫描

### 如何保存和复用 SQL 查询？

1. 点击「保存」按钮
2. 填写查询名称和描述
3. 保存后可在「我的查询」中找到
4. 支持参数化查询，方便复用

## 分析保存与分享

### 如何保存分析结果？

1. 完成分析配置后，点击右上角「保存」
2. 填写分析名称（建议使用描述性名称）
3. 选择保存位置（个人空间或团队空间）
4. 点击确认保存

### 如何将分析添加到看板？

1. 在分析页面点击「添加到看板」
2. 选择已有看板或创建新看板
3. 调整图表在看板中的位置和大小
4. 保存看板

### 如何分享分析给他人？

**分享链接**：
1. 点击「分享」按钮
2. 复制分析链接
3. 发送给需要查看的同事

**导出报告**：
1. 点击「导出」按钮
2. 选择导出格式（PDF、PPT）
3. 下载并分享文件

**权限说明**：
- 接收者需要有项目的查看权限
- 团队空间的分析对团队成员可见
- 个人空间的分析默认只有创建者可见

### 分析可以设置自动刷新吗？

可以。在看板设置中：
1. 进入看板编辑模式
2. 点击「看板设置」
3. 开启「自动刷新」
4. 设置刷新间隔（如每 5 分钟）

## 性能和限制

### 查询很慢怎么办？

**优化建议**：

1. **缩小时间范围**：减少查询的数据量
2. **减少分组维度**：一次不超过 2 个
3. **添加筛选条件**：聚焦关心的数据子集
4. **使用 Top N**：限制维度值数量
5. **避免高基数维度**：如用户 ID、订单 ID

### 系统有哪些使用限制？

| 限制项 | 限制值 |
|-------|--------|
| 单次查询时间范围 | 最长 365 天 |
| 分组维度数量 | 最多 3 个 |
| 事件数量（事件分析） | 最多 10 个 |
| 漏斗步骤数量 | 最多 20 个 |
| SQL 查询超时 | 5 分钟 |
| 导出数据行数 | 最多 100 万行 |

### 数据会保留多长时间？

- **事件数据**：默认保留 2 年
- **分析结果**：永久保留（除非手动删除）

具体保留策略可能因合同约定而不同，请联系客户成功团队确认。

## 故障排查

### 图表显示异常怎么办？

**常见问题和解决方法**：

1. **图表为空白**：
   - 刷新页面
   - 检查浏览器控制台是否有错误
   - 尝试更换浏览器

2. **数据不更新**：
   - 点击「刷新」按钮重新查询
   - 清除浏览器缓存
   - 检查网络连接

3. **显示「查询超时」**：
   - 缩小时间范围
   - 减少分组维度
   - 简化查询条件

### 导出失败怎么办？

**排查步骤**：

1. **检查数据量**：导出数据是否超过限制
2. **检查网络**：网络是否稳定
3. **分批导出**：将大数据量拆分为多次导出
4. **联系支持**：如持续失败，联系技术支持

### 数据和预期不符怎么办？

**排查思路**：

1. **检查事件定义**：
   - 事件名称是否正确
   - 埋点逻辑是否符合预期

2. **检查筛选条件**：
   - 筛选条件是否正确
   - 是否遗漏了某些数据

3. **检查时间范围**：
   - 时间范围是否覆盖预期数据
   - 注意时区设置

4. **对比验证**：
   - 用 SQL 查询验证数据
   - 或用其他分析方式交叉验证

### 如何联系技术支持？

如果遇到无法解决的问题：

1. **查看文档**：
   - 阅读相关功能文档
   - 搜索常见问题

2. **联系支持团队**：
   - 邮件：wave-support@sensorsdata.cn
   - 在线客服：控制台右下角
   - 提交工单：支持中心

3. **提供信息**：
   - 详细的问题描述
   - 错误截图
   - 分析配置信息
   - 复现步骤

## 下一步

如果您还有其他问题：

1. 查看 [概述](overview.mdx) 了解数据洞察基础
2. 参考 [快速开始](quick-start.mdx) 创建第一个分析
3. 阅读 [最佳实践](best-practices.mdx) 提升分析技能
4. 联系技术支持获取帮助

---

**最后更新时间**：2026 年 2 月 3 日