Get Started

Current version: 1.9.0 . View Changelog.

Follow this guide to configure your app to work with the Playtime SDK using any of our supported wrappers.

Part 1: Pre-Requisites

Get Your SDK Hash

Contact your Account Manager to get an SDK hash for your app. Or if you already have access, it can be retrieved from the Monetize Dashboard.

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.

Add Test Devices

Important: Execute this step after the Playtime SDK initalized on the device for the first time!

To fully test the Playtime SDK integration and access all campaign types, configure your physical devices and simulators as test devices. Without this step, the types of available campaigns you get will be limited.

Find Your IDFA (Apple Advertising ID):
1. Apple doesn't allow you to see your IDFA directly in the device settings, but you can find it using a third-party app on the App Store – such as My Device ID or My TUNE Device. Simply download and open one of these apps, and your IDFA (along with other details like your device's IP address) will be shown on the main screen.
Register as a Test User:
1. With your IDFA, go to the Monetize Dashboard. If you don't have dashboard access, contact your Account Manager.
2. In the dashboard, find "Test Users" under configuration settings and enter your IDFA.

Please note: If you reset your device's IDFA, remember to update the test device information in the dashboard with the new IDFA before accessing the Playtime SDK again.

Add the Dependency

The Swift Package Manager automates the distribution of Swift code. To use Playtime with SPM, add the dependency from https://github.com/adjoeio/adjoe-monetize-spm .

With Xcode

Go to File → Add Package Dependencies in the Menu Bar in Xcode. Search for `https://github.com/adjoeio/adjoe-monetize-spm and add it to your app's target.

Using Package.swift file

If your project uses Package.swift file, add Playtime as a dependency:

dependencies: [
  .package(url: "https://github.com/adjoeio/adjoe-monetize-spm", from: "1.9.1")
]

And then add the following product to any target that needs access to the library:

.product(name: "PlaytimeMonetize", package: "adjoe-monetize-spm")

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

In your project directory, create a Podfile if one doesn’t already exist.
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.
```
source 'https://github.com/adjoeio/PlaytimeSpecExternal.git'

platform :ios, '14.0'

target 'MyApp' do
  use_frameworks!

  pod 'PlaytimeMonetize', '~> 1.9.1'
end
```
Open a terminal and navigate to your project’s root directory.
Run the following command to update the CocoaPods repository and install the dependencies:
```
pod install --repo-update
```
Once installation is complete, open the .xcworkspace file generated by CocoaPods. The Playtime SDK will now be available for use within your project.

Check out our troubleshooting guide if you run into any issues with Cocoapods

Obtain a release archive from adjoe and extract the .xcframework from it. Place within your project’s root folder.
Link the framework with your target:
- Go to the Project Navigator
- Select your target
- Go to the General tab
- Go down to the section Frameworks, Libraries, and Embedded Content
- Click on add a new file
- Choose the .xcframework
- Set Embed & Sign.

Install React Native dependency

To integrate the adjoe React Native module into your React Native project, follow these steps:

Open your project's package.json file.
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-ios": "https://github.com/adjoeio/adjoe-react-native-sdk-ios#1.9.0"
}

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

npm install --save https://github.com/adjoeio/adjoe-react-native-sdk-ios#1.9.0
yarn add https://github.com/adjoeio/adjoe-react-native-sdk-ios#1.9.0

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

Install Native dependency

You need to add the native iOS SDK as a dependency to your native iOS project.

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

In your project directory, create a Podfile if one doesn’t already exist.
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.
```
source 'https://github.com/adjoeio/PlaytimeSpecExternal.git'

platform :ios, '13.0'

target 'MyApp' do
  use_frameworks!

  pod 'PlaytimeMonetize', '~> 1.9.1'
end
```
Open a terminal and navigate to your project’s root directory.
Run the following command to update the CocoaPods repository and install the dependencies:
```
pod install --repo-update
```
Once installation is complete, open the .xcworkspace file generated by CocoaPods. The Playtime SDK will now be available for use within your project.

Check out our troubleshooting guide if you run into any issues with Cocoapods

Part 2: App Attest Integration

The Playtime SDK for iOS makes use of Apple's DeviceCheck APIs to ensure that the app is launched on a real device and that there haven't been any malicious alterations. This allows us to better protect your app and your revenues.

To ensure that the SDK runs as expected, you must complete the following steps, even if the app builds normally. Failure to complete a step could cause the app to disfunction or be rejected from the App Store. You can read more about the App Attest service here.

Enable App Attest

Go to Apple Developer Certificates, IDs & Profiles
Select your app ID
Ensure App Attest is enabled under Capabilities

Add required capabilities

Select the project of your application in the Project Navigator
Select your target
Go to the tab Signing & Capabilities
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.

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.

Key ID: Generate a key identifier associated with the enabled service.
Team ID: Provide the Team ID, which app ID prefix: 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.

Do not use the same credentials, i.e., team ID, with device check for your own app. adjoe should be the only one using the AppAttest / DeviceCheck service with your team ID.

Upload Credentials

Add the Credentials under Edit Application in the Monetize Dashboard.

PreviousPlaytime SDK for iOS NextUse the SDK

Last updated 15 days ago