Impression Level revenue data (ILRD)

With Impression Level revenue data (ILRD), you can process detailed revenue data. Starting with the Mobile Ads SDK 5.0.0, the SDK provides you with revenue information for each ad impression and information about the advertising network (if Mobile Mediation is used) that served the ad. This information is provided in real time on the device in the publisher's app. You can handle this data directly or transfer it to a third-party analytics provider.

What data can be obtained

The following data is available to publishers:

Field

Type

Description

ad_unit_id

string

A unique ad unit ID.

adType

string

The type of an ad:

  • Banner
  • Interstitial ads
  • Native ad
  • Rewarded ads

currency

string

The currency that an ad network uses.

revenue

string

Revenue from an impression in the ad network currency. The currency specified in the currency field is used.

revenueUSD

string

Revenue from an impression, converted to USD.

precision

string

The accuracy of the revenue value. Acceptable values:

  • publisher_defined: The value that takes into account the CPM floor from the mediation interface.
  • estimated: The value based on automatic strategies.

network.name

string

The name of the ad network that served the ad (the parameter is valid for Mobile Mediation).

network.ad_unit_id

string

Unique ad unit ID in the network that served the ad (for Mobile Mediation).

Enabling ILRD

  1. Integrate the Mobile Ads SDK version 5.0.0 or later by following the instructions (Boost: Unity, Mobile Mediation: Unity).

  2. Implement client-side interfaces to track events.

    When implementing the BannerAdEventListener, InterstitialAdEventListener, NativeAdEventListener, and RewardedAdEventListener interfaces, use the onImpression method with the ImpressionData parameter. The onImpression method is called when an impression is counted. The ImpressionData asset has a single method, getRawData, that returns a JSON string with ILRD.

    public void HandleImpression(object sender, ImpressionData impressionData)
        {
            var data = impressionData == null ? "null" : impressionData.rawData;
            this.DisplayMessage($"HandleImpression event received with data: {data}");
        }