Before setting up an experiment, make sure you've created the products and offerings that you want to test and added any new products to the appropriate entitlements in your project (more on this below). You should also test the offerings you've chosen on any platform your app supports.

Setting up a new experiment

Select + New to create a new experiment.

Then, enter the following details:

• Experiment name
• Enrollment criteria (optional)
• Control variant
  • The offering that will be used for your Control group
• Treatment variant
  • The offering that will be used for your Treatment group (the variant in your experiment)

📘

Setting up an offering for your treatment

If you've not setup multiple offerings before, you'll be prompted to do so now, since you'll need at least 2 available offerings to run an experiment.

The treatment offering represents the hypothesis you're looking to test with your experiment (e.g. higher or lower priced products, products with trials, etc).

For App Store apps, we recommend setting up new products to test as a new Subscription Group so that customers who are offered those products through Experiments will see only that same set of products to select from their subscription settings.

Enrollment criteria

You may choose to setup custom enrollment criteria for your experiment to target a specific segment of your customers, using any combination of the following enrollment criteria:

Once done, select CREATE EXPERIMENT and view your new experiment.

Starting an experiment

When viewing a new experiment, you can start, edit, or delete the experiment.

• Start: Starts the experiment. Customer enrollment and data collection begins immediately, but results will take up to 24 hours to begin populating.
• Edit: Change the name, enrollment criteria, or offerings in an experiment before it's been started. After it's been started, only the percent of new customers to enroll can be edited.
• Delete: Deletes the experiment.

🚧

Sandbox

Test users will be placed into the experiment offering variants, but sandbox purchases won't be applied to your experiment.

If you want to test your paywall to make sure it can handle displaying the offerings in your experiment, you can use the Offering Override feature to choose a specific offering to display to a user.

FAQs