experiment-analysis

要分析一项实验，请按以下步骤操作。请务必按顺序执行所有步骤，不要跳过任何步骤。下文提供了各步骤的更多详细信息。如果你已经掌握部分信息（例如实验 ID），可以仅跳过相应步骤。其他步骤仍需继续执行。

1. 获取实验 ID
2. 获取实验详情
3. 获取支持图表数据［请勿跳过］
4. 获取实验结果
5. 解读结果
6. 汇报总体发现

步骤 1：获取实验 ID

如果还没有实验 ID，请使用 RevenueCat 工具 list-experiments 查找。该工具接收一个参数：project_id，需要提供 proj... 格式的项目 ID。你还可以传入 status 筛选条件（draft、running、paused、stopped）。

步骤 2：获取实验详情

步骤 2a：实验设置

使用 RevenueCat 工具 get-experiment 获取实验设置／元数据。参数：project_id（同上）和 experiment_id（来自步骤 1）。将以下值传入 expand 参数：offering.package.product.indicative_price 和 offering.paywall。

需要提取的相关信息：

• Offerings（offering_a、offering_b 等）：这些定义了实验的各个变体。更复杂的设置还可能包含 placements 对象，用于定义不同展示位置（例如引导流程、功能门控等）对应的不同 offerings。Offerings 包含所提供产品的详细信息。产品包含 indicative_price。请注意，返回的价格仅为美国的美元价格，用于了解整体价格水平。不会返回任何首购优惠价格。对于价格本地化测试、明确限定在美国以外地区的测试，或首购优惠价格，你可能需要改用 get-product-store-state 工具（参见 revenuecat-store-state 技能），才能全面了解情况。Offerings 还可能包含 paywall_id（如果该 offering 使用 RevenueCat Paywall）。如果 paywall_id 为 null，则表示应用使用的是自定义 paywall。
• notes：有关实验的备注
• display_name：实验名称
• targeting_conditions：实验仅适用于满足这些条件的客户
• enrollment_mode：定义仅新客户（默认）是否会加入实验，或者现有客户是否也适用此实验
• experiment_type：实验类型（由用户从预定义列表中选择）
• primary_metric、secondary_metrics：创建实验时设定的主要和次要成功指标。
• 状态：
  • draft 表示实验尚未开始，目前还没有结果。
  • running 表示实验仍在积极招募新客户。
  • paused 表示实验已停止招募新客户，但已加入的客户仍会分配到其对应变体，实验也会继续收集数据，最长可达 400 天。可以恢复实验，以继续招募新客户。
  • stopped 表示实验已停止招募新客户，已加入的客户也已恢复接收其默认 offering。结果最长可继续更新 400 天。实验无法再启动或恢复。

步骤 2b：Paywalls

对于实验中任意 offering 的 paywall_id，请使用工具 render-paywall-screenshot（参数为 project_id、paywall_id）查看 paywall 并了解其差异。

步骤 3：获取辅助图表数据

使用 get-chart-data RevenueCat 工具，获取实验运行期间的近期图表数据。不要跳过此步骤，它能为了解应用在该时间段内的整体表现提供宝贵背景信息。

参数：

• project_id：{project_id}
• chart_name：revenue
• start_date：{experiment_start_date}
• end_date：{experiment_end_date}，如果实验仍在进行，则填今天
• resolution：week（如果实验运行时间不足 2 周，则使用 day）

还需获取以下 chart_name 的数据：

• conversion_to_paying — 实验期间的整体转化趋势
• trials_new — 试用量趋势
• trial_conversion_rate — 实验期间的试用转付费情况
• initial_conversion – 初始转化率（从安装到试用、预付订阅或一次性购买的转化率）

步骤 4：获取实验结果

使用 get-experiment-results RevenueCat 工具获取目前为止的实验结果。 参数：

• project_id
• experiment_id
• platform（可选），按平台筛选结果，例如 ios
• country（可选），按国家/地区筛选结果，例如 us
• exposure_status（可选），按曝光状态筛选实验结果。可选值为 enrolled、exposed、not_exposed。仅适用于针对现有客户的实验。如果未提供，则默认为 "enrolled"（所有已加入实验的客户）。

步骤 5：解读结果

了解实验中做出的更改后，解读实验结果。请自行判断。