Skip to main content

Get started with Adapty User Acquisition

Adapty User Acquisition helps you connect ad spend with subscription revenue in web-to-app campaigns, giving you a complete view of your app's economy in one place.

To see your revenue data in Adapty User Acquisition, you must first enable the integration in the Adapty dashboard. You don't need to pass any API keys, tokens, or identifiers. Just update and configure the Adapty SDK.

warning

User Acquisition is only available with:

  • iOS, Android, and Flutter Adapty SDK version 3.9.0 or higher.
  • React Native Adapty SDK version 3.10.0 or higher.
  • Unity SDK version 3.12.0 or higher.

Before you start​

To connect your revenue data with the campaign performance, let Adapty keep track of your purchases:

  • If you already have in-app purchases implemented with Adapty, you don't need to do anything else at this stage.
  • If you don't have in-app purchases implemented yet and want to use Adapty, complete the steps from the quickstart guide to delegate handling purchases to Adapty.
  • If you already have in-app purchases implemented without Adapty and don't plan to migrate to Adapty, install the Adapty SDK for your platform in the observer mode. At this stage you only need to add the SDK to your project, activate it with the observer mode enabled, and report transactions:

This setup enables web-to-app attribution:

  • When users install your app, the Adapty SDK gets the installation details from the link parameters, so Adapty UA can get the campaign details
  • The Adapty SDK knows about all revenue-related events inside the app and can attribute them to web campaigns.

Step 1. Enable the User Acquisition integration​

To start sending revenue events to Adapty UA:

  1. Go to Integrations > Adapty in the Adapty Dashboard.
  2. Turn on the toggle.

Once your events begin firing, you’ll see the following details for each event:

  • Event name
  • Status
  • Environment
  • Date time

Supported events​

By default, Adapty sends three groups of events to User Acquisition:

  • Trials
  • Subscriptions
  • Issues

You can check the full list of supported events here.

Adapty uses tracking links to connect app installs with campaign data. You must use a tracking link as the destination URL in every ad campaign you want to measure in Adapty UA.

If you run ads on multiple platforms, set up tracking links for each platform separately.

There are two ways Adapty works with ad platforms:

  • Native integrations (Meta Ads, TikTok Ads). Adapty connects directly to the ad platform. Tracking links are generated automatically, and campaign parameters are filled dynamically based on where the link is used. You can use the same link across different campaigns, ad sets, or creatives, and Adapty will automatically receive the correct campaign data and ad spend.

  • Tracking links only (all other ad platforms). Adapty does not connect to the ad platform. Tracking links are created manually, and all campaign parameters must be defined explicitly when creating the link. Ad spend data is not available for these platforms.

To create a tracking link for Meta Ads:

  1. Go to Integrations > Meta in the Adapty UA Dashboard and click Continue with Facebook.
  1. Sign in using your Facebook account and click Continue.
  1. Review the requested permissions and click Save.
  2. Switch to the Web campaigns tab and click Create campaign. Select the app and click Save.
  1. In the General tab, expand the iOS and/or Android section and paste App Store and/or Google Play application URLs. Then, click Save.
  1. Copy the Click link field value for one link or for a platform-specific link. Then, in Meta Ads Manager, open your ad and paste this link as a destination URL.
important

In the Website URL field, paste https://api-ua.adapty.io/api/v1/attribution/click. Paste the rest of the link to the URL parameters field in the Tracking section. It will help your Meta ad to get approved. See more recommendations on setting up your ads in Meta Ads Manager.

  1. Now, when you launch your ad in Meta Ads, its data will become available for analysis in the Adapty UA dashboard.

Step 3. Launch your web-to-app campaign and view results​

Once your campaign is live and users start installing your app, Adapty begins attributing installs and revenue to your campaigns.

In the Adapty UA analytics dashboard, you will see campaign-level metrics such as:

  • Installs and conversions
  • Subscription and purchase revenue
  • Performance breakdown by ad platform, campaign, ad set, and creative

Metrics appear as soon as install and revenue events are received from your app. Ad spend data is available for platforms with native integrations.

Learn more​

Continue with in-depth documentation on Adapty User Acquisition analytics and practical guides for running campaigns on major ad platforms: