Beta Program

Want to be the first to experience new SDK features? Test out the beta of the SDK and shape the future of our product.

Changelog:

v3.2.0-beta.1

• Release Date: April 25th, 2025

• minSdkVersion 21+

Bug fixes 🪲

• Fix improper TLS check

Features and Improvements ✨

• Support Android 15 Window Inset Changes

• Add enhanced detection of suspicious users

• Support Capacitor Wrapper (More on this below)

This is a pre-release version of our SDK. While we strive to thoroughly test our software, this version may contain issues. Please consider this when planning to use it in a production environment.

Note: If you encounter any problems, contact your Account Manager for assistance, and they will engage our tech team to help.

Update the dependency:

Kotlin

1. Add adjoe's repository to your root build.gradle (project level):

allprojects {
    repositories {
        ...
        maven {
            url  "https://releases.adjoe.io/maven"
        }
    }
}

1. Add the adjoe dependency to your app's build.gradle (module level):

dependencies {
    ...
    implementation 'io.adjoe:adjoe-sdk-android:3.2.0-beta.1'
}

---

If you use Kotlin DSL for adding dependencies, add the repo in the settings.gradle.kts

repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://releases.adjoe.io/maven") }
    }
}

Java

1. Add adjoe's repository to the settings.gradle file:

repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://releases.adjoe.io/maven") 
        }
    }
}

2. Add the adjoe dependency to your app's build.gradle (module level):

dependencies {
    ...
    implementation 'io.adjoe:adjoe-sdk-android:3.2.0-beta.1'
}

React Native

https://github.com/adjoeio/adjoe-react-native-sdk

1. Open your project's package.json file.

2. Add the adjoe as a dependency under the dependencies section. You can change the version number to the desired version of Playtime SDK.

dependencies: {
  "react-native-adjoe-sdk": "https://github.com/adjoeio/adjoe-react-native-sdk#v3.2.0-beta.1"
}

1. Open your build.gradle file in the android folder and add the following section:

allprojects {
    repositories {
        maven {
            url  "https://releases.adjoe.io/maven"
        }
    }
}

1. Run the command:

npm install

Flutter

https://github.com/adjoeio/adjoe-flutter-sdk

To integrate the adjoe Flutter SDK into your Flutter project, follow these steps:

1. Open your project's pubspec.yaml file.

2. Add the Playtime SDK as a dependency under the dependencies section. You can change the version number to the desired version of Playtime SDK.

dependencies:
  adjoe:
    git:
      url: https://github.com/adjoeio/adjoe-flutter-sdk
      ref: v3.2.0-beta.1

1. Save the pubspec.yaml

2. In your IDE run either of the the following two commands:

   1. pub get

   2. flutter pub get

Unity

Adjoe 3.2.0-beta.1 uses the Play Services Resolver, you can download a version of the Playtime SDK which is compatible wit the Play Services Resolver here. It contains only the source code and the AdjoeDependencies.xml file specifying the Playtime SDK: https://releases.adjoe.io/files/playtime/unity/3.2.0-beta.1/adjoe_sdk_android_unity_3.2.0-beta.1_psr.unitypackage

1. Add the adjoe SDK to your app by clicking:

Assets > Import package > Custom package....

1. Select adjoe's .unitypackage, click Open and the select Import. This will load the adjoe SDK into Assets/Adjoe.

Cordova

https://github.com/adjoeio/adjoe-cordova-sdk

1. Open your project's package.json file.

2. Add the Playtime SDK as a dependency under the dependencies section. You can change the version number to the desired version of Playtime SDK.

dependencies: {
  "cordova-plugin-adjoe": "https://github.com/adjoeio/adjoe-cordova-sdk#v3.2.0-beta.1"
}

1. Save the package.json and run the following command:

npm install

Capacitor

• Download the 3.2.0-beta.1 version of the adjoe SDK for Capacitor here: adjoe-capacitor-plugin-3.2.0-beta.1.tgz.

• After you have downloaded it, add the Adjoe SDK to your app by running the command: $ npm install --save path/to/adjoe-capacitor-plugin-3.2.0-beta.1.tgz in your app's root directory. This will extract the files from the tarball, add them to the node_modules folder and add an entry to your package.json.

• If you already added Android platform to your project you can skip this step and go to step 4 Install Android platfrom: npm install @capacitor/android Add Android platfrom: npx cap add android

• Open your build.gradle file in the android folder and add the following section:

  Copy

  allprojects {
      repositories {
          maven {
              url  "https://releases.adjoe.io/maven"
          }
      }
  }

• Sync your project: npx cap sync android

Use the Capacitor Wrapper

Part 1: Initialization

Playtime.init(
    {
        apiKey: SDK_HASH //MANDATORY,
        userId: "VALUE" // OPTIONAL,
        applicationProcessName: "VALUE" // OPTIONAL,
        playtimeParams: { // OPTIONAL
            uaNetwork: "VALUE", // OPTIONAL
            uaChannel: "VALUE", // OPTIONAL
            uaSubPublisherCleartext: "VALUE", // OPTIONAL
            uaSubPublisherEncrypted: "VALUE", // OPTIONAL
            placement: "VALUE" // OPTIONAL
        },
        playtimeExtension: { // OPTIONAL
              subId1: "VALUE", // OPTIONAL
              subId2: "VALUE", // OPTIONAL
              subId3: "VALUE", // OPTIONAL
              subId4: "VALUE", // OPTIONAL
              subId5: "VALUE" // OPTIONAL
        },
        playtimeUserProfile: { // OPTIONAL
              gender: "VALUE", // OPTIONAL
              birthday: "VALUE" // OPTIONAL
        }
    })
    .then(() => //INITIALIZATION FINISHED SUCCESSFULLY )
    .catch((err) => //HANDLE ERROR)

Part 2: Show Catalog

Playtime.showCatalog({ // PARAMETER IS OPTIONAL
	'uaNetwork': "uaNetwork_value",
	'uaChannel': "uaChannel_value",
	'uaSubPublisherCleartext': "uaSubPublisherCleartext_value",
	'uaSubPublisherEncrypted': "uaSubPublisherEncrypted_value",
	'placement': 'placement_value'
})
    .then(() => {
        console.log('Now showing Playtime catalog');
    })
    .catch((err) => {
        console.log('Could not show Playtime catalog');
        console.error(err);
    });