revenuecat-experiments

设置和管理实验

RevenueCat 实验会比较两个到四个产品包：offering_a（对照组）与 offering_b–offering_d（处理组）。参与实验的客户会收到其所属变体的产品包，而不是项目当前的产品包。设置实验意味着为每个变体准备一个产品包，然后将实验创建为草稿。

有关各工具的确切参数，请参阅 MCP 工具的架构；create-experiment 架构还列出了可用的实验类型，以及推荐的主要和次要指标。

准备变体

除待测试的一个方面外，各变体应保持一致，否则无法将结果归因于该项改动。例如，要衡量降低订阅价格的影响，两个变体应使用相同的付费墙设计和套餐，只调整产品价格。

对照组。 如果对照组代表“当前生产环境的情况”，请将当前产品包（list-offerings 中 is_current 为 true 的产品包）直接作为 offering_a_id 传入，不要复制它。仅当对照组本身需要相对于生产环境进行改动时才复制。

处理组。 首先使用 list-offerings 检查是否已有符合处理组预期内容的产品包，并优先复用，而不是复制。否则，从最接近的产品包开始复制每个处理组的产品包（通常是对照组产品包）。duplicate-offering 会复制套餐（并关联相同的现有产品）；如果源产品包有付费墙，也会将其复制为新的未发布草稿，并返回包含新 paywall_id 的新产品包。传入 source_paywall_version: published，以便处理组复制客户在生产环境中看到的付费墙，而不是尚未完成的草稿编辑；如果源付费墙从未发布过，此操作会失败，此时才使用默认值（draft）。然后应用待测试的单项改动：

• 付费墙改动（文案、布局、CTA、定价展示等）：这要求应用使用 RevenueCat Paywalls；付费墙是产品包的可选属性。如果对照组产品包没有付费墙（paywall_id 为 null），应用会通过代码渲染自己的付费墙，因此必须在应用中而非通过 RevenueCat 完成付费墙改动；请告知用户。否则，加载 revenuecat-paywall-design，并使用 edit-paywall-ai 编辑复制的付费墙。只提出衡量预期效果所需的最少改动，并查看生成的付费墙以验证结果。
• 价格、试用或介绍性优惠改动：这些设置位于商店产品上，因此处理组产品包需要使用不同的产品。使用 list-products 检查是否已有合适的产品；仅创建缺少的产品及其商店对应项（参见 revenuecat-store-state 技能）。然后将这些产品替换到复制的产品包套餐中：使用 detach-products-from-package 移除复制的产品，再使用 attach-products-to-package 添加新产品。
• 全新付费墙：复制产品包时设置 include_paywall: false，然后加载 revenuecat-paywall-design，并调用 create-paywall-ai，传入新产品包的 offering_id，使生成的草稿直接关联到该产品包。付费墙与产品包是一对一配对关系；如果任一方已经配对，attach-offering-to-paywall 就会失败。若配对错误，请先使用 detach-offering-from-paywall 撤销配对（如果付费墙已发布，则先取消发布）。

发布处理组付费墙。 复制或新建的付费墙都是未发布的草稿，而变体只会提供已发布的版本。如果前面的步骤创建了新付费墙，请在实验开始前使用 publish-paywall 发布每个处理组付费墙。这是禁止主动发布规则的例外，而且是安全的：处理组产品包不是当前产品包，因此在实验开始招募参与者之前，不会有客户看到该付费墙。

创建实验

使用 create-experiment 创建草稿：设置显示名称、enrollment_percentage、各变体提供的 ID、experiment_type、与假设相符的 primary_metric（以及 secondary_metrics）、enrollment_mode（除非用户明确希望纳入现有客户，否则设为 only_new），以及任何定向条件和备注。创建实验不会启动实验。使用 update-experiment 修改草稿。

启动前，请验证每个变体：处理组的付费墙已发布，套餐包含预期的产品，并且任何新产品都已在商店上架。

生命周期

• start-experiment 开始招募真实客户——只有在用户明确确认后才能执行。
• pause-experiment 停止招募，但已加入实验的客户仍会看到其所属变体，并继续收集数据。
• resume-experiment 继续招募。
• stop-experiment 是终止操作：已加入实验的客户将回退到默认提供项，且实验永远无法重新启动。

实验运行后，请使用 revenuecat-experiment-analysis 技能解读结果。