フローまたはペイウォールなしで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に移動します。フローの場合はFlow & Paywall builderタブ、カスタムペイウォールの場合はCustom Paywallsタブを開き、フロー/ペイウォールAを選択します。
Remote configセクションを開きます。
名前 show_paywall、値 true のフィールドを作成します。JSONビューでは、次のように表示されます：
```
{
  "show_paywall": true
}
```
変更を保存します。

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

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

Tip

両方のバリアントに 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 にしておくことで、フラグがない場合もフロー/ペイウォールは表示されたままになり、フラグを持たない既存のフロー/ペイウォールに影響しません。

Important

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

次のステップ

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