Installation & Setup

You need two packages: the GPM WebView (which the SDK uses to display the store) and the PlaySuper SDK itself. After installing both, configure your build settings for the platforms you ship to.

Step 1: Install GPM WebView

1. Go to the GPM asset page and click Add to My Assets to link it to your Unity account.

2. In your Unity project, open Window > Package Manager, switch the dropdown to My Assets, find Game Package Manager, and click Import.

3. After the import finishes, go to Tools > GPM > Manager. Select WebView in the left panel and click Install.

Step 2: Install the PlaySuper SDK

Install the SDK via OpenUPM:

openupm add com.playsuper.unity

This installs the latest published version. To check which version you have, open Packages/manifest.json or Window > Package Manager > PlaySuper. Release notes are on GitHub.

Step 3: Configure your project

Android

These steps ensure the WebView works correctly on Android:

1. Open File > Build Settings and confirm the platform is set to Android. If not, select Android and click Switch Platform.

2. Open Edit > Project Settings > Player and navigate to the Android publisher settings.

3. Enable Custom Main Gradle Template and Custom Gradle Properties Template. This creates two files in Assets/Plugins/Android/.

4. Open Assets/Plugins/Android/mainTemplate.gradle and add the AndroidX dependencies:

dependencies {
    implementation 'androidx.browser:browser:1.4.0'
    implementation 'androidx.appcompat:appcompat:1.4.2'
    // other dependencies...
}

5. Open Assets/Plugins/Android/gradleTemplate.properties and add:

android.useAndroidX=true

iOS

No project changes are needed beyond installing GPM WebView. The store opens in a WKWebView managed by GPM, and the SDK's iOS code paths are included in the package.

Two things to know:

• App Tracking Transparency. The SDK does not collect the advertising identifier by default. If you want it in analytics, call PlaySuperUnitySDK.EnableAdvertisingIdCollection() only after the player has granted the ATT prompt. Nothing in the SDK triggers the prompt for you.
• Continue Playing button. The store's close button relies on a handoff between the store and the SDK. Keep the SDK current (4.3.0 or later) so it works on iOS 26 and newer.

You are now ready to write code. Continue to Core Usage to initialize the SDK and start distributing coins.