English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Placements

With Adapty’s placement system, you can create and run flows, paywalls, onboardings, and A/B tests at different points in your app user’s journey, such as onboarding flow, app settings, etc. These points are called Placements.

A placement in your app can manage multiple flows, paywalls, onboardings, or A/B tests at a time, each made for a certain group of users, which we call Audiences. Moreover, you can experiment with flows, paywalls, and onboardings, replacing one with another over time without releasing a new app version.

The only thing you hardcode in the mobile app is the placement ID.

Warning
  • The placement ID must match the ID in the dashboard exactly — copy it without stray whitespace. If the ID doesn’t match, the SDK request fails, and the SDK uses the local fallback file if you’ve set one up.
  • Turning off Show on device doesn’t remove a paywall from its placement: the placement still resolves to it, only without the Paywall Builder configuration, so the app has nothing to render. To stop showing a paywall, remove it from the placement’s audience instead.

Placements list

There are three types of placements:

  • Flow placements
  • Paywall placements
  • Onboarding placements

A placement’s type is set when you create it and can’t be changed afterwards, because each type is measured with its own metric set. Placement IDs are unique across every placement in the app, whatever the type, so the same ID can’t serve a flow in one place and a paywall in another.

To view all your placements, go to Placements from the Adapty main menu. You will see them categorized by Paywalls, Onboardings, and Flows tabs.

Each tab offers a comprehensive view of various locations in the user journey where flows, paywalls, onboardings, or A/B tests can appear. Each item in the list corresponds to a specific placement, allowing easy management and modification.

You can edit placement details, associate them with the desired flow, paywall, onboarding, or A/B test for a specified audience, or remove unnecessary placements. The numbers in the table reflect the analytics for placements since their activation.

placements-list.webp

From here you can:

  • Create a new placement
  • Edit an existing placement
  • Delete an existing placement
  • Download local fallback flows, paywalls, or onboardings. These files are used when a user opens the app and there’s no connection with the Adapty backend (no internet connection, or the rare case when the backend is down) and there’s no cache on the device. The same Fallbacks download covers both flows and paywalls — the SDK version you pick in the download dialog determines whether the bundle includes flows (SDK 4.0+) or just paywalls.