Skip to main content

Create placement

A Placement designates a specific location within your mobile app where a paywall or A/B test can be displayed. For example, a subscription choice might appear in a startup flow, while a consumable product (such as golden coins) could be presented when a user runs out of coins in a game. You have the flexibility to showcase the same paywall or A/B test across multiple placements or different paywalls or A/B tests in one placement for different user segments, called audiences in Adapty.

Read the Choose meaningful placements section for more recommendations on how to choose the right placement for a paywall.

To create a new placement:

  1. Open the Placements section in the Adapty main menu.

  1. In the Placements window, click Create placement.

  1. In the Placements / New placement window, enter Placement Name that is used for your reference to clearly describe the exact place in your mobile app. This name serves as a means of identification and helps you organize and manage your placements effectively. You have the flexibility to edit the placement name even after it has been created.

  2. Enter the Placement ID which is a unique identifier of the placement that will be used in your mobile app code to call the paywalls and A/B tests created in Adapty for this placement. Placement ID cannot be modified once it has been created. It guarantees the uniqueness and integrity of each placement.

Adding paywalls and A/B tests​

Adapty supports showing paywalls and A/B tests for specific audiences - segments of users created to better target your paywalls. If you do not need that, you can add your paywall or A/B test to the default audience All users, and stop on it. If you use audiences, first add a paywall or A/B test to the All users audience, and then add more audiences to your placement. More details on how audiences work, you can find in the Audiences page.

  1. In the Placements/ Your placement window, add a paywall or A/B test to display for default All users audience. To do this, click either the Run paywall or Run A/B test button, then select the desired paywall or A/B test from the dropdown list. Please note that only previously created paywalls and previously created A/B tests are available in the lists.
  2. If you want to use more than one audience in the placement to create personalized paywalls tailored to different user groups, click the Add audience button and choose the desired user segment from the list. Please note that only segments you have previously created are accessible in the list. These segments signify different audience groups defined and created within Adapty.
  1. Now add the paywall or A/B test to show for this audience.
  2. Add as many audiences as you need and paywalls or A/B tests to show for them.
  3. If you have more than one audience, check that the audiences have the correct priorities. When you have different user audiences, a user can belong to more than one audience. For instance, if you've defined audiences like "US users, "Facebook users", and a general audience like "All users," it's crucial to determine which specific audience to consider first when a user falls into multiple categories. Correct the priorities if required.
  4. Click the Save and publish button.