Get Started

Get Your SDK Hash

The SDK hash is a unique 32-character code that uniquely identifies your app within adjoe's systems. Each app receives a distinct hash. Remember to keep your hash confidential to prevent unauthorized use.

Enable SandboxMode

To fully test the Playtime SDK integration and access all campaign types, configure your application to be in "SandboxMode". Contact your Account Manager to have this setting enabled for your environment.

Install the dependency

Follow these steps to integrate the adjoe React Native module into your project:

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 adjoe SDK you want to integrate.

dependencies: {
  "react-native-adjoe-sdk": "https://github.com/adjoeio/adjoe-react-native-sdk#v4.1.1"
}

Alternatively, you can use your project's package managers to perform the installation:

• npm install --save https://github.com/adjoeio/adjoe-react-native-sdk#4.1.1

• yarn add https://github.com/adjoeio/adjoe-react-native-sdk#4.1.1

The package doesn't support Expo by default. To install it in an Expo project, see the official documentation on installing third-party packages.

iOS: Add the Native Dependency

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website.

1. In your project directory, create a Podfile if one doesn’t already exist.

2. Inside the Podfile, add the following configuration to include the Playtime SDK as a dependency within your app’s target. You can also specify a version or version range—see the CocoaPods Podfile syntax reference for more details.

   Copy

   Copy

   source 'https://github.com/adjoeio/PlaytimeSpecExternal.git'
   
   platform :ios, '14.0'
   
   target 'MyApp' do
     use_frameworks!
   
     pod 'PlaytimeMonetize', '~> 4.1.1'
   end

3. Open a terminal and navigate to your project’s root directory.

4. Run the following command to update the CocoaPods repository and install the dependencies:

   Copy

   Copy

   pod install --repo-update

5. Once installation is complete, open the .xcworkspace file generated by CocoaPods. The Playtime SDK will now be available for use within your project.

Android: Add the Native Dependency

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

dependencies {
    ...
    implementation 'io.adjoe:adjoe-sdk-android:4.1.1'
}

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

Enable App Attest

1. Go to Apple Developer Certificates, IDs & Profiles

2. Select your app ID

3. Ensure App Attest is enabled under Capabilities

Add required capabilities

1. Select the project of your application in the Project Navigator

2. Select your target

3. Go to the tab Signing & Capabilities

4. Add the App Attest capability

Gather Credentials:

In order for adjoe's services to work with your app, the following credentials will need to be enabled for your app. They can be uploaded at the app-level in the Monetize Dashabord.

If you plan on using a dev and a prod environment, you will need to make sure distinct credentials are added for both app bundles, e.g., playtime.app.dev and playtime.app.

1. Private Key: Generate a private key that can be used for the AppAttest service and provide the file with the .p8 extension to adjoe. You can find the instruction on how to get the .p8 here. Only the DeviceCheck/AppAttest Service should be added.

1. Key ID: Generate a key identifier associated with the enabled service.

2. App ID: Provide the App ID, which contains the Team ID and the Bundle ID separated with a dot, for example: M4CAP9HPPJ.com.my.app. You can learn more about the app ID here.

Make sure that after you add the capability to your project, you can see the .entitlements file. Specify the production environment.

Upload Credentials

Add the Credentials under Edit Application in the Monetize Dashboard.