概述 该技能用于通过 Adapty CLI($ADAPTY)管理付费墙或流程的常规 A/B 测试。一个常规 A/B 测试会把某个 placement 上、某个受众的用户,在两个或多个付费墙之间,或在两个或多个流程之间进行分流。技能负责测试的完整生命周期:规划、创建草稿、更新、启动、停止、替换和归档。
主要能力
- 列出、查看测试及其分流臂。
- 创建草稿:指定标题、目标、placement,以及受众(某个细分或全部用户),并传入付费墙或流程的分流臂 JSON(权重合计为 100)。
- 更新草稿。对已启动的测试,只能修改标题和目标,且必须原样回传分流臂、placement 和受众;已完成或已归档的测试不可修改。
- 启动、停止、替换、归档。这四项属于不可逆操作,会改变真实用户看到的内容,必须在用户看到具体影响并明确同意后才执行。
使用方式 命令以 adapty 开头,每个命令都需要 --app <id>(来自 adapty apps list)。读取时使用 --json。示例命令包括 ab-tests list、ab-tests get <id>、ab-tests create、ab-tests update <id>、ab-tests start <id>、ab-tests stop <id>、ab-tests replace <id>、ab-tests archive <id>,以及 flows get、paywalls create、placements create。对于启动、停止、替换、归档,CLI 在没有 --yes 时会请求确认;在管道或 --json 模式下会以退出码 6(confirm_required)拒绝,服务端拒绝时退出码为 4。
不可逆操作前的确认 在执行启动、停止、替换、归档前,技能先读取测试和 placement,把 ID 换成名称,展示一张“影响卡”,说明谁从何时起看到什么、哪些内容会停止,以及不可撤销的部分,然后等待用户对这张卡的明确同意。若期间 placement 或测试状态发生变化,需要重新展示并再次确认。无人值守运行不会执行这四项操作,也不会执行 paywalls create 或 placements create。
适用场景与限制 适用于对付费墙或流程的常规 A/B 测试进行规划与生命周期管理。不适用于:流程构建应使用 flow-generator;付费墙设计应在仪表盘或应用代码中完成;placement 上的受众分配(分段、受众)应使用 audiences;应用获取新 placement 的代码应使用 adapty-integration;测试结果、跨多个 placements 的测试以及 onboarding 测试不在 CLI 中,需要在仪表盘查看(https://adapty.io/docs/add-audience-paywall-ab-test);选择要运行哪个测试及停止后测什么应使用 growth-advisor;Apple Search Ads 产品页测试应使用 ads-manager。旧版 CLI 可能没有 ab-tests 命令,此时需在仪表盘创建测试。