FAQ: Counting sessions

  • Advertisers
  • Agencies
  • Ad Networks
  • Developers


Why does sessions data matter?

The number of sessions performed by users is easily one of the most important KPIs app owners are interested in. It affects the aggregated data, the retention and cohort graphs and also the activity KPIs such as DAU and MAU.

Sessions count also affects the number and rate of loyal users, which by default are registered as such after performing 3 sessions following the initial install.

When does AppsFlyer increment the number of sessions?

1. Every time the SDK is launched

If an app is launched from scratch or if it comes back to the device’s foreground from the background - the sessions number increases.

2. By an SDK API request

Some apps need sessions data increased on demand.
Apps that constantly work in the background may require some other logic for counting sessions. These mainly include utility apps like Battery savers, Launchers, screen locks, Anti-virus apps etc.

App owners of these apps may want to increase the number of sessions once a day at midnight or at some other periodic interval. In other cases they may want to increase the number of sessions when users perform some in-app action, such as pressing "clear memory" button and so on.

Fortunately it's possible to actively increase the number of sessions per device.
AppsFlyer's Android SDK has an optional API for doing just that called reportTrackSession.

public void reportTrackSession(Context context);

Currently the iOS SDK doesn’t have the same capability, as the distribution of utility apps on iOS is a lot less significant compared with Android.

Setting minimum time between sessions

Another sessions related SDK API enables setting the minimum time, that can lapse between two app launches, for them to be counted separately.

The API is called setMinTimeBetweenSessions (Android, iOS).

By default, AppsFlyer enforces a 5 second rule, i.e. at least 5 seconds must lapse between 2 app launches to count as separate 2 sessions. The API allows setting the minimum required time between sessions.

Possible uses


1. Fighting Fraud - fraudsters have learned over time that launching apps several times is indicative of real users, and started using this to their advantages. Setting the minimum time between sessions to 60 seconds or more can help with fighting fraudsters, as it takes them much longer to fake separate sessions.

2. Consolidating sessions - sometimes users are forced to stop using your app for a short while, e.g. getting a short phone call in the middle of a game. In this case, since the app comes back from the background, a new session is counted. The app owner may wish to treat these two sessions as a single session. Setting the minimum time between sessions to 90 seconds or more can consolidate these double sessions to single sessions.

Was this article helpful?
0 out of 0 found this helpful

Page Contents: