Skip to main content
Setting up Qonversion takes four steps: choose a mode, create a project and register your app, install the SDK, and implement the mode you chose. Follow the steps below in order.
1

Choose the Qonversion mode you want to implement

Qonversion offers two modes. Pick one before you start — the SDK setup and the amount of code you write differ between them.
  • Analytics Mode (Observer) — implement in about 20 minutes to get best-in-class mobile subscription analytics and leverage subscription data with integrations and webhooks. It does not manage purchases or entitlements for you.
  • Subscription Management Mode — required if you want Qonversion to fetch product data, make purchases, and check subscription status, including managing cross-platform user access. Expect 2+ hours to set up.
The comparison of the features available with each mode is presented below:
2

Create a project and register your app

  1. Navigate to the New Project page and provide a new project’s name. One project in Qonversion supports iOS, Android, and Web apps.
  2. In Settings, select the platform for your app and provide platform-specific data:
    • iOS App:
      1. App-Specific Shared Secret — you can find more details here.
      2. Your app’s App Store ID. To get your app’s App Store ID, navigate to the Apps tab in your App Store Connect account. Click on your app. You can see the App ID in the URL.
    • Android App:
      1. Service Account Key credentials — you can find more details here.
      2. Android package name.
    • Stripe App: Please follow this guide to connect Stripe to Qonversion.
  3. Get your Qonversion project key. You can find your Qonversion project key in the Settings section of Qonversion. You will need this key to configure the SDKs. The project key is not the same as a store shared secret or service account key.
Please note, it may take up to 24 hours for your Google service credentials to work properly with the Android Developer API. You may see “Please provide valid JSON credentials” during the first 24 hours until the credentials start working correctly.
3

Install the SDK

Install the Qonversion SDK for your platform:→ iOS SDK → Android SDK → Flutter SDK → React Native SDK → Unity SDK → Cordova Plugin → Capacitor Plugin → Web SDK

​
Kids Mode SDKs

If you are building an app for kids, it is necessary to follow policies and not collect IDFA, GAID, and other advertisement attributes. For Kids Mode SDK integration follow this guide.
4

Implement Analytics or Subscription Management Mode

Use the mode you chose in Step 1 and follow the required option:
  • For Analytics Mode, follow this guide (10 more minutes to set everything up).
  • For Subscription Management Mode, follow this guide.

​
Additional Resources

→ Check out the Sample Apps → Tips on testing → Troubleshooting → Migrating In-App Subscriptions

​
Next steps

After the SDK is installed and your mode is implemented, wire up the purchase flow and verify access. These steps apply to Subscription Management Mode.

Displaying products

Fetch your configured products from Qonversion to build your paywall.

Making purchases

Trigger a purchase through the SDK and handle the result and errors.

Check entitlements

Read a user’s active entitlements to unlock or gate premium features.

Testing

Test purchases in the Apple and Google sandbox before going live.