- User Guide
- Integration
- Third-party Platform Integration
Unity LevelPlay (ironSource)
Written by Yeji Jeon,Note
This feature is currently in beta. For inquiries and improvement requests, contact your CSM.
Airbridge supports server-to-server (S2S) and SDK integration with Unity LevelPlay (ironSource). With the integration, you can view the ad revenue in the Airbridge dashboard.
Recommended integration method
Implementing both S2S and SDK integration is recommended for more accurate ad performance measurement.
The real-time data received via SDK integration is enriched with the data via S2S integration. Data received via the SDK integration can be used for SKAN measurement.
When deciding on the integration method, it's important to consider each method's specifics. You can use one or both methods to integrate Airbridge with Unity LevelPlay.
Integration Method | Real-time data collection | Data consistency | Purpose |
|---|---|---|---|
Server-to-server (S2S) | Not possible | Relatively high | - Receiving data for attribution - Uploading data to the data storage - Configuring SKAN conversion values NOT POSSIBLE |
SDK | Possible | Relatively low | - Receiving real-time data available in the Airbridge Actuals Report, Real-time Log, etc. - Sending postbacks - Uploading data to the data storage - Configuring SKAN conversion values |
Attention
Airbridge doesn’t send postbacks via the server. To send postbacks, the SDK integration must be implemented.
The following credentials are required:
Secret Key
Refresh Token
Follow the steps below to get the credentials from Unity LevelPlay.
1. Log in to your Unity LevelPlay (ironSource) account.
2. Click the [account] icon at the bottom of the sidebar on the left. Click Account.
3. Find the Secret Key와 Refresh Token in the [API] tab.
1. Navigate to [Integrations]>[Third-party Integration] and select Unity LevelPlay (ironSource).
2. Provide the Secret Key and Refresh Token to Airbridge and click Submit.
3. When the credentials are registered with Airbridge, the apps that will be integrated will appear. If you leave the page before the apps appear, you need to start the process again from providing the credentials. Have some patience.
4. Once the apps that will be integrated appear on the dashboard, the connection is activated. At least 1 Android or iOS app must appear for the connection to be activated.
If the app you want to integrate does not show up, refer to the troubleshooting tips below.
Refer to the following information to troubleshoot your problem.
Refer to the table below to understand the integration status tags. Credentials refer to authentication tokens, report keys, IDs, etc.
Status Tag | Description |
|---|---|
(No tag) | No credentials are registered with Airbridge. |
Configured | Credentials are registered with Airbridge. |
Error | No data is being received due to the third-party server error or authentication issue. |
The status tags are visible under the third-party names on the [Integrations]>[Third-party Integration] page.
In the individual integration setup pages, the integration status badges are visible next to the third-party name.
Click the [pen] icon to edit the credential information. Then, click Done.
Click Delete to delete the credential information. When deleting the credentials, the integration is disabled. Data already pulled into Airbridge are not affected and remain in Airbridge. To reenable the integration, enter the credentials again.
If you want to integrate more apps from a different platform (Android, iOS), The integration must be set up from the start. Click Delete and enter the credentials again.
Note
Depending on the data volume, the aggregation process may take a longer time. As a result, the time the data is made available in the Actuals Report may be delayed.
Data collected from 12:00 AM 2 days earlier to 12:00 AM the next day by Unity LevelPlay is imported to Airbridge every day at 11 AM (UTC). This means that the Unity LevelPlay data is available in Airbridge within up to 3 days from the day the data was collected.
For example, given that the Airbridge App timezone is set to UTC, the Unity LevelPlay data collected from 12:00 AM, 2024-01-01, to 12:00 AM, 2024-01-02, is imported by Airbridge at 11: 00 AM, 2024-01-03. This data is available in the Actuals Report from 9:00 PM, 2024-01-03.
Attention
Due to the real-time data updates in Unity LevelPlay, data received via the SDK integration between Airbridge and Unity LevelPlay may differ.
For instructions on how to implement the SDK integration, refer to this article in the developer’s guide.
Once the integration is complete, the ad revenue data can be viewed in the Airbridge dashboard.
Unity LevelPlay | Airbridge | Description |
|---|---|---|
Network | Channel | The ad channel the ad was exposed |
Country | Country | 2-digit country code |
Advertising ID | Airbridge Device ID Type | Device identifiers such as IDFA(iOS), GAID(Android), etc. |
Revenue | Event Value | Ad revenue |
When implementing both integration methods, the real-time data received via SDK integration is enriched with the data via S2S integration. Therefore, the real-time data displayed in the Actuals Report will be updated with the enriched data within up to 3 days.
For example, the ad revenue from Unity LevelPlay of 2024-01-01 displayed in the Actuals Report can be updated on 2024-01-04 after data enrichment.
Airbridge does not send postbacks via S2S integration. To get postbacks, implement the SDK integration.
When implementing both integration methods, event duplication may occur.
When sending data to a data storage, duplicated events may be saved to the data storage.
When exporting raw data from the [Raw Data]>[App Raw Data] menu multiple times, event duplication may occur depending on the export request time.
Unity LevelPlay data is based on UTC, and the timezone can’t be changed. If your Airbridge App’s timezone is set to anything other than UTC, differences in data may occur depending on the time the data was queried in Airbridge.
If the credentials are updated in the Unity LevelPlay dashboard after the integration is complete, the integration with Airbridge will be disabled. The integration must be set up from the start to be re-enabled.
Was this page helpful?