Skip to main content
Version: 3.0

Segments

A Segment is a group of users with common properties.

Segments are mainly used in Placements and in A/B tests to create an Audience and target it with a paywall (or multiple paywalls). Here are some example scenarios where that can be useful:

  • targeting non-subscribed users with the default paywall and offering a discount for those who have previously canceled their subscription or a trial.
  • having different paywalls for different countries
  • basing your segment on the Apple Search Ads attribution data
  • creating segments based on your app's version, so that once you introduce a new paywall that is only supported by the recent versions of your app, the older versions would still continue to work

Creation

To create a segment, write a segment name, and choose attributes.

Available attributes

  • Age of the user
  • App User ID
  • App Version
  • Calculated subscription state
  • Calculated total revenue USD
  • Country from IP
  • Country from store account
  • Creation date
  • Device
  • Gender
  • Language
  • OS
  • Platform
  • Subscription expiration date
  • Subscription product
  • Attribution Source: Organic, Non-Organic, Unknown
  • Attribution Channel
  • Attribution Campaign
  • Attribution Ad Group
  • Attribution Ad Set
  • Attribution Creative
  • Custom Attributes
note

Please note that these attributes are predefined and cannot be modified, except for the App Version attribute, which allows for adding new values.

Custom attributes

To create even more targeted segments, you can also create custom attributes. Custom attributes allow you to create user groups based on properties that are specific to your app or business.

note

To create custom attributes, you can set them up in either the mobile SDK or the dashboard, and there is no specific order in which they need to be created. To set up custom attributes in the mobile SDK, please follow this link to learn how to set them up.

warning

Adapty collects the country of the store for iOS devices with version 13 or higher.

To create custom attributes from the Adapty Dashboard, select the ** Create Custom Attributes** from the Select Attribute Dropdown options.

Here's how to fill the fields for custom attributes. Also, you can read more about custom attribute validation rules here.

  1. Name represents the name of the custom attribute and will be used in the Adapty dashboard only.
  2. Key is the unique identifier for the custom attribute. This key value should match the key value used in the SDK.
  3. Type field has two options. If you select "String", you have to enter a list of possible values for the attribute. If you select "Number", the attribute will accept only numeric values.
  4. If you selected "String" as the type, enter a list of possible values for the attribute. If you selected "Number", the attribute will accept only numeric values.

Complete all the required fields first, and then you can begin utilizing the custom attribute in your segment definition. Once you've created your segments, you can use them to target A/B testing, among other things!