Impression-Level Revenue Data (ILRD)
Impression-level revenue data (ILRD) enables you to process granular data. Starting with MoPub SDK v5.7.0, MoPub provides you with revenue information associated with each impression, as well as information about which demand source was able to fill and show an ad. We provide you the data in real time, on the device, within your publisher app. You then have the flexibility to augment the impression event data with your own proprietary data, and to either process the data directly, or pass it to a third-party analytics provider.
Ingest ILRD and use the resulting analytics to better understand your users’ activities, and to make more informed user acquisition decisions in attributing earned revenue back to your campaigns. Visit our blog on the MoPub site to learn more about using ILRD to optimize your user acquisition strategy.
The ILRD feature must be enabled for the ad responses to include impression revenue data. When the MoPub SDK in your app sends an ad request to our ad server, the MoPub ad server checks to see that ILRD is enabled for that app, and sends back a callback that includes a JSON object containing revenue data details. (If ILRD is not enabled, the JSON object is null.) We provide getter objects to fetch this data for each platform.
Publishers receive the following data for every ad impression:
- Revenue data (revenue, currency)
- Waterfall data: ad unit, ad format, and priority
- Demand source: Direct-Sold, Network, or Marketplace-served ad
- Precision level of the data: exact (if resulting price of a real-time auction), estimated (if price is obtained using MoPub’s Auto CPM calculations), publisher_defined (if price is the CPM manually input by the publisher), or undisclosed (if the resulting price is null)
||String||Ad unit ID|
||String||Ad unit name|
||String||Format of the ad unit as defined in the MoPub UI|
||String||A unique ID for each impression|
||String||Is always “USD”|
||Float||MoPub’s best understanding for the likely payout of an impression, this field is determined in one of three ways:
- the resulting price of a real-time auction (in this case,
- the price obtained by MoPub’s Auto CPM product (in this case,
- the price assigned to the line item by the publisher (in this case,
- when we do not have permission to share the impression data (in this case,
Note: This value is provided in the units specified in the
||String||If impression served by a supported ad network, this includes the ad network’s name|
||String||If impression served by a supported ad network, this includes the ad network’s placement/zone/etc ID|
||String||Ad Group (line item) ID|
||String||Ad Group (line item) name|
||String||An enumeration of the possible ad group types|
||Integer||Priority of the line item|
||String||Country location of the user as resolved by MoPub|
||String||The value passed here depends on the
- ‘publisher_defined’ if
- ‘exact’ if
- ‘estimated’ if
- ‘undisclosed’ if we do not have permission from the ad network to share impression-level data
We do not include data fields that can be retrieved from the device itself, or that constitute personally identifiable information. These include:
- device make
- device model
- app version
- other identifiers
You can combine the data we send with additional fields, such as IDFA (provided you have the legal right to do so), before processing it. You can then feed this data to your internal BI tools or send it to third-party attribution or analytics vendors for further analysis. MoPub has collaborated with the following following third parties to support this new capability: Adjust, AppsFlyer, Branch, Kochava, Singular, Soomla, and Tenjin.
To enable ILRD:
Integrate MoPub SDK v5.7.0 or higher. Refer to the SDK integration instructions:
Contact your MoPub account representative and ask to enable ILRD for your account. Note that this feature is applicable only for MoPub’s full platform publishers.
Integrate listeners in your app to ingest the new data provided by the SDK:
Last updated May 23, 2019
TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.
© 2019 MoPub (a division of Twitter, Inc.)