Skip to content

Commit e70a8c3

Browse files
authored
Add retention limits to PANA doc (#31636)
* Update retention_analysis.md * quick reorganizing * quick edit to level 2 headers * moved the content * added the new section to `Define measures`
1 parent b0c2a4e commit e70a8c3

File tree

1 file changed

+13
-10
lines changed

1 file changed

+13
-10
lines changed

content/en/product_analytics/charts/retention_analysis.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,9 @@ Only views and actions can act as events.
2222

2323
## Prerequisites
2424

25-
In order for user retention data to populate, you must set the `usr.id` attribute in your SDK. See the [instructions for sending unique user attributes][4].
25+
For user retention data to populate, you must set the `usr.id` attribute in your SDK. See the [instructions for sending unique user attributes][4].
2626

27-
## Retention types
27+
## Measuring retention events
2828
Product analytics support two types of retention event measurements:
2929

3030
{{< img src="product_analytics/retention/pana_retention_measureby.png" alt="The two types of retention measurements available with product analytics" style="width:80%;" >}}
@@ -41,14 +41,13 @@ For each cohort and return period, `Return on or after` calculates the percentag
4141

4242
`Return on or after` highlights users who either fully leave your product or stop using key functionalities, which is helpful when assessing the effectiveness of onboarding experiences.
4343

44-
45-
## Retention calculation and grouping
46-
47-
### Weighted average cohort calculation
44+
## Calculating retention events
45+
### What is a weighted average cohort
4846
The weighted average cohort summarizes overall cohort behavior by accounting for cohort size. Larger cohorts have more influence on the final value, making the result more representative than an average.
4947

5048
This weighted average calculation is applied across all [visualization types](#visualization-types). For example, in the retention grid, the weighted average is used to populate the summary cell for each time interval.
5149

50+
### How to calculate a weighted average cohort
5251
To compute the value for a specific interval (such as Week 1 in the retention grid), multiply each cohort's value by its size, sum the results, and divide by the total cohort size. The formula is:
5352

5453
```
@@ -71,8 +70,8 @@ This means each cohort's retention rate is scaled by its number of users before
7170
<strong>Note:</strong> The retention chart displays greyed-out values when data is partial or incomplete. This occurs when the time period is ongoing and retention cannot yet be fully calculated.
7271
</div>
7372

74-
### Grouping
75-
You scope retention based on event attributes. The `group by` function is applied to the **start event**. This is helpful is you want to, for example, see how retention compares across user countries.
73+
## Grouping retention events
74+
Use the `group by` function to break down retention based on events' attributes. This is helpful is you want to, for example, see how retention compares across user countries. The `group by` function is applied to the **start event**.
7675

7776

7877
## Build a graph
@@ -83,13 +82,17 @@ To build a retention graph, navigate to **[Product Analytics > Charts][1]**, cli
8382
1. Select the view or action to act as the starting event for defining a group of users.<br>
8483
2. Select the view or action to act as the return event.
8584

86-
### 2. Define the the measures
85+
### 2. Define the measures
8786
1. Select `Retention rate` to see the data in percentages, or `Unique users` to see the absolute number of users.
8887
2. Scope the retention measure `Return on or after` or `Return on` based on when the return event occurs.
89-
3. Choose the time frame for which you want to analyze user retention. Select a period size (day, week, or month) to define how return events are grouped in the analysis.
88+
3. Choose the time frame for which you want to analyze user retention. Select a period size (day, week, or month) to define how return events are grouped in the analysis. Consider the following when selecting a period size:
89+
- **Daily retention**: Can be applied for up to a month.
90+
- **Weekly retention**: Can be applied for up to a year.
91+
- **Monthly retention**: Can be applied for up to 16 months.
9092

9193
{{< img src="product_analytics/retention/pana_retention_timeframes_ui.png" alt="Example Retention Analysis graph" style="width:100%;" >}}
9294

95+
9396
### 3. Define users and add filters
9497
Optionally, select a specific [segment][6] to measure the retention of its users. This defaults to all users. You can also add any desired filter criteria, such as `user country`, `device type`, or `operating system`.
9598

0 commit comments

Comments
 (0)