Create segments based on Apple Ads attribution in Adapty Ads Manager
You can create user segments directly from Adapty Ads Manager by picking the campaigns, ad groups, or keywords users came from. It makes it easy to personalize paywalls and offers based on an acquisition source, without setting up segment conditions manually.
After creating a segment, you can use it to assign different products and prices, run A/B tests, and customize paywall appearance.
To create a segment for each campaign from a script or an AI coding tool, use adapty asa segments create in the Adapty CLI.
Use cases
Here are some examples of how segments created from Apple Ads data can be used in practice:
-
Keyword-based paywalls. Show a feature-focused paywall to users from high-intent keywords, and a general paywall to users from broader discovery keywords.
-
Campaign-level offers. Offer longer trials or special pricing to users from selected Apple Ads campaigns, while keeping a standard offer for other users.
-
Creative-to-paywall consistency. Route users from ad groups promoting specific features to paywalls that highlight those features first.
-
High-ROI campaign optimization. Show a premium-first, full-price paywall to users from campaigns that consistently drive higher lifetime value.
Open the Segments page
The Segments page lists the segments you built from Apple Ads for one app, the ads each segment includes, its profile count, and the placements that use it.
To open the page, in the Adapty Ads Manager sidebar, click Segments, and then choose an app.
Adapty creates the segments in the Adapty app that matches your Apple Ads app by Apple app ID or Bundle ID. If no Adapty app matches, the page asks you to choose one in the Choose Adapty app dropdown. Your browser remembers this choice, but other browsers and teammates don’t see it. To match the apps for everyone, add the Apple app ID to the Adapty app’s App Store integration settings.
Create a segment
A segment includes users who installed your app after tapping an ad from the campaigns, ad groups, or keywords you add to it.
To create a segment:
- Open the segment editor in one of these ways:
- On the Segments page, click + New segment.
- In Ads Manager, switch to the Campaigns, Ad groups, or Keywords tab and select the rows to include. Then click Actions > Create segment from campaigns/ad groups/keywords. All selected rows must belong to one app.
- In Name, enter the segment name. Adapty adds the fixed
[ASA]prefix to the name, so you can tell Apple Ads segments from other segments in Adapty. - To add ads to the segment, under Who’s in it, click + Add campaigns, ad groups or keywords. Select the campaigns, ad groups, or keywords and click Add. A segment can include keywords, or campaigns and ad groups, but not both.
- Click Create segment.
If you add both campaigns and ad groups, Adapty saves the campaigns as the ad groups they contain when you save the segment. Ad groups you add to these campaigns later don’t join the segment.
The Ideas from your ads chips on the Segments page suggest segments built from your ads, such as one ad group name used in several campaigns. Click an idea to open it in the editor, then change anything before you save.
Use the segment in a placement
Adapty doesn’t add a new segment to any placement. After you create a segment, the Segment created dialog lists the placements of the Adapty app.
To show users in the segment their own paywall, onboarding, or A/B test, open a placement and add the segment as an audience.
To add the segment to a placement later, on the Segments page, click Use in the segment’s Used in column.
Add ads to an existing segment
To add campaigns, ad groups, or keywords to a segment you already have:
- In Ads Manager, switch to the Campaigns, Ad groups, or Keywords tab and select the rows.
- Click Actions > Add to segment….
- Select the segment. A segment of keywords can’t take campaigns or ad groups, and a segment of campaigns and ad groups can’t take keywords, so the dialog disables segments of the other kind.
- In the segment editor, review the ads and click Save. Adapty doesn’t change the segment until you save it.
Edit or delete a segment
To open a segment in the editor, on the Segments page, click the segment’s row. There, you can rename the segment and add or remove ads.
If a placement uses the segment as an audience, saving the segment immediately changes which users see that audience’s paywall or onboarding. The Used in section of the editor lists these placements.
To delete a segment, in the editor, click Delete and confirm. Adapty deletes the segment and removes it from the audiences of every placement that uses it.
Segments that don’t appear on the page
The Segments page shows only segments with the [ASA] prefix whose only condition is a list of Apple Ads campaigns, ad groups, or keywords. If you edit an [ASA] segment in Profiles & Segments and add another condition, the Segments page hides it. To find the segment, click open in Adapty under the segment list. It opens Profiles & Segments.