Metric calculation rules
Updated at:
The following tables list the metrics used in Mobile Analytics reports, including their names, corresponding instrumentation logs, and calculation rules. The specific metrics available may vary depending on your environment.
Important
All time-related metrics are calculated based on the time that the server receives the log.
Data overview
Real-time dashboard
Metric | Instrumentation | Calculation rule | Deduplication | Real-time |
|---|---|---|---|---|
Launches | Heartbeat Instrumentation | The total number of times a user opens the application. This includes cold starts and bringing the application to the foreground after it was running in the background. | No deduplication | Real-time |
Active users | Activation instrumentation | The number of device IDs that log on to the application. | Deduplication | Real-time |
Active accounts | Activation instrumentation | The number of user IDs that log on to the application. | Deduplicate | Real-Time |
Historical trends
Metric | Instrumentation | Calculation rule | Deduplication | Real-time |
|---|---|---|---|---|
Launches | Activation instrumentation | The total number of times a user opens the application. This includes cold starts and bringing the application to the foreground after it was running in the background. | Deduplication is disabled. | Non-real-time |
Active users | Activation instrumentation | The number of device IDs that log on to the application. | Deduplication | Non-real-time |
Total users | Activation instrumentation | The total number of device IDs that have logged on to the application. | Deduplication | Non-real-time |
New users | Activation instrumentation | The number of new device IDs that log on to the application. | Deduplication | Non-real-time |
Active accounts | Activation instrumentation | The number of user IDs that log on to the application. | Deduplication | Non-real-time |
Total accounts | Heartbeat instrumentation | The total number of user IDs that have logged on to the application. | Deduplication | Non-real-time |
Basic analysis
Behavior analysis
Metric | Instrumentation | Calculation rule | Deduplication | Real-time |
|---|---|---|---|---|
User activity time distribution | Background instrumentation | The start time of app usage is calculated by subtracting the background duration from the log reporting time. The day is divided into two-hour segments starting from 00:00, such as 2:00 a.m. to 4:00 a.m. A user's activity time is assigned to the segment that contains their start time. For example, if a user starts the app at 7:55 a.m. and moves it to the background at 8:05 a.m., the activity is counted only in the 6:00 a.m. to 8:00 a.m. segment. | No deduplication | Non-real-time |
Daily user engagement: Duration/Day | Background instrumentation | The average daily usage duration per user is calculated by dividing the total app usage duration by the number of user IDs. The background instrumentation records the time the app is brought to the foreground. This time is used to calculate the total usage duration. | Deduplication | Non-real-time |
Channel distribution | Activation instrumentation | Based on activation instrumentation, this metric calculates the top three channels by the number of app downloads. Multiple downloads by the same user from the same channel are deduplicated. For example, if User A downloads the app once from channel C1 and twice from channel C2, the calculation counts one download from C1 and one download from C2. | Deduplication | real-time |
Launch speed | Performance instrumentation | Calculates the average launch speed of the application in seconds. It distinguishes between the first launch and subsequent launches. The first launch is the first time the app is started after installation. Subsequent launches are all other app starts. | N/A | real-time |
Flow analysis chart | Automatic page instrumentation | The log records information such as the current page ID and the source page ID. This data is used to count the access sources for the current page and the proportion of each source. It also counts all destinations from the current page and the proportion of each destination. | No deduplication | Non-real-time |
User percentage by region | Activation instrumentation | Activation instrumentation groups data by the region field. It displays the top five regions with the highest percentage of deduplicated users. It also shows the user percentage of each of the top five regions relative to the total number of users. For the China map, the calculation is based on the percentage of deduplicated users grouped by province. For the world map, the calculation is based on the percentage of deduplicated users grouped by country. For example, on the China map, if a user logs on to the app twice in Province A in the morning and once in Province B in the afternoon, the data is categorized as one valid logon each for Province A and Province B. | Deduplication | real-time |
Retention analysis
Metric | Instrumentation | Calculation rule | Deduplication | Real-time |
|---|---|---|---|---|
Retention rate | Liveness instrumentation | The number of new users from a specific day who access the app again on each of the next seven days, divided by the total number of new users on that initial day. For example, if the number of new users on Day T is N, the number of these users who access the app again on Day T+1 is M1, and the number who access the app again on Day T+7 is M7, then the retention rate for Day T+1 is M1/N, and the retention rate for Day T+7 is M7/N. | Deduplication | Non-real-time |
Page analysis
Metric | Instrumentation | Calculation rule | Deduplication | Real-time |
|---|---|---|---|---|
Users | Automatic page instrumentation | The number of device IDs that accessed the current page. | Deduplication | Non-real-time |
Accounts | Automatic page instrumentation | The number of user IDs that accessed the current page. | Deduplication | non-real-time |
Page views | Automatic page instrumentation | The total number of times the current page was accessed. | Not deduplicated | Non-real-time |
Exit rate | Automatic page instrumentation | The ratio of exits from the current page to the total views of that page. The formula is: Exit Rate = (Total non-deduplicated views of the current page - Total non-deduplicated views originating from the current page) / Total non-deduplicated views of the current page. | No deduplication | Non-real-time |
Time on page | Automatic page instrumentation | The total time spent on the current page, derived from the time-on-page field, divided by the total number of non-deduplicated views of the current page. | Data is not deduplicated. | Non-real-time |
Device analysis
Metric | Instrumentation | Calculation rule | Deduplicate | Real-time |
|---|---|---|---|---|
Launches | Activation instrumentation | From the device model dimension, this is the total number of times a user opens the application. This includes cold starts and bringing the application to the foreground after it was running in the background. | No deduplication | Non-real-time |
Active users | Heartbeat instrumentation | From the device model dimension, this is the number of device IDs that log on to the application. | Deduplication | Non-real-time |
New users | Activation instrumentation | From the device model dimension, this is the number of new device IDs that log on to the application. | Deduplication | Non-real-time |
Active accounts | Activation instrumentation | From the device model dimension, this is the number of user IDs that log on to the application. | Deduplication | Non-real-time |
Is this page helpful?