フローまたはペイウォールなしでA/Bテストのバリアントを追加する

フローまたはペイウォールの効果を、空のバリアントとのA/Bテストで測定できます。一方のバリアントはフロー/ペイウォールを表示し、もう一方は何も表示しません。アプリはリモートコンフィグのフラグを読み取って、レンダリングするかどうかを判断します。

仕組み

同じプレースメントに2つのフロー/ペイウォールを設定します。

フロー/ペイウォール A: テストしたいフローまたはペイウォール。リモートコンフィグで show_paywall を true に設定します。
フロー/ペイウォール B: 空のフローまたはペイウォール。リモートコンフィグで show_paywall を false に設定します。

SDKがフローまたはペイウォールを返すと、アプリは show_paywall フラグを読み取ります。フラグが true の場合はレンダリングし、false の場合はレンダリングをスキップして、ユーザーは何も見ずに続行します。

1. リモートコンフィグにshow_paywallフラグを追加する

同じプレースメントに2つのフローまたはペイウォールが必要です。フロー/ペイウォール A（テストしたいもの）とフロー/ペイウォール B（空のもの）です。両方のバリアントで同じキーを使って分岐できるよう、それぞれに show_paywall フィールドを追加します。

フロー/ペイウォール A にフラグを追加するには：

Adapty のメインメニューで Flows/Paywalls セクションを開き、フロー/ペイウォール A を選択します。
Remote config セクションを開きます。
名前 show_paywall、値 true のフィールドを作成します。JSON ビューでは次のようになります：
```
{
  "show_paywall": true
}
```
変更を保存します。

フロー/ペイウォール B にも同じ手順を繰り返しますが、show_paywall を false に設定します。

リモートコンフィグの詳細については、リモートコンフィグでフローをカスタマイズするまたはリモートコンフィグでペイウォールをデザインするを参照してください。

両方のバリアントに show_paywall を設定することで、両グループのコードパスが同一になり、後からバリアントを追加するときも簡単に拡張できます。

2. A/Bテストを設定する

プレースメントにA/Bテストを作成し、両方のフロー/ペイウォールをバリアントとして追加します。
バリアントのウェイトを設定して、フロー/ペイウォールを見るユーザーと見ないユーザーにトラフィックを分配します。

3. アプリでフラグを確認する

SDKから返されるリモートコンフィグの show_paywall を読み取ります。フラグが false の場合、レンダリングをスキップしてユーザーを続行させます。

do {
    let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")
    let config = flow.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow.remoteConfigs.first
    let showPaywall = config?.dictionary?["show_paywall"] as? Bool ?? true

    if showPaywall {
        // render the flow or paywall
    }
} catch {
    // handle the error
}

Adapty.getPaywall("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            val showPaywall = paywall.remoteConfig?.dataMap?.get("show_paywall") as? Boolean ?: true

            if (showPaywall) {
                // Render the paywall
            }
        }
        is AdaptyResult.Error -> {
            // handle the error
        }
    }
}

try {
  const paywall = await adapty.getPaywall({ placementId: "YOUR_PLACEMENT_ID" });
  const showPaywall = paywall.remoteConfig?.data?.["show_paywall"] ?? true;

  if (showPaywall) {
    // Render the paywall
  }
} catch (error) {
  // handle the error
}

try {
  final paywall = await Adapty().getPaywall(id: "YOUR_PLACEMENT_ID");
  final bool showPaywall = paywall.remoteConfig?.dictionary?['show_paywall'] as bool? ?? true;

  if (showPaywall) {
    // Render the paywall
  }
} on AdaptyError catch (adaptyError) {
  // handle the error
}

Adapty.GetPaywall("YOUR_PLACEMENT_ID", (paywall, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    var showPaywall = paywall.RemoteConfig?.Dictionary?["show_paywall"] as bool? ?? true;

    if (showPaywall) {
        // Render the paywall
    }
});

Adapty.getPaywall(
    placementId = "YOUR_PLACEMENT_ID"
).onSuccess { paywall ->
    val showPaywall = paywall.remoteConfig?.dataMap?.get("show_paywall") as? Boolean ?: true

    if (showPaywall) {
        // Render the paywall
    }
}.onError { error ->
    // handle the error
}


try {
  const paywall = await adapty.getPaywall({ placementId: 'YOUR_PLACEMENT_ID' });
  const showPaywall = paywall.remoteConfig?.data?.['show_paywall'] ?? true;

  if (showPaywall) {
    // Render the paywall
  }
} catch (error) {
  // handle the error
}

フォールバック値を true にしておくことで、フラグがない場合もフロー/ペイウォールは表示されたままになり、フラグを持たない既存のフロー/ペイウォールに影響しません。

ペイウォールを自分でレンダリングする場合（フロービルダーやペイウォールビルダーを使わない場合）、フロー/ペイウォール A を表示する際に logShowFlow（iOS SDK v4+）/ logShowPaywall を呼び出してください。これをしないと、Adapty はテストのビュー数を計測できません。フロー/ペイウォール B は表示されないため、ビューをログに記録しないでください。

次のステップ

A/Bテストの作成・実行・停止 — 両方のバリアントを含むテストを設定する
A/Bテストの結果と指標 — 空のバリアントとフロー/ペイウォールを比較する