Get Started
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.
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.
Troubleshooting:
If you do not see any apps returned or if you run into any errors after this setting is enabled, please try a fresh install.
iOS Simulators are not currently permitted with SandboxMode - you must use a physical device or TestFlight builds for testing.
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")
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
Select your app ID
Ensure App Attest is enabled under Capabilities

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.
Last updated