Retention and audience
For AI agents: this page is Markdown at https://squiggle.sh/docs/product/audience.md. Every docs page is listed at https://squiggle.sh/llms.txt, and all of them are one file at https://squiggle.sh/llms-full.txt.
The Product screen’s Audience tab answers who uses your app and whether they come back: retention by cohort, the releases they were on, each identified user, and every session.
Retention
Each row is a cohort: the users first seen on one day, or in one week. Each column is a later day or week, and the cell is the share of that cohort who came back then. A period that hasn’t arrived yet is left empty rather than shown as 0%, so a new cohort doesn’t look like one nobody returned to.
A cell counts the people active in that week, not by that week, so a later column can be higher than an earlier one. Pick a cell to see who it counts:
| Week of | Users | w0 | w1 | w2 | w3 | w4 |
|---|---|---|---|---|---|---|
| Oct 8 | 7 | |||||
| Oct 1 | 5 | |||||
| Sep 24 | 9 | |||||
| Sep 17 | 6 | |||||
| Sep 10 | 8 |
Of the 8 people first seen in the week of Sep 10, 3 (38%) used the app again in week 2. tom came back in week 3, not week 2, so this cell doesn’t count tom.
- maya
- leo
- sara
- tom
- nina
- omar
- ivy
- raj
The rest of the tab
| Section | What it shows |
|---|---|
| Releases | Each version your sessions ran, with when it first appeared and how many sessions it has, so you can line a change in the numbers up with a release. Read from the release, appVersion or version trait, in that order. |
| Users | Each identified user with their traits, session count, total time and when they were last seen. A user is marked at risk when they have been away for three times their usual gap between sessions. |
| Sessions | Each session with its length, user, screens and actions. Expand one to see its screens, actions, gestures and errors on one timeline, or open it on the Performance screen. |
From the terminal
squiggle product retention --weekly # weekly cohorts instead of dailysquiggle product releases # each release, when it first appeared, and its sessionssquiggle product users # identified users, with an at-risk flagsquiggle product sessions --limit 50 # the newest 50 sessions