revenuecat-experiments

実験の設定と管理

RevenueCat の実験では、2〜4 個のオファリングを比較します。offering_a（コントロール）と、offering_b〜offering_d（トリートメント）を比較します。登録された顧客には、プロジェクトの現在のオファリングの代わりに、そのバリアントのオファリングが提供されます。実験を設定するには、バリアントごとにオファリングを 1 つずつ準備し、実験をドラフトとして作成します。

各ツールの正確なパラメーターについては、MCP ツールのスキーマを参照してください。create-experiment のスキーマには、推奨される主要指標と副次指標を含む、利用可能な実験タイプも記載されています。

バリアントの準備

変更の影響を結果に反映できるよう、検証対象の要素以外はバリアント間で同じにしてください。たとえば、サブスクリプション価格を下げたときの影響を測定する場合、両方のバリアントでペイウォールのデザインとパッケージを同じにし、商品の価格だけを変えます。

コントロール。 コントロールのバリアントを「現在の本番環境の状態」にする場合は、現在のオファリング（list-offerings の is_current）をそのまま offering_a_id に渡してください。複製する必要はありません。本番環境と異なる変更がコントロール自体に必要な場合にのみ、複製してください。

トリートメント。 まず list-offerings で、トリートメントで提供する内容に合うオファリングがすでに存在するか確認し、存在する場合は複製せずに再利用してください。そうでなければ、各トリートメントを、それに最も近いオファリング（通常はコントロールのオファリング）の複製から始めます。duplicate-offering はパッケージをコピーし（既存の商品を同じものに紐付けます）、複製元のオファリングにペイウォールがある場合は、それも未公開の新しいドラフトとしてコピーします。新しい paywall_id を含む、新しいオファリングが返されます。トリートメントには、未完成のドラフト編集ではなく、本番環境で顧客に表示されているペイウォールがコピーされるよう、source_paywall_version: published を渡してください。複製元のペイウォールが一度も公開されていない場合は失敗するため、その場合に限りデフォルトの（draft）を使用してください。その後、検証対象の変更を 1 つ適用します。

• ペイウォールの変更（コピー、レイアウト、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 を読み込んでから、新しいオファリングの offering_id を指定して create-paywall-ai を呼び出します。生成されたドラフトは、そのオファリングに直接紐付けられます。ペイウォールとオファリングは 1 対 1 で紐付けられます。どちらかがすでに紐付けられている場合、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 スキルを使用します。