Add A/B test variants without flows or paywalls

You can measure the impact of your flow or paywall by running an A/B test against an empty variant. One variant shows your flow/paywall; the other shows nothing. Your app reads a flag from the remote config to decide whether to render.

How it works

The setup uses two flows/paywalls in the same placement:

Flow/Paywall A: The flow or paywall you want to test, with show_paywall set to true in its remote config.
Flow/Paywall B: An empty flow or paywall with show_paywall set to false in its remote config.

When the SDK returns a flow or paywall, your app reads the show_paywall flag. If the flag is true, the app renders it. If the flag is false, the app skips rendering and the user continues without seeing anything.

1. Add the show_paywall flag in remote config

You need two flows or paywalls in the same placement: Flow/Paywall A (the one you want to test) and Flow/Paywall B (an empty one). Add a show_paywall field to each so your app can branch on the same key for both variants.

To add the flag to Flow/Paywall A:

Open the Flows/Paywalls section in the Adapty main menu and select Flow/Paywall A.
Open the Remote config section.
Create a field with the name show_paywall and the value true. In the JSON view, the entry looks like:
```
{
  "show_paywall": true
}
```
Save the changes.

Repeat the same steps for Flow/Paywall B, but set show_paywall to false.

For full details on remote config, see Customize flow with remote config or Design paywall with remote config.

Setting show_paywall on both variants keeps the code path identical for both groups and makes the test easier to extend with more variants later.

2. Set up the A/B test

Create an A/B test on the placement and add both flows/paywalls as variants.
Set the variant weights to split traffic between users who see the flow/paywall and users who do not.

3. Check the flag in your app

Read show_paywall from the remote config returned by the SDK. If the flag is false, skip rendering and let the user continue.

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
}

import { adapty } from '@adapty/capacitor';

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
}

The fallback value true keeps the flow/paywall visible when the flag is missing, so existing flows/paywalls without the flag are unaffected.

If you render the paywall yourself (without the Flow Builder or Paywall Builder), call logShowFlow (iOS SDK v4+) / logShowPaywall when you display Flow/Paywall A. Without it, Adapty cannot count views in the test. Do not log a view for Flow/Paywall B, since it is never shown.

Next steps

Create, run, and stop an A/B test — Set up the test that includes both variants
A/B test results and metrics — Compare the empty variant against your flow/paywall