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 |
|
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. |