[Beta] Ad revenue signals for UA ad networks

At a glance: Ad networks responsible for user acquisition can receive data regarding ad revenue and use it to optimize their customers' UA campaigns.

User-level ad revenue report for ad networks

Ad networks receive reports via Data Locker with valuable ad revenue information regarding users. These users may have been acquired from campaigns served through them, or they may be from a different media source.

Ad networks can then ingest this data to campaign-targeting and optimization algorithms, and use it to improve ROAS campaigns based on a complete view of UA-generated revenue.

See sample report

Report considerations

  • Data arrives in CSV format to the UA partner's S3 bucket.
  • Contains user-level dimensions and metrics. Includes ad revenue data from mediation partners, and adds attribution data relevant to the UA ad network (that is cleaned of all dimensions irrelevant to the UA ad network).
  • Available via Data Locker for Partners.
  • The advertiser must grant explicit permission to AppsFlyer to provide you with the data.
  • Data freshness: Daily, meaning data for Day 0 arrives on Day 1. Data is written daily at 21:00 UTC time to the h=23 of your Data Locker bucket.  
  • Apps included: A single report contains the data of all apps for which advertisers have granted permission.
  • Currency: In USD. Event revenue is calculated to USD on the day the event occurred.

Report structure

Field

Remarks

app_id

App ID in the AppsFlyer platform

install_time

  • Timestamp of install: YYYY-MM-DD HH:MM:SS
    Example: 2020-08-16 11:22:33
  • For iOS 14+ devices and non-consenting users, or if the advertiser has Advanced Privacy on, install time is rounded to the nearest hour.

campaign

Only populated if UA is attributed to the partner receiving the data.

campaign_id

adset_name

adset_id

ad_name

ad_id

site_id

idfa

  • The same device ID, like IDFA, IDFV, or advertiser_id could display in multiple rows if there are more than one ad revenue monetization events.
  • For iOS 14+ devices and non-consenting users, or if the advertiser has Advanced Privacy on, this does not display.

idfv

advertiser_id

platform

Device platform: iOS, Android, or Windows Mobile

country

Country code using ISO 3166 (alpha-2) Example: US, CN

original_url

  • For iOS 14+ devices and non-consenting users, or if the advertiser has Advanced Privacy on, this does not display.
  • Only populated if UA is attributed to the partner receiving the data.
Fields/Dimensions

Field

Remarks

impressions

Number of times the user saw the ad

revenue

Daily revenue (in USD) generated for the device ID

Metrics

Permissions

You (the ad network), must ask the advertiser to grant you the permissions listed here. The advertiser must perform this procedure once per ad network. 

Permission to get ad revenue data

Ad networks appointed (activated) by agencies: The agency can't grant permission. The agency must ask the advertiser to grant the permissions for them. 

To allow the ad network to get aggregated performance data:

  1. Go to Configuration > Integrated partners. 
  2. Select the integrated partner. 
  3. Go to the Integration tab.
  4. Verify that Activate Partner is on. If not, data isn't shared.
  5. Go to the Permissions tab.
  6. Turn on Access ad revenue raw data.
  7. Select whether to send data for ad revenue only from this partner, or for ad revenue from all media sources (non-organic and organic).  
  8. Click Save Settings
  9. Notify the ad network that you have granted the permissions.
Was this article helpful?