About events
Events are information about a user’s interaction with the app. All AppMetrica analytics is built from events: reports, funnels, segments, and cohorts. You can work with events in the dashboard interface or download them via the API.
Events are divided into two categories: basic and custom.
Basic events
Basic events — a standard set of events AppMetrica: installations, sessions, purchases, subscriptions, crashes, and others. The full list is in the tables below.
Features of basic events:
- Some events are collected automatically, while others require configuration.
- The number of events is unlimited and not subject to billing.
- Most built‑in reports are built on basic events.
Automatic collection
Events from this table are collected automatically by AppMetrica after the SDK is installed.
|
Event |
What it records |
In which reports is it tracked |
|
Settings |
The first launch of the app with the initialized AppMetrica. |
You can build segments. |
|
Session starts and stops |
App launches and stops. A session is considered new if the user returns to the app after a specified timeout (Android, iOS). The end of the current session is recorded at the start of the next one. They are used in reports to identify active users. |
You can build segments based on session starts within a specified period. |
|
Opening the app via a deeplink, including Universal Link. Used to track remarketing campaigns. |
You can build segments if tracking parameters are passed in the deeplinks. |
|
|
In-App Purchases1, 2 |
In-app purchases made via the App Store or Google Play. |
You can build segments. |
|
Managing and changing the status of a subscription purchased via the App Store or Google Play. |
You can build segments. |
|
|
Application crashes. Allows you to monitor stability metrics, identify problematic slices, and configure monitoring to the desired thresholds. To deobfuscate, you will need to load mapping, SO, or dSYM files. |
||
|
Push tokens |
Device identifiers in message sending systems: Firebase Cloud Messaging (FCM), Apple Push Notification Service (APNS), Huawei Messaging Service (HMS). They are required to send push messages directly, without using the Push API. |
— |
Configurable collection
To collect these events, configure their transmission in the application code.
|
Event |
What it records |
In which reports is it tracked |
|
Application user characteristics, for example, the achieved level, status in the loyalty program, internal identifier. |
Segments can be built. |
|
|
The most popular errors, grouped by identifier and stack trace. |
Custom collection: conversions
Events for tracking revenue and conversion scenarios. To collect them, configure the transmission in the app code.
|
Event |
What it records |
In which reports is it tracked |
|
Revenue from ad impressions received from the monetizer for each impression (Impression Level Revenue Data). |
You can build segments. |
|
|
Applications and multi-step scenarios for processing products and services. |
||
|
The cycle of interaction with products in e-commerce applications. |
Building segments is in the plans. |
|
|
In-app purchases paid for outside the App Store or Google Play. |
You can build segments. |
|
|
Registration and change of subscription status (transmission via Post API). |
You can build segments. |
Custom events
Custom events (client-side or user-defined) are events that you create yourself to track logic specific to your app: using a feature, completing a level, clicking a button. You send them from your app’s code.
Features of custom events:
- configured manually via the SDK2;
- 100 million events per month are collected for free;
- Events exceeding the limit are charged. For more details, see the section Tariffs in USD and AED.
|
Event |
What it records |
In which reports it is tracked |
|
Actions specific to your app, for example, using a feature or navigating to a specific screen. |
You can build segments based on events, including their parameters. |
Learn more
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.
Automatic collection can be disabled, and event transmission can be configured manually.
Events can be transmitted via the Post API.