Ad revenue signals for UA ad networks

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

Ad networks can 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.

Set the Ad Revenue report in Data Locker

The following activities need to be completed to access the Ad Revenue report in Data Locker:

Configure the report output settings

To configure the report output setting, follow the steps below:

  1. In AppsFlyer, go to Report > Data Locker.
     
  2. In the Report output settings area turn on Send reports.
  3. Set the report file output properties.
    • The report format (Parqet/CSV).
    • The report compression method (Snappy/GZIPO/Uncompressed).
    • The maximum number of rows in a file.  
  4. Review the expected path of the report file outputs. The path is set according to your connection settings. To learn how to set up the connection see Set up Data Locker.

Enable the Ad revenue report

  1. In the Data Locker content section select the Ad revenue [daily] report type.
  2. Click Save connection.
  3. Make sure that the advertiser permitted the Ad network to view the report. 
  4. For instruction, see Permit ad networks to get ad revenue data.

Report specification

Report structure and format

  • Format: Data arrives in CSV format to the UA partner's S3 bucket.
  • Level: Contains device-level dimensions and metrics.
  • Data enrichment: 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).
  • 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. 
  • The reports include data about all conversion types: Installs, re-attributions, re-engagements, and reinstalls.
  • Currency: In USD. Event revenue is calculated to USD on the day the event occurred.
  • See sample report

Report fields

Field Remarks
Version Unix timestamp in second. Example: 1661315124
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, campaign_id, adset_name, adset_id, ad_name, ad_name, ad_id, site_id Only populated if UA is attributed to the partner receiving the data.
idfa, idfv, advertising_id 
  • 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.
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.
ad_unit  
placement  
mediation_network  
engagement_type  

Metrics:

Field Remarks
impressions Number of times the user saw the ad
revenue_usd Daily revenue (in USD) generated for the device ID. Note: When the revenue amount is small, it's represented in scientific notation. For example: 8.00E-05