Ad revenue attribution guide

• Ad revenue data is pulled daily at 14:00 UTC for the previous day. Data is available the following day at 16:00 as described in the example that follows: 
  
  • An ad displays on Day 0. The data is pulled from the ad networks on Day 1 at 14:00 UTC. Processing begins Day 2 (midnight) 00:01 UTC. The data is available in the Dashboard on Day 2 from 16:00 UTC, and in Data Locker from 6:00 UTC. 
  • Data is reported under Day 0 (the day the ad displays). In Data Locker, it is reported in the Day 0 H=23 folder.

Ad revenue display timeline

Ad revenue attribution supports different granularity methods. The granularity is monetization network dependant.

• Aggregate granularity:
  • AppsFlyer gets the revenue daily broken down by geo.
  • The effective revenue per action (eRPA) is derived by dividing the revenue with the number of instances of a trigger event.
  • The trigger events are either app open or specific in-app events set in the app. 
• User-level granularity (aka impression-level granularity) [best practice]:
  • The monetization network reports the revenue by user at the impression level. Not all monetization networks support user-level granularity. 
  • This revenue is attributed to the media source that brought the user. Meaning AppsFlyer ad revenue attribution adheres to the attribution rules found in the platform, including retargeting attribution rules. 
  • If you're using a mediation network, make sure to disable ad revenue APIs for partners that mediate via the mediation network before enabling the user-level granularity API.

To implement API ad revenue attribution, follow one of the granularity method workflows in the following table. 

Aggregate granularity implementation:

• The network reports by integration the total revenue per day broken down by geo. 
• Appsflyer derives the effective revenue per action (eRPA) by dividing the ad revenue with the number of instances of a trigger event.
• For each instance of the trigger event, AppsFlyer creates a _monetized event, that includes the eRPA. For example, ad_matched_monetized.
• Using eRPA revenue is attributed to media sources.
• You can use one of the following event types: 
  • Unique monetization in-app event requires modifications to the app. 
  • af_app_open_event which is available by default,
• Don't report ad revenue in in-app events. Doing so causes ad revenue to be duplicated in the Dashboard because AppsFlyer gets the revenue data from the monetization network by integration. 

User-level (impression-level) granularity implementation:

This method is the best practice. It provides the greatest level of granularity and ad revenue is attributed without the need to modify the app. Ad revenue is accurately attributed to the UA source. 

User-level ad revenue data: attribution is available in raw data reports. We don't send postbacks of  user-level data to integrated partners 

Revenue from app users for which there is no attribution record in AppsFlyer are attributed as organic. This can occur, for example, after deleting user-level data from Facebook. 

Migrating from aggregate granularity to user-level granularity implementation notes

• Migrating does not impact historical ad revenue data. This data remains unchanged.
• User-level granularity does not need in-app events. You can continue sending these events they don't impact the user level granularity reporting in AppsFlyer. 
• Ad revenue data is pulled once a day at 1400 UTC using the granularity options selected at that time.
• If you have implemented in-app events, to identify ad viewing activity, these continue to operate. They do not impact the operation of user-level granularity. 

Before you begin:

• Prepare the app so that it can publish ads. 
• Request that the ad revenue integrated partner provide you API credentials.
• If you are implementing User-level revenue attribution with a revenue mediation partner: Disable active ad revenue integrations with partners that report the revenue via the mediation partner.

To enable ad revenue integration with the ad revenue network:

1. In Appsflyer, go to Configuration > Integrated Partners.
   The Integrated Partner window opens. 
2. Select a partner. Tip: Select Active and Ad revenue to display your existing partners having Ad revenue capabilities. 
   The integrated partner's configuration window opens.
3. Go to Ad Revenue tab, enable Get Ad Revenue Data.
   The API credentials fields are displayed. 
