Integrate with ironSource
This page covers every SDK platform and version. A part that applies only to some platforms starts with Platform: …, and a part that applies only to some SDK versions starts with SDK version: ….
If you use ironSource, you can automatically track Advertisement revenue from Impressions with justtrack SDK.
Before you begin
Please review the following compatibility matrix to make sure you're using compatible versions:
| justtrack SDK | ironSource Adapter | Mediation SDK |
|---|---|---|
| 8.0.0+ | 3.x | Unity LevelPlay 9.x (com.unity3d.ads-mediation) |
| 6.0.0+ | 2.x | ironSource 8.11+ |
| 6.0.0+ | 1.x | ironSource 8.0 -> 8.10 |
Adapter 3.0.0 is built against the Unity LevelPlay mediation API. If you're still on the older ironSource mediation SDK, stay on adapter 2.x until you migrate.
Integrate with ironSource
First, add the adapter dependency to your package manager:
- Kotlin
- Groovy
dependencies {
implementation("io.justtrack:adapter-ironsource:1.0.0")
}
dependencies {
implementation "io.justtrack:adapter-ironsource:1.0.0"
}
Then, initialize the adapter, and integrate it with the justtrack SDK:
import io.justtrack.integrations.ironsource.IronSourceIntegrationAdapter
// Integrate the adapter while you build the SDK
val sdk = JustTrackSdkBuilder(this, API_TOKEN)
.addIntegrationAdapters(IronSourceIntegrationAdapter("your user id or null"))
.build()
// Or after...
sdk.integrateWith(IronSourceIntegrationAdapter("your user id or null"))
If you use ironSource, you can automatically track Advertisement revenue from Impressions with justtrack SDK.
Before you begin
Please review the following compatibility matrix to make sure you're using compatible versions:
| justtrack SDK | ironSource Adapter | ironSource SDK |
|---|---|---|
| 6.0.0+ | 1.x | 8.x |
Integrate with ironSource
First, add the adapter dependency to your package manager:
- Cocoa Pods
- Swift Package Manager
- Carthage
pod 'JustTrackSDKIronSourceAdapter', '~> 1.0.0'
https://github.com/justtrackio/justtrack-sdk-spm.git
binary "https://sdk.justtrack.io/carthage/JustTrackSDKIronSourceAdapter.json"
Then, initialize the adapter, and integrate it with the justtrack SDK:
import JustTrackSDK
import JustTrackSDKIronSourceAdapter
// Build the SDK
let sdk = try JustTrackSdkBuilder(apiToken: apiToken)
.set(trackingId: trackingId, trackingProvider: trackingProvider)
.build()
// Integrate the ironSource adapter, providing a user ID or nil
sdk.integrate(with: JusttrackIronSourceAdapter(customUserId: "your user ID or nil"))
// Or, integrate the ironSource adapter without a user ID
sdk.integrate(with: JusttrackIronSourceAdapter())
If you use ironSource, you can automatically track Advertisement revenue from Impressions with justtrack SDK.
Before you begin
Please review the following compatibility matrix to make sure you're using compatible versions:
| justtrack SDK | ironSource Adapter | ironSource SDK |
|---|---|---|
| 6.0.0+ | 2.x | 3.x |
| 6.0.0+ | 1.x | 2.x |
Integrate with ironSource
First, add the adapter dependency to your package manager:
npm install justtrack-adapter-ironsource --save
Then, initialize the adapter, and integrate it with the justtrack SDK:
import { registerAdapter as registerIronSourceAdapter } from 'justtrack-adapter-ironsource';
registerIronsourceAdapter('ironSource user id or null');
// Initialize ironSource
LevelPlay.init(req, initListener);
// Initialize older version of ironSource
await IronSource.init('token', []);
If you use ironSource, you can automatically track Advertisement revenue from Impressions with justtrack SDK.
Before you begin
Review the following compatibility matrix to choose the ironSource adapter version that matches your mediation SDK. Automatic uses the default version.
| Platform | ironSource Adapter | Mediation SDK |
|---|---|---|
| Android | 3.x (default) | Unity LevelPlay 9.x |
| Android | 2.x | ironSource 8.11+ |
| Android | 1.x | ironSource 8.0 -> 8.10 |
| iOS | 2.x (default) | Unity LevelPlay 9.x |
| iOS | 1.x | ironSource 8.x |
If you're still on an ironSource 8.x mediation SDK, choose adapter 2.x on Android and adapter 1.x on iOS until you migrate to Unity LevelPlay 9.x.
Integrate with ironSource
- In the Unity Editor, navigate to the justtrack SDK configuration prefab.
- Select the Android or iOS tab, and enable Add IronSource Adapter. This adds the ironSource adapter to your project for that platform.
- Optional: In Adapter Version, choose the adapter version that matches your mediation SDK. See Choose an adapter version.
- Call the integration method in your code:
using JustTrack;
// Call this after SDK initialization
JustTrackSDK.IntegrateWithIronSource(
customUserId: "your user id or null", // optional
pOnSuccess: () => {
Debug.Log("IronSource integration successful");
},
pOnFailure: (error) => {
Debug.LogError($"IronSource integration failed: {error}");
}
);
// Or without custom user ID
JustTrackSDK.IntegrateWithIronSource(
customUserId: null,
pOnSuccess: () => {
Debug.Log("IronSource integration successful");
},
pOnFailure: (error) => {
Debug.LogError($"IronSource integration failed: {error}");
}
);
You must wait for the success callback before initializing the IronSource SDK, itself.
Choose an adapter version
You can choose which adapter version the justtrack SDK adds to your project. After you enable an adapter, an Adapter Version menu appears below it with these options:
- Automatic: Uses the default adapter version for your installed justtrack SDK. Use this option unless your third-party SDK version needs a different adapter.
- A specific version, such as 1.0.0 or 2.0.0: Uses the latest stable release of that major version. Choose the version that matches your third-party SDK in the compatibility matrix.
- Custom: Lets you enter any version. Enter an adapter version that's already published. If the version doesn't exist, the justtrack SDK uses the default version instead.
An ironSource integration isn't available for the justtrack Flutter SDK yet. To track ad revenue from ironSource, forward each impression with .forwardAdImpression(). See Track ad impressions.
An ironSource integration isn't available for the justtrack Godot SDK yet. To track ad revenue from ironSource, forward each impression manually. See Track ad impressions.
Platform: UnrealAn ironSource integration isn't available for the justtrack Unreal SDK yet. To track ad revenue from ironSource, forward each impression manually. See Track ad impressions.
Platform: GodotAn ironSource integration isn't available for the justtrack Godot SDK yet. To track ad revenue from ironSource, forward each impression manually. See Track ad impressions.
Platform: UnrealAn ironSource integration isn't available for the justtrack Unreal SDK yet. To track ad revenue from ironSource, forward each impression manually. See Track ad impressions.