The main place to find hidden gems in your user data is the in-app-events raw data report. The report contains the actions performed by non-organic users, sent to AppsFlyer, using the integrated SDK, server to server API and via native web view.
The in-app-events raw data report is also the main source for activity data, meaning a chronological breakdown of the actions performed by users.
This report is the only source on the dashboard for specific event value information (except for the Audiences premium feature), excluding revenue related information.
This article discusses several topics about the in-app-events raw data report and how to use it best for your purposes.
In-app-events raw data report, an AppsFlyer premium feature.
The reports are available for download as described here or by using pull API.
Raw data reports structure
To make it easy to combine installs with the in-app-events data, AppsFlyer installs, and in-app-events, the raw data reports have the same structure. Therefore, all in-app-events in the raw data also contain the complete original attribution data, just like the install event does. See the field list of raw data reports.
What is the average time between the download or first launch of your app and until the first purchase/registration/completion of tutorial etc.? Each in-app-event entry has all this information and more for your convenience.
Choosing specific in-app-events
You can filter the raw data report using specific in-app-events.
- Raw data reports are updated in real-time
- The in-app-event list, used to filter the report, is updated daily
To filter the report by in-app-event:
- Go to Reports > Export Data.
- In the raw data reports, select one or more in-app-events. The list contains the non-organic events received by the system. Note: The in-app event filter list is updated daily.
- Select one or many events to appear in the generated report.
- Click outside the box once you've finished selecting events.
- "Off the wagon" - select af_add_to_cart and af_purchase events to see the users that added items to the shopping cart, but didn't go through with it. A good retargeting campaign with a personalized offer may convert these users to buying users.
- "Search and despair" - select af_search and af_content_view events to find out the users that searched for content on your app, but did not consume any content (or else they would have also had af_content_view). You can learn a lot about the most failing search keywords in your app.
- "One at a time" - some apps have such large audiences that even a day of events exceeds the CSV files size limitation. Using the events filter to download files per single event type is a good solution for these app owners.
AppsFlyer in-app-events, called rich in-app events, as they contain value parameters in addition to the basic event name. The in-app-events report contains the parameter values.
All the revenue and ROI data available on AppsFlyer come from af_revenue in various events.
When the af_revenue parameter is sent with any in-app-event, AppsFlyer adds its value to the total revenue of the user and its media sources. On the in-app-events report this value shows up in the event_revenue column.
Only use the af_revenue parameter with in-app-events that describe real generated revenue. For other events that involve revenue, but are not final, for example, add_to_cart) use other parameters like af_price.
How to follow a user's journey?
There are many insights you can draw out of observing the different customer journeys your users have from the initial launch of the app, and throughout their lifetime.
If you'd like to see your users' journeys follow these instructions:
- Download both installs and in-app-events data for the same periods of time.
Note - you can download up to one full month of in-app-events at a time. For the reports' limitations click here.
- Combine the CSV files into a single file.
- Sort or filter the file according to AppsFlyer device ID column.
The result is a group or groups of events performed by each of your users.
What is the "is primary attribution" value?
During the re-engagement window, which happens after a user engages with a retargeting campaign, AppsFlyer attributes events to both the original media source (prior to the re-engagement) and to the retargeting media source.
During this window the original media source is not considered to be the primary attribution for the user's events ("false" value), while the retargeting media source is considered as primary("true").
After the re-engagement window closes down, the original media source returns to be the primary and only attribution.
What are the "is retargeting" & "is primary attribution" cases?
The example below shows a general re-engagement scenario.
The following table shows where and when in-app-events appear in raw data report, following user acquisition and retargeting conversions:
|When||User acquisition in-app events report||Retargeting in-app events report|
|Events from acquired users (installs)||during user lifetime||Yes, primary||No|
|Events from re-engagements||during re-engagement window||Yes, not primary||Yes, primary|
|Events from re-attributions||during user lifetime||No||Yes, primary|
- Using the regular in-app-events report you can filter in only primary results ("Is Primary Attribution" is true) to see only the regular (non retargeting) events.
- Using the regular in-app-events report you can filter in only non-primary results ("Is Primary Attribution" is false) to see only the retargeting events. Note that the media sources in these events are the original sources, and not the retargeting ones, which are actually attributed with the events.
Why is af_app_opened event missing?
The af_app_opened Event is automatically generated upon every successful launch of AppsFlyer SDK.
af_app_opened is mainly used by AppsFlyer as a tool for calculating retention data. It is also used for notifying some media sources with launch data directly via postbacks from AppsFlyer.
Therefore, and also due to the vast number of these events, which would "drown" all other events, the af_app_opened Event is not included in the in-app-events raw data report.
Which Geo do events belong to?
AppsFlyer sets the user location parameters, i.e. country, city, DMA etc. according to the user's IP address on install time.
However, human users tend to move around and perform in-app-events from different locations and IP addresses than during their original installs.
AppsFlyer raw data, and consequently the aggregated data, display the actual location of the user during the performance of the event, and not the original location during the install.
The reasoning behind this is to help with analyzing data for user behavior. In some verticals the location of users may have greater effect on their actions than their original install location. Analyzing the relative performance of locations can help advertisers focus on relevant retargeting campaigns to increase their users engagements.
Luber, a hail ride travel app, identified a relatively large number of ride events taking place in Springfield. To maximize its users' engagements Luber sends a retargeting push notification to any user that arrives to Springfield.
In case the IP address during the in-app-event's performance cannot be resolved, the IP address during the install is displayed in the raw data
Contributor and Google play data in in-app-events reports
Contributor data and Google Play data doesn't appear in raw in-app-events reports. All other fields are populated if they are available on the install data.