4. Some partners offer both user-level and aggregate granularity integrations. Select one. 
5. Complete the API credentials as provided by the integrated partner. 
6. If you selected Aggregate granularity, complete the app trigger in-app event that represents the ad monetization trigger. This event is usually sent for each ad impression. For example, ad watched or video watches. 
7. Click Save Ad revenue.
8. If the Test Connection button displays, as depicted in the preceding figure, Click Test Connection:
   • API key verified displays, you have successfully completed the procedure. AppsFlyer collects the data from the partner once a day. 
   • Any other message displays, see Ad revenue API status and testing and repeat the procedure.
9. If there is no Test Connection button, you have completed the procedure. 

• API status messages provide details about the ad revenue API operations. View the list of status messages. 
• Some partners enable you to test the API connection. Where available, a Test connection button displays. 
• To verify that the API connection is operational:
  • Click Test connection. 
    The message API key verified displays. If this is not the case, follow the corrective action guidance in the table that follows. 

App owners may contract with one or more ad monetization networks, either directly or via ad revenue mediation platforms Examples: IronSource, Admob, DoubleClick (DFP). 

If you implement a mediation platform's SDK in the app, this may cause duplicate reporting of revenue. To avoid duplication use the flow chart that follows to identify the appropriate way to integrate monetizing networks and mediation platforms.

AppsFlyer requires these platforms to integrate with it to perform ad monetization recording. You can check if the ad monetization platform you use is integrated with AppsFlyer. 

Ad revenue shows the quality of users from different sources over time. As users continue launching the app and engaging with ads, their LTV increases. 

Ad revenue attribution is available as follows:

• LTV based:
  • Dashboards being: Overview, events,
  • Cohort analytics
  • master API
• Activity based:
  • Dashboard: Activity
  • Ad revenue raw data

Overview dashboard - aggregated performance report

In the Overview dashboard:

• Values including revenue are LTV See LTV vs. activity data.
• The Revenue column includes all revenue including ad revenue and in-app purchases
• Drill-down into the advertising hierarchy (media source, campaign, ad set, geo) to view the monetized events in the report.

In the Activity dashboard:

• Values including revenue are activity date based. See LTV vs. activity data.
• The Average Actions per User indicates the tendency of users to engage with the ads presented in the app. 

Ad revenue raw data reports contain data provided by monetization networks having user-level integration with AppsFlyer. 

Principles of ad revenue raw data

• Data is aggregated by the number of unique impressions per user. Unique impressions are derived from the combination of ad monetization network, ad unit, and placement. 
• Raw data freshness is identical to that of user-level ad revenue in the Activity dashboard.

Data characteristics and fields

The fields in ad revenue reports are populated:

• by the ad revenue event itself and listed in the table that follows. These fields are divided into:
  • Specific: Fields specific to ad revenue. For example, impressions and placement. Note! The fields populated differ by monetization partner, as shown in the Fields by network table in this section.
  • Context: Fields having a similar meaning in other raw data reports. For example, event name, event value, currency. 
• as a result of attributing the event to the media source that brought the user. Meaning these fields are copied from the conversion event that brought the user. For example, media source and campaign. These fields are not listed in the table that follows. 

How can I get the total ad revenue from each platform?

• Ad revenue attribution is linked and displays in relation to the user acquisition source.
• This provides the LTV view of your ROI and KPIs.
• To view the total revenue from each monetization platform use a different in-app event for each network and use the following procedure:
  1. In the Overview dashboard, go to the aggregated performance report table.
  2. Select up to four monetized events representing the platforms you want to query. 

     

  3. Download the report by, click Export CSV.

  4. Sum up the Revenue column of the requested platform's monetized event
     

     

Note that this total ad revenue is LTV data, i.e. it's the entire revenue generated by a monetizing network for your app from users, who installed during the specified date range.

Is ad revenue available in the activity page?

Yes!

The Activity page reports on the combined revenue from in-app purchases and ad revenue. Note: Ad revenue data is sent to AppsFlyer on a daily basis, the day following the event. 

Do I need to activate the partner in the Integration tab?

• If you engage with the partner for ad monetization (ad revenue) only: don't enable Activate Partner in the integration tab. 
• Enable only Get Ad Revenue data in the Ad Revenue tab.

How is user-level ad revenue attributed if a user has an app version without the AppsFlyer SDK?

• Ad revenue is attributed as organic.