Quickstart guide

A brief guide on getting started with Adapty

We’re thrilled you’ve decided to use Adapty! We want you to get the best results from the very first build. This guide will walk you through how to get started with Adapty

Creating a project and registering an application

Create a new application. In App settings -> General tab you can configure the application settings. Mark the checkbox if you are participating in the Small Business program.

Configuring platforms

Configure SDKs to validate purchases and get subscription updates from one or both platforms in Adapty.

App Store configuration
In Adapty Dashboard, go to App settings > iOS SDK and fill in the fields using the instructions below.

App Store configuration

To find App Bundle ID open iTunes Connect, go to My Apps, and select the app whose ID you need. On the app page, in the drop-down More menu, select About this App. The app ID is displayed in the Bundle ID field.
Where to find App Store Shared Secret?
How to set URL for App Store Server Notifications?

Play Store configuration
Go to App settings > Android SDK and fill in the fields.

Play Store configuration

To find Package Name Open the Google Play Developer Console and select the app whose ID you need. The ID is specified next to the app's name and logo.
Where to find Service account key file?
Where to find Real-time Developer Notifications (RTDN)?

Creating a product

Add Access Level (optional)

Creating a product

Add product

Add product

Add paywall

Installing Adapty SDK

Install Adapty SDK in your app and be sure you have replaced the "PUBLIC_SDK_KEY" placeholder with your actual Public SDK key.

Bear in mind, that SDK calls must be made after calling .activate() method. Otherwise, we won't be able to authenticate requests and they will be canceled.

Adapty.activate("PUBLIC_SDK_KEY", customerUserId: "YOUR_USER_ID")
override fun onCreate() {
    Adapty.activate(applicationContext, "PUBLIC_SDK_KEY", customerUserId: "YOUR_USER_ID")
<application ...>
              android:value="PUBLIC_SDK_KEY" />
import { activateAdapty } from 'react-native-adapty';

const App: React.FC = () => {
  // ...
  useEffect(() => {
    activateAdapty({ sdkKey: 'PUBLIC_SDK_KEY' });
  }, []);
  // ...

Configuring processing of purchases

Adding App Store shared secret for iOS and both package name with service account key file for Android would be neccessary to allow Adapty to successfully process purchasing events

Subscription events

Here is what you can do to set up tracking of subscription events

For iOSUpdate the App Store Server Notifications with our link
For AndroidSet up Real-time Developer Notifications (RTDN)


Integrations with third-party analytics and attribution services require passing identifiers to the SDK.

.updateProfile()Use this method to passing identifiers to Amplitude, Mixpanel, Facebook Ads, and AppMetrica
.updateAttribution()This method would be required for passing attribution data from AppsFlyer, Adjust, and Branch. Be sure to configure the integration of interest in Adapty Dashboard, by providing API key and event names

Promo campaigns and promo offers

If you want to use Adapty along with Apple Promotional Offers, adding a subscription key will allow us to sign offers.



Don't forget about Privacy Labels

Learn more about the data Adapty collects and which flags you'd need to set for a review.


Make sure to send paywall views to Adapty using .logShowPaywall() method. Otherwise, paywall views will not be accounted for in the metrics and conversions will be irrelevant.

If you have any questions about integrating Adapty SDK, feel free to contact us using the website (we use Intercom in the bottom right corner) or just email us at [email protected].