Raw-data report—in-app-events

In-app-events relating to user actions and events sent by the app or S2S to the platform are available  in in-app raw-data reports.

In-app raw-data report characteristics

  • Main source of activity data, meaning a chronological list of the actions performed by users after conversion (install, reinstall, re-attribution, re-engagement).
  • Separate reports are available for organic, non-organic, and retargeting in-app events.
  • The organic report has no attribution (media source) data. 
  • The non-organic and retargeting reports have the attribution data of the media source attributed to the conversion. 
  • Data freshness: Real-time reports. In-app organic can be delayed by several hours.
  • The report structure and fields are similar to those of install reports.
  • Filter reports using the in-app name.

Event values

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.

Event value field contains the structured event values sent in a JSON. 
{"af_level":"10","af_score":"3387","arena":"7","char_type":"paladin"}

Reporting revenue

The revenue and ROI data available in AppsFlyer come from af_revenue in the various events.

When the af_revenue parameter is sent in an in-app-event, AppsFlyer adds the revenue value to the total revenue of the user and the media sources. In the in-app-events report, this value displays in the event_revenue column.

 Caution

Only use the af_revenue parameter with in-app-events that describe actual revenue generated. For other events that involve revenue, but are not final, for example, add_to_cart, use different parameters like af_price.

How to follow a user 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.

The combination of installs and in-app-events raw data reports contains the full life-time actions performed by your users.

To follow a user journey:

  1. Download install and in-app-event reports having the same time period.
    Note: In-app events are limited to a period of 30 days. See report limitations.
  2. Combine the reports into a single file.
  3. Sort the file using AppsFlyer ID as the primary sort field and event time as the secondary sort field. 
    The result is a group or groups of events performed by each of your users.

Retargeting in-app events are attributed to the UA and retargeting campaign

The example below shows a typical re-engagement scenario.

ReTargetingInApp_us-en.png

Retargeting in-app events are duplicated when a purchase event takes place as part of a retargeting campaign during the UA re-engagement window. This attributes revenue to both the UA media source and the retargeting media source. 

You will only get duplicate event if you have enabled both:

  • install in-app events
  • retargeting in-app events 

In-app events attributed to the UA media source as part of a retargeting campaign have the field is_primary_attribution=false. 

 Example

  • A user installs example_app, which is attributed to ua_network
  • Later the user re-engages with example_app's retargeting campaign on retar_network and makes a purchase.

The in-app purchase event is sent twice with the following details:

Retargeting in-app event fields
Event type Media source is_retargeting re_targeting conversion_type is_primary_
attribution 
UA in-app event ua_network False N/A  False
Retargeting in-app event retar_network True re-engagement or re-attribution  True


How do I identify duplicate retargeting events?

The is_primary_attribution boolean field identifies primary and secondary media sources in retargeting campaigns:

  • False: identifies the original UA media source. Note: This is the only scenario where the value is false. 
  • True: identifies the re-engagement media source 

Explanation: When a user, engages with a retargeting campaign, a re-engagement window opens. For the duration of  the re-engagement window:

  • The re-engagement media source is the primary media source 
  • The UA media source is the secondary (non-primary) media source. After the window closes, the original UA media source reverts to being the primary media source. 

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 user engagements.

 Example

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.

 Note

In case the IP address during the in-app-event's performance cannot be resolved, the IP address during the install is used.

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.

 

Was this article helpful?