ROI360 impression-level ad revenue SDK API integration guide

For:

Marketers Developers

Last update: December 25, 2024 10:34

At a glance: The AppsFlyer ad revenue SDK API works with ad networks to report ad revenue with impression-level granularity.

Impression-level ad revenue reporting by SDK API

Ad revenue reporting options

Ad revenue is reported to AppsFlyer by either aggregate granularity (via API) or impression-level granularity (via SDK). Impression-level data via SDK:

Has better data freshness and earlier availability in AppsFlyer.
Supports SKAN.
Is for AppsFlyer SDK V6.15+. For earlier SDK versions, an SDK connector is used instead of the API. Links for developers are included in this documentation where relevant.

Note:

Ad revenue impressions are collected and processed in AppsFlyer, but aren't counted against your in-apps package.
See the complete list of SDK plugins that support the Ad Revenue SDK API.

Reporting ad revenue using the SDK API

SDK principles of operation

The ad revenue SDK API sends impression revenue data to the AppsFlyer SDK. These impression events are collected and processed in AppsFlyer, and ad revenue event, af_ad_revenue , is generated in the platform with the revenue attributed to the original UA source.

Data display

The af_ad_revenue event is used to identify ad revenue. This event is used throughout the platform including dashboards and other data delivery tools.

Supported networks

The list of supported ad revenue mediation and monetization networks that can send us data via the ad revenue SDK API is as follows:

Unity LevelPlay mediation (formerly ironSource)
Applovin Max
Google AdMob
Fyber
Appodeal
Admost
Topon
Topon Pte.
Tradplus
Yandex
Chartboost
customMediation (when the mediation solution is not in the list of supported mediation partners)
directMonetizationNetwork (when the app integrates directly with monetization networks without mediation)

Data freshness

The SDK API sends the revenue data to the platform at the time the ad displays. For ROI360 premium customers, the data becomes available in:

The DataLocker impression level topic at 1 AM and every 1 hour thereafter,
The AppsFlyer Activity and Cohort reports at 5 AM UTC, and every 4 hours thereafter.

Implementing AppsFlyer ad revenue SDK API

To implement the AppsFlyer ad revenue SDK API:

Enable SDK-level ad revenue in AppsFlyer for the partner you want to connect. Note: This needs to be done for each app individually.
Tell your developer to integrate the AppsFlyer ad revenue SDK API using these instructions.
To record ad revenue in your SKAdNetwork dashboard, follow the SKAN ad revenue instructions.

Traits and limitations

Trait	Remarks
Admob	To turn on iLTV for Admob, follow this link For Android and Unity, impression revenue is reported by the Admob iLTV SDK in micro-units. For the correct ad revenue amount in USD to display in AppsFlyer, before sending the ad revenue amount to AppsFlyer, divide the amount extracted from the iLTV event handler by 1 million.
Ad revenue value	Impression events with revenue values above $10 (and the equivalent in other currencies) aren't processed by the SDK API.
Channel	Channel isn't supported for out-of-store apps, except for Amazon.