Title: 生命周期管理
Locale: zh
URL: https://sensorswave.com/docs/experiments/lifecycle-management/
Description: 掌握实验全流程管理
实验的生命周期管理涵盖从创建、调试、运行、监控到结束的全流程。科学的生命周期管理能够确保实验顺利进行，获得可靠的结论。本文将详细介绍实验各阶段的管理要点。

## 实验生命周期

实验在生命周期中会经历以下 6 种状态：

| 状态 | 英文 | 说明 |
|------|------|------|
| 草稿 | DRAFT | 实验已创建但未发布，可反复修改配置 |
| 调试 | DEBUG | 用于测试环境验证，仅特定测试用户可见 |
| 运行中 | RUNNING | 实验正式上线，正在收集数据并进行分流 |
| 已发布 | RELEASED | 全量应用选定的优胜变体 |
| 已结束 | FINISHED | 实验手动结束，不再收集新数据 |
| 已删除 | DELETED | 实验被标记删除 |

### 状态流转

```mermaid
stateDiagram-v2
    [*] --> DRAFT
    DRAFT --> DEBUG : 进入调试
    DEBUG --> RUNNING : 正式发布
    RUNNING --> RELEASED : 全量发布优胜变体
    RUNNING --> FINISHED : 手动结束
    RELEASED --> FINISHED : 结束实验
    FINISHED --> DELETED : 归档删除
    DRAFT --> DELETED : 直接删除

    DRAFT : 草稿
    DEBUG : 调试
    RUNNING : 运行中
    RELEASED : 已发布
    FINISHED : 已结束
    DELETED : 已删除
```

---

## DRAFT（草稿）阶段

### 特点

- 实验已创建，但未发布
- 可以反复修改配置
- 代码中无法获取实验配置
- 不记录曝光日志

### 操作

**编辑实验**：
- 修改基本信息（显示名称、描述、假设）
- 调整变体配置（流量分配、变量值）
- 修改分流规则和实验指标

**删除实验**：
- 如果实验配置有误，可以直接删除
- 删除后状态变为 DELETED

**进入调试**：
- 确认配置后，将实验切换到 DEBUG 状态

---

## DEBUG（调试）阶段

### 特点

- 仅特定测试用户可见
- 用于在测试环境中验证实验配置和代码集成
- 不影响正式流量

### 操作

**验证实验配置**：
- 使用测试账号触发实验
- 确认各变体展示正确
- 验证曝光日志是否正常上报

**正式发布**：
- 调试验证通过后，将实验状态切换为 RUNNING

---

## RUNNING（运行中）阶段

### 监控流量分布

实验正式上线后，首先要验证流量分配是否均匀。

**查看方式**：

在事件分析中查询 `$ABImpress` 事件：

```
事件：$ABImpress
筛选条件：experiment_key = 'your_experiment_key'
分组维度：variant
指标：去重用户数
时间范围：最近 1 天
```

**预期结果**（50/50 分配）：

| 变体 | 用户数 | 占比 |
|------|--------|------|
| control | 约 500 | 约 50% |
| treatment | 约 500 | 约 50% |

**异常处理**：

如果分布严重不均（偏差 > 5%）：
1. 检查流量配置是否正确
2. 检查分流条件是否过于苛刻
3. 等待更多样本，短期波动是正常的

### 监控曝光日志

确保曝光日志正常上报。

**检查步骤**：

1. 查看最近 1 小时的曝光数据
2. 确认每个用户只记录一次曝光
3. 检查曝光属性是否完整

**异常处理**：

如果曝光日志没有记录：
- 检查 SDK 是否开启 A/B 测试功能
- 检查实验是否处于 RUNNING 状态
- 检查代码集成是否正确
- 检查用户是否满足分流条件

### 观察关键指标

定期检查核心指标的变化趋势。

**主要指标**：

每天查看一次主要指标：

```
事件：转化事件（如 AddToCartClicked）
筛选条件：experiment = 'your_experiment_key'
分组维度：variant
指标：转化率
时间范围：累计
```

**次要指标和保护指标**：

每 2-3 天查看一次：
- 确保次要指标正常
- 确保保护指标无负面影响

### 异常处理

**发现异常指标**：

如果发现以下情况，需要立即结束实验：
- 保护指标严重下降（如错误率 > 5%）
- 主要指标严重下降（如转化率下降 > 20%）
- 用户投诉率激增

---

## 实验决策

### 何时结束实验

满足以下条件之一时，可以结束实验：

**成功条件**：
- ✅ 达到预定样本量（每组 > 1000 用户）
- ✅ 实验组主要指标显著优于对照组
- ✅ 统计显著性：p  1000 用户
- 运行至少 1 周（包含完整的工作日和周末）
- 达到统计显著性（p < 0.05）

### Q：实验可以提前结束吗？

**A**：不建议。过早结束可能导致：
- 样本量不足，结果不可靠
- 短期波动被误认为长期效果

**例外情况**：
- 发现严重 Bug
- 保护指标严重下降

### Q：实验结束后代码需要保留多久？

**A**：
- 实验判断逻辑：立即移除
- 获胜方案代码：长期保留
- 实验追踪代码：可以移除（保留常规追踪）

### Q：RELEASED 和 FINISHED 有什么区别？

**A**：
- **RELEASED**：全量应用了选定的优胜变体，所有用户将看到该变体
- **FINISHED**：实验手动结束，不再收集新数据，没有全量应用任何变体

---

## 相关文档

- [创建和配置](create-and-configure.mdx)：学习如何创建实验
- [指标与分析](metrics-and-analysis.mdx)：学习如何分析实验结果
- [最佳实践](best-practices.mdx)：掌握实验管理的最佳实践

---

**最后更新时间**：2026 年 1 月 29 日