Unity

Install Unity SDK to validate user receipts, get in-app subscription analytics, and 3-rd party integrations.

Install via OpenUPM

Qonversion SDK package is available on the openupm registry. You can install it via openupm-cli.

openupm add com.qonversion.unity

Install via Git URL

Available starting from Unity 2018.3.
Just add this line to the Packages/manifest.json file of your Unity Project:

"dependencies": {
    "com.qonversion.unity": "https://github.com/qonversion/unity-sdk.git#3.2.1"
}

🚧

Installation for Observer Mode

If you are using Qonversion Unity SDK in Observer Mode, please check the Google Play Billing Library version in your in-app subscription implementation. For the library version 3. x.y, you have to use the major version of the SDK 2.x.y. In other cases use the latest SDK version (version 3.0.0 and above).
For the Unity IAP version 4.x.y use the SDK version 2.x.y.

🚧

Attention

Make sure your project contains External Dependencies Manager package.
Otherwise, iOS & Android dependencies can not be resolved.
And this can result to the package import issue.
See more on GitHub

Settings for Observer Mode (Android only)

❗️

Duplicated BillingClient classes

If you already have your in-app subscription implementation that uses Google Play Billing Library, you may get a compilation error about duplicate BillingClient classes. To get rid of the error, you can exclude the billingclient dependency which distributes with the Qonversion SDK following the guide below:

  1. In the Unity Editor open the Player Settings window: File -> Build Settings -> Player Settings for Android.
  2. Choose Publishing Settings -> Gradle.
  3. Enable the checkboxes for Custom Main Gradle Template and Custom Gradle Properties Template.
  1. It will generate a mainTemplate.gradle file in theAssets/Plugins/Android/ folder. Add the following strings to the dependencies block of the file:
dependencies {
    ...
    
    configurations.all {
        exclude group: 'com.android.billingclient', module: 'billing'
    }
}
  1. Delete resolved dependencies: Assets -> External Dependency Manager -> Android Resolver -> Delete Resolved Libraries and then Resolve.
  2. Make sure that the Android Resolver added qonversion-sdk to the dependencies list in the build.gradle file for the unityLibrary module:

Setup

Setup with a Launcher

Navigate to the settings in your Qonversion Dashboard and copy the Project Key. Paste it into the Application Access Key field.

Optional

  1. Enable Debug Mode if needed. If debug mode is set to true, user purchases will be checked on the sandbox environment.
  2. Enable Observer Mode if needed. You can read more about Observer Mode in our guide.

Programmatic setup with a Script

Please check the Launching section of our guides for the Observer Mode and the Infrastructure mode.


Did this page help you?