Purchasely allows to segment your user base into different segments by creating audiences and tailoring the screens displayed for each audience.

General functioning

The Purchasely SDK handles User Attributes. There are two sets of user attributes:
- Built-in user attributes: they are natively managed by the SDK and work without requiring any particular development.
  Eg: app version, platform name, active subscription status, active subscription plan, user id, IP country, app sessions
  View the full list of built-in user attributes
- Custom user attributes: they are additional user properties that can be injected by the app into the Purchasely Platform through an API of the SDK. These custom user properties can be collected by the app during the onboarding or when users interact with the app.
  Eg: gender, sign-up date, age, intent, current location, contents read, favorite team
  How to manage Custom User Attributes
These User Attributes can be combined together with boolean operators to create an Audience.
Build Audiences to segment your user base and tailor the screen displayed for each audience
- All the users belonging to a same Audience share a common set of {attribute, value}
- One user can belong to several audiences at the same time
For each Placement, you can customize the screen displayed for a particular audience. Each audience can be prioritised.

In the example above, iOS users in the US will see the "Screen Guided tour /6", whereas Android users in France will be exposed to an A/B test. Users who don't belong to any of the audiences associated will not see any screen displayed (NONE).

When displaying a Placement, the SDK will check to which audience the user belongs by starting with the audience with the highest priority (= lowest value in the Priority column = the one on top of the placement)
- if the user belongs to it, the associated screen is displayed
- if the user does not belong to it, the SDK repeats the same operation with the second highest priority audience and so on and so forth
- if the user does not belong to any audience associated with the Placement, it will display the screen associated with the audience Everyone else.

A/B tests can also be configured specifically for a particular audience.

Syncing external user lists

If you wish to reuse user lists or cohorts created in 3rd-party tools (such as Braze, Amplitude, or your own backend), you have two options:

Custom Audiences API (recommended): Use the Custom Audiences API to sync static lists of user identifiers directly from your external tools to Purchasely. Custom Audiences can then be used in Placements just like Audiences.
Custom User Attributes: Alternatively, the app can fetch a cohort identifier from the 3rd-party platform and inject it into the Purchasely SDK using a Custom User Attribute, then create an Audience matching that attribute.