experiment-analysis

実験を分析するには、以下の手順に従ってください。すべての手順をこの順番で実行し、省略しないでください。各手順の詳細は以下を参照してください。すでに一部の情報（例：実験 ID）がわかっている場合は、その手順のみ省略できます。それ以外の手順はすべて続けてください。

1. 実験 ID を取得する
2. 実験の詳細を取得する
3. 補足チャートデータを取得する［省略禁止］
4. 実験結果を取得する
5. 結果を解釈する
6. 全体的な分析結果を報告する

Step 1：実験 ID を取得する

まだ実験 ID がわからない場合は、RevenueCat ツールの list-experiments を使って取得してください。このツールが受け取るパラメーターは 1 つで、proj... 形式のプロジェクト ID が必要な project_id です。status フィルター（draft、running、paused、stopped）を指定することもできます。

Step 2：実験の詳細を取得する

Step 2a：実験の設定

RevenueCat ツールの get-experiment を使って、実験の設定／メタデータを取得してください。パラメーターは project_id（上記と同じ）と experiment_id（ステップ 1 で取得）です。expand パラメーターには、次の値を指定してください：offering.package.product.indicative_price および offering.paywall。

抽出する関連情報：

• Offerings（offering_a、offering_b、...）：これらは実験の各バリアントを定義します。より複雑な設定では、プレースメントごとに異なる Offering を定義する placements オブジェクトが含まれる場合もあります（例：オンボーディング、機能ゲートなど）。Offerings には、提供される製品の詳細が含まれます。製品には indicative_price が含まれます。全体的な価格帯を把握できるよう、米国の USD 価格のみが返される点に注意してください。導入価格は返されません。価格の地域別ローカライズテスト、米国外を明示的に対象とするテスト、または導入価格については、これだけでは全体像を把握できないため、代わりに get-product-store-state ツールを使用する必要がある場合があります（revenuecat-store-state スキルを参照）。Offering に RevenueCat Paywall が使われている場合、paywall_id が含まれることもあります。paywall_id が null の場合、アプリはカスタムペイウォールを使用しています。
• notes：実験について記載されたメモ
• display_name：実験名
• targeting_conditions：この条件を満たす顧客にのみ実験が適用されます
• enrollment_mode：新規顧客のみを登録する（デフォルト）のか、既存顧客にも実験を適用するのかを定義します
• experiment_type：実験の種類（事前定義されたリストからユーザーが選択）
• primary_metric、secondary_metrics：実験の作成時に設定された主要指標と副次指標
• Status：
  • draft は実験がまだ開始されておらず、結果もないことを意味します。
  • running は新規顧客の登録が引き続き行われていることを意味します。
  • paused は新規顧客の登録は停止していますが、登録済みの顧客は引き続き割り当てられたバリアントが適用され、実験では最大 400 日間データ収集が続くことを意味します。新規顧客の登録を再開するために、実験を再開できます。
  • stopped は新規顧客の登録が停止し、登録済みの顧客にはデフォルトの Offering が再び適用されていることを意味します。結果は最大 400 日間更新され続けます。実験を再開または再開することはできません。

Step 2b：ペイウォール

実験内のいずれかの Offering に paywall_id がある場合は、render-paywall-screenshot ツール（パラメーター：project_id、paywall_id）を使ってペイウォールを確認し、違いを把握してください。

ステップ 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：結果を解釈する

実験でどのような変更が行われたかを把握したうえで、結果を解釈します。最善の判断をしてください。