Impression-level revenue integration for React Native
Integrate the Impression Level Revenue (ILR) SDK API to collect detailed ad performance data and send it to your analytics tools in your React Native app.
Read time 2 minutesLast updated 6 months ago
Prerequisites
Ensure that you have correctly integrated the LevelPlay React Native SDK into your application, as outlined here.
Learn more about the impression level revenue (ILR) by using the SDK feature and prerequisites.
Implement the ImpressionData Listener
The LevelPlay SDK fires postbacks to inform you about the displayed ad. The ImpressionData listener is an optional listener that you can implement to receive impression data. This listener will provide you with information about all ad units, and you'll be able to identify the different ads using the impression level revenue.
If you want to add the ImpressionData listener to your application, make sure you declare the listener before initializing the LevelPlay SDK, to avoid any loss of information.
Set the ImpressionDataListener
import { LevelPlay, type LevelPlayImpressionDataListener } from 'unity-levelplay-mediation'const listener: LevelPlayImpressionDataListener = { onImpressionSuccess: (impressionData) => { // Use the impression data },}LevelPlay.addImpressionDataListener(listener)
The LevelPlay SDK will notify your listener of the success post-backs related to impression data. The listener interface is:
interface LevelPlayImpressionDataListener { /** * Invoked when an impression is successfully recorded (ad is shown). * Android: onImpressionSuccess * iOS: impressionDataDidSucceed */ onImpressionSuccess: (impressionData: LevelPlayImpressionData) => void}
Integrate the ILR data
After you implement the ImpressionDataListener, you’ll be able to use the impression data and send it to your own proprietary BI tools and DWH, or to integrate it with 3rd party tools.
Note
The returned data might include null values. Make sure to add protections before assigning the data, to avoid potential crashes.
You can refer to each field on the object:
LevelPlayImpressionDataimport type { LevelPlayImpressionData } from 'unity-levelplay-mediation'// LevelPlayImpressionData type:type LevelPlayImpressionData = { auctionId: string | null; mediationAdUnitName: string | null; mediationAdUnitId: string | null; adFormat: string | null; country: string | null; ab: string | null; segmentName: string | null; placement: string | null; adNetwork: string | null; instanceName: string | null; instanceId: string | null; revenue: number | null; // Double precision: string | null; encryptedCPM: string | null; conversionValue: number | null; // Double creativeId: string | null;}
For the full list of fields and types, refer to the Impression Level Revenue SDK API documentation.