React Native Experiments

Supported on: iOS SDK 1.0.70+ · Android SDK 1.0.42+ · React Native SDK 1.0.7+ (New Architecture only)

The experiments module assigns users to variants using a deterministic hash. No server call is needed — assignment is instant, works offline, and the same user always gets the same variant (as long as the user is in the experiment — see Who Is in an Experiment).

Get Variant

import { AppDNA } from '@appdna-ai/react-native-sdk';

declare function showStandardPaywall(): void;
declare function showNewPaywall(): void;

const variant = await AppDNA.experiments.getVariant('paywall-test');

switch (variant) {
  case 'control':
    showStandardPaywall();
    break;
  case 'variant_a':
    showNewPaywall();
    break;
  default:
    // null: not running (paused, completed, archived) or not fetched yet — always handle this branch.
    showStandardPaywall();
}

getVariant is asynchronous and returns the variant ID set in the Console or null if the experiment is not in the config the SDK holds, is not running (paused, completed or archived), does not target the current platform, or the user is outside its targeting rules or traffic allocation (SDK 1.0.19+, evaluated by the native SDK; see Who Is in an Experiment). experimentId is the experiment’s ID, not its name — copy it from the experiment’s page or the ID column of the experiments list in the Console; 'paywall-test' above is a placeholder.

Always handle the null / default case. Experiments can be archived or stopped at any time from the Console.

Check Membership

When you only need a boolean for a specific variant, isInVariant is a convenient shortcut:

declare function showStandardPaywall(): void;
declare function showNewPaywall(): void;

if (await AppDNA.experiments.isInVariant('paywall-test', 'variant_a')) {
  showNewPaywall();
} else {
  showStandardPaywall();
}

Module Access

const experiments = AppDNA.experiments;

Module Methods

Method	Signature	Description
`getVariant`	`getVariant(experimentId: string): Promise<string \| null>`	Get the assigned variant
`isInVariant`	`isInVariant(experimentId: string, variantId: string): Promise<boolean>`	Check if the user is in a specific variant
`getExposures`	`getExposures(): Promise<Array<Record<string, unknown>>>`	Read recorded experiment exposures for the current user

Exposure Tracking

The SDK automatically tracks an experiment_exposure event the first time it assigns a variant for a given experiment (on getVariant(), isInVariant() or a servable surface), and again only after an app restart or reset(). A user outside the experiment’s targeting or traffic allocation gets null and records no exposure. Exposure events power the metrics that the experimentation engine uses to compute results — you do not need to fire them yourself. To inspect what the SDK has already recorded for the current user, call getExposures():

const exposures = await AppDNA.experiments.getExposures();

for (const exposure of exposures) {
  const experimentId = exposure.experimentId as string | undefined;
  const variant = exposure.variant as string | undefined;
  console.log(`Exposed to ${experimentId} -> ${variant}`);
}

This is useful for debugging, surfacing the active variant in a developer panel, or attaching the current bucket to your own analytics events.

Reacting to Assignment Changes

The SDK does not push assignment-change callbacks. Variant assignments are stable for a given user ID and experiment: variants and weights cannot change while an experiment runs. An assignment changes when the user ID changes (identify() or reset()), and getVariant returns null once the experiment is paused, completed or archived and the SDK has fetched config. If you need to refresh UI when the experiment configuration could have changed, re-read getVariant at natural moments in your app:

On app launch and on return from background
When you present the screen that depends on the variant
After a known config-refreshing action (e.g. login, environment switch)

class HomeScreenController {
  private paywallVariant: string | null = null;

  async refresh(): Promise<void> {
    this.paywallVariant = await AppDNA.experiments.getVariant('paywall_redesign');
    // re-render UI that depends on this.paywallVariant
  }
}

Assignment changes are rare. They occur when the user ID changes or the experiment stops, not on every session start.

Experiment Lifecycle

Status	`getVariant()` returns
Draft	`null` — not visible to SDKs
Running	Assigned variant string
Paused	`null` — servable surfaces show the live entity
Completed	`null` — removed from config. A servable surface’s winner is live only if it was rolled out (Auto-Deploy Winner or Deploy winner)
Archived	`null` — removed from config

A status change reaches the device with its next config fetch; until then the SDK keeps the definition it has. See Experiment Lifecycle.

Full Example

import { AppDNA } from '@appdna-ai/react-native-sdk';

export class PaywallExperiment {
  async showPaywall(): Promise<void> {
    const variant = await AppDNA.experiments.getVariant('paywall_redesign');

    const paywallId = variant === 'new_design' ? 'paywall_v2' : 'paywall_v1';

    await AppDNA.paywall.present(paywallId, {
      placement: 'settings',
      customData: {
        experiment: 'paywall_redesign',
        variant: variant ?? 'control',
      },
    });
  }
}

Experiments are created in the Console under Experiments. The SDK uses MurmurHash3 for deterministic assignment — the same user ID always gets the same variant across sessions, platforms, and offline.

​Get Variant

​Check Membership

​Module Access

​Module Methods

​Exposure Tracking

​Reacting to Assignment Changes

​Experiment Lifecycle

​Full Example

Get Variant

Check Membership

Module Access

Module Methods

Exposure Tracking

Reacting to Assignment Changes

Experiment Lifecycle

Full Example