Raw data and aggregate reporting tools/APIs

At a glance: Choose a reporting tool/API to get data from the platform. 

Selecting the appropriate reporting tool

In selecting the reporting tool, consider how, what, and when you need the data. Do you need:

  • Conversion data in real-time to influence the user journey?
  • Raw installs and in-app events data, or is aggregate data sufficient?
  • Clicks and impressions of raw data?  
  • To ingest and process the data in your systems? 

Data reporting tools/APIs

Raw data and aggregate reporting tools - main features

Tool name Description  Multiple /single app (1) Data freshness Agg. data

Raw data

 

Embed in scripts Timezone  Currency
Export data

Get reports using the user interface

Single Real-time ✓P  x App-specific App-specific
Pull API*

Reporting using URIs in the browser or embedded in scripts

Single Real-time ✓P

Selectable
Default:
UTC 

Selectable
Default: USD 
Data Locker

Data deposited to an AWS bucket by AppsFlyer. Suited to high volume apps 

Multi Hourly - 6-hour lag x ✓P   UTC USD 
Master API* KPI reporting using URIs in the browser or embedded in scripts. Multi Daily ✓P  x   Selectable
Default:
UTC (2)

Selectable

Default: USD

Cohort User acquisition and retargeting analytics in the user interface Multi Daily x x App-specific (2) App-specific
Pivot Field selectable reports in the user interface Multi Daily ✓P x x App-specific (2) USD

Notes/abbreviation:
(1) Multiple apps feature means the ability to query data for more than one app at a time

(2) Apps all need to be set to the same app-specific time zone. If not then time is in UTC.
(P) Premium feature
(*) Subject to rate limitations

Merging Pull and Push API

Real-time app event messages

Type Description  Multiple app  Raw data Embed in scripts/code Timezone currency 
Push API

Raw conversion data messages. Organic and non-organic 

Merging Pull and Push API

Can use the same endpoint ✓P   UTC + app-specific USD + app-specific
SDK Conversion data (1) Attribution data within the app. N/A   UTC N/A

Notes/abbreviation:
(1) SDK conversion data retrieves user attribution data in less than 5 seconds from the first app launch and therefore is the least accurate method. The reason being is that in some cases, it takes longer than 5 seconds for AppsFlyer to get responses from ad networks, and so the fast SDK data decision may be different from the final attribution.

✓P = Premium feature

Limitations

  Pull API: Aggregate Pull API: Raw Push API Data Locker SDK
Conversion data
Master API
Data limit (1) 200K lines 
24 calls per day per application and up to 120 calls per day per account
200K lines 
10-100 calls per day
Unlimited Unlimited Unlimited Unlimited file size and unlimited calls per day
Selectable data options None Select data types, new fields are optional. Select data types, fields, and in-apps Select data types, fields, and in-apps No Select data returend
Data retention Lifetime 90 Days N/A 30 days Lifetime (available in the SDK) Lifetime
Premium features No Yes Yes Yes No Yes
(1) The upper limit may depend on the account package.

Integration considerations

  Pull API Push API Data Locker SDK
Conversion Data
Master API
Server-Side Development Optional Required Optional Optional Optional
Requires Data Processing Optional Yes Optional Optional Optional
Risk of Data Loss No Yes, if receiving servers are down No Small, if there are delays in ad networks response No
Client-server Processing Costs None High Low None (unless sending the data to the servers) None
Client-server Maintenance None High Low None (unless sending the data to the servers) None

Aggregate data

The table that follows describes the types of raw data available for each tool.

 Report type Export  data Pull API Pivot / Master API Cohort
Aggregate Clicks, impressions, installs & events data   
Group by media source, Geo, Install day or site ID  
Group by app ID, ad set, ad, channel, engagement touch type or keywords - -  
Filtering by media source  
Filtering by country, campaign, agency, channel or site ID  - -  
Aggregate data types

Raw data

PremiumFeature.jpg

  • The tables that follow describe the types of raw data available for each tool.
  • Data availability depends on your subscription plan.
Report type  Pull API Export data Push API Data Locker SDK
Conversion Data
Impressions - - - -
Clicks - - - -
Installs
Sessions - - - -
Assisted (Contributed) Installs - -
In-app Events -
Uninstall Measurement - -
Raw non-organic data types

Limitations:

  • Clicks and impressions data for app installs is available as part of attribution data.
  • Clicks and impressions data is available only via Data Locker provided that the information is made available to AppsFlyer. In general, SRNs do not provide raw data of clicks and impressions. 

User acquisition - organic

Report type  Export data Pull API Data Locker Push API SDK
Conversion Data
Installs
Sessions - - - -
In-App Events -
Ad Revenue - - -
Uninstall Measurement  - - - -
Raw organic data types

User acquisition - non-organic

Report type  Export data Pull API Data Locker Push API SDK
Conversion Data
Impressions (1) - - - -
Clicks (1) - - - -
Installs
Sessions - - - -
In-app Events -
Ad Revenue - - -
Uninstall Measurement - -
(1) Clicks and impressions data is made available by integrated partners. In general, SRNs don't provide raw data of clicks and impressions. 
Raw non-organic data types

 

Raw data - retargeting

Report type  Export data Pull API Data Locker Push API SDK
Conversion Data
Clicks (1) - - - -
Re-Attributions
Re-engagements -
In-App Events -
Ad Revenue - - -

(1) Retargeting clicks data is available as part of the raw retargeting data for re-attributed users. In general, clicks raw data is not available from SRNs.

Retargeting raw data types

 

 

Was this article helpful?