> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Quick start guide that walks you through setting up Qonversion: choose a mode, create a project, install the SDK, and implement Analytics or Subscription Management Mode.

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.

<Steps>
  <Step title="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:

    | Features                                                                                          | Analytics Mode (Observer) | Subscription Management Mode |
    | ------------------------------------------------------------------------------------------------- | ------------------------- | ---------------------------- |
    | Implementation time                                                                               | **20 minutes**            | **2+ hours**                 |
    | Subscription Analytics                                                                            | ✅                         | ✅                            |
    | Real-time Monitoring                                                                              | ✅                         | ✅                            |
    | Integrations (send data to other platforms)                                                       | ✅                         | ✅                            |
    | Apple Search Ads Insights                                                                         | ✅                         | ✅                            |
    | Raw Data Export                                                                                   | ✅                         | ✅                            |
    | Webhooks                                                                                          | ✅                         | ✅                            |
    | Subscriber Details & Custom User Properties                                                       | ✅                         | ✅                            |
    | Paywall experiments                                                                               | ✅                         | ✅                            |
    | Subscription Management (fetch in-app product data -> make purchase -> check subscription status) | ❌                         | ✅                            |
  </Step>

  <Step title="Create a project and register your app" id="2-create-a-project-and-register-your-app">
    1. Navigate to the [New Project](https://dash.qonversion.io/app/start/create) page and provide a new project's name. One project in Qonversion supports iOS, Android, and Web apps.

    2. In [Settings](https://dash.qonversion.io/project/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](ios-app-store-info-fields#2-generate-the-app-specific-shared-secret).
         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](android-store-setup).
         2. Android package name.
       * **Stripe App**: Please follow [this guide](stripe-integration) to connect Stripe to Qonversion.

    3. Get your Qonversion project key. You can find your Qonversion project key in the [Settings](https://dash.qonversion.io/project/settings) section of Qonversion. You will need this key to [configure the SDKs](install-sdk). The project key is not the same as a store shared secret or service account key.

           <img src="https://mintcdn.com/qonversion/NxsDOZgG-HJmkYhN/images/docs/a887265-Frame_1000002684.png?fit=max&auto=format&n=NxsDOZgG-HJmkYhN&q=85&s=722999ff9a3988163f8a7bc5e4d896c5" alt="" width="1384" height="846" data-path="images/docs/a887265-Frame_1000002684.png" />

    <Info>
      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.
    </Info>
  </Step>

  <Step title="Install the SDK">
    Install the Qonversion SDK for your platform:

    → [iOS SDK](ios-sdk-setup) → [Android SDK](android-sdk) → [Flutter SDK](flutter-sdk) → [React Native SDK](react-native-sdk) → [Unity SDK](unity-sdk) → [Cordova Plugin](cordova) → [Capacitor Plugin](capacitor) → [Web SDK](web-sdk)

    <Info>
      ### 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](kids-mode-sdk).
    </Info>
  </Step>

  <Step title="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](analytics-mode) (10 more minutes to set everything up).
    * For **Subscription Management Mode**, follow [this guide](subscription-management-mode).
  </Step>
</Steps>

## Additional Resources

→ Check out the [Sample Apps](sample-apps) → Tips on [testing](testing) → [Troubleshooting](troubleshooting) → [Migrating In-App Subscriptions](migrating-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.

<CardGroup cols={2}>
  <Card title="Displaying products" icon="grid-2" href="displaying-products">
    Fetch your configured products from Qonversion to build your paywall.
  </Card>

  <Card title="Making purchases" icon="cart-shopping" href="making-purchases">
    Trigger a purchase through the SDK and handle the result and errors.
  </Card>

  <Card title="Check entitlements" icon="circle-check" href="check-permissions">
    Read a user's active entitlements to unlock or gate premium features.
  </Card>

  <Card title="Testing" icon="flask" href="testing">
    Test purchases in the Apple and Google sandbox before going live.
  </Card>
</CardGroup>