> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 留存指标
> 使用 OneSignal 留存图表追踪用户是否会返回您的应用或网站。按日期构建同期群，并衡量 7 天、14 天或 30 天的留存情况。
使用 OneSignal 仪表板上的**留存**图表，查看您的用户在活跃后的几天内有多大比例回访。
留存功能目前处于测试阶段（Beta），已向所有账户开放。
导航到 **Dashboard > Analytics > Retention** 查看图表。
## 同期群的工作原理
首先选择一个日期。在该日期有会话的所有用户构成您的同期群，并且该群体在整个时间窗口内保持固定，即使他们的订阅在之后发生变化。
您选择的日期是 Day 0，因此只要当天有任何用户活跃，曲线就从 100% 开始。之后的每个点表示同一同期群中在该天回访的用户比例。每一天都单独衡量，因此某个用户即使沉寂一天后再回访，仍会在其回访的那天被计入。
用户在任何一天只要有至少一个会话，就算作当天活跃。
每当用户从完全关闭的状态打开您的应用或网站，或在后台停留至少 30 秒后重新打开时，都会开始一个新会话。如果在 30 秒内返回，则会继续当前会话，而不会开始新会话。
留存会计入每一个会话，无论该会话是否归功于某条消息。请参阅[会话](/docs/en/sessions)以详细了解 OneSignal 如何追踪会话。
留存统计的是**用户**，而不是订阅。同时在手机和笔记本电脑上使用您应用的用户只计一次。
## 图表指标
图表针对您选择的同期群绘制三个值。
| 指标 | 描述 |
| :-------- | :------------------------------------------------------------------------- |
| **同期群规模** | 在同期群起始日期有会话的用户数。这是 Day 0 的总体人数。 |
| **Day N** | 同期群中在该天有会话的用户数。 |
| **留存率** | 在给定日期活跃的同期群成员数除以同期群规模，以百分比表示。对于任何包含用户的同期群，Day 0 都是 100%，因为同期群的定义就是当天活跃的用户。 |
## 筛选器
使用图表上方的控件选择同期群，并选择向前衡量多长时间。
| 控件 | 选项 |
| :---------- | :---------------------------- |
| **同期群起始日期** | 单个日期，范围从最早可用日期到昨天（UTC）。 |
| **时间窗口** | 从同期群起始日期起向前衡量 7 天、14 天或 30 天。 |
| **对比维度** | 无、渠道或平台。 |
渠道序列反映的是用户在同期群起始日期所订阅的渠道，而不是会话来自的渠道。这些序列相互重叠，加总不等于总数，因此同时订阅推送和电子邮件的用户会同时出现在推送序列和电子邮件序列中。未订阅任何渠道的用户会出现在单独的序列中。
OneSignal 在同期群起始日期固定同期群。在时间窗口内稍后订阅新渠道或添加新设备的用户不会被追溯加入同期群。
## 数据可用性
选择同期群起始日期时，请注意以下限制。
* 留存数据自 **2026 年 7 月 24 日**起可用。您无法选择更早的同期群起始日期。
* 留存数据不会回填，因此该日期之前的同期群不可用。
* 天数按 UTC 日历日计算，对每个应用都相同。
* 您可以选择的最近的同期群起始日期是昨天（UTC），因为一天必须结束后才能被计入。
* 曲线在最后一个完整的天结束，而不是以 0% 继续。仍在进行中的时间窗口会显示较短的曲线。
* N 天的时间窗口涵盖 Day 0 到 Day N，因此 7 天的时间窗口会绘制 8 个点。
## 导出图表数据
使用右上角的导出按钮将图表导出为 CSV。文件包含时间窗口内每一天的留存率。导出需要包含 CSV 报告导出功能的计划。
## 常见问题
### 留存会显示消息的打开和点击吗？
不会。留存仅显示用户是否回到了您的应用，并且它会计入每一个会话，无论该会话是否归功于某条消息。若要查看送达率、打开率、点击率和取消订阅率，请使用[参与度趋势](./engagement-analytics)。若要将特定消息与用户的后续行为关联起来，请使用[转化指标](./conversion-metrics)。
### 为什么我的留存图表一直是 0%？
在您选择的日期没有任何用户有会话，因此同期群为空，时间窗口内的每一天都在除以规模为零的同期群。请尝试选择更近的日期，或您确定有活动的日期。留存数据从 2026 年 7 月 24 日开始，且不会回填，因此您可以构建的最早同期群从该日期开始。
### 为什么曲线在时间窗口结束之前就停止了？
留存只计入完整的天。如果您选择五天前作为同期群起始日期并使用 30 天的时间窗口，最后一个完整的天是 Day 4，因此图表绘制五个点（Day 0 到 Day 4），曲线在该处结束。这不是预测，剩余的天会在每天结束后陆续填充。
### 为什么 Day 0 是 100%？
同期群的定义是在同期群起始日期有会话的用户，因此按定义他们在 Day 0 都是活跃的。
例外情况是没有用户的同期群。如果在您选择的日期没有人活跃，则同期群规模为 0，图表会在整个时间窗口内绘制一条平坦的 0% 线，而不是从 100% 开始。
### 如果用户中间跳过一天，他们会被排除在后续天数之外吗？
不会。OneSignal 独立计算每一天。假设某个用户在 Day 0 活跃，在 Day 2 不活跃，然后在 Day 3 再次活跃。该用户在 Day 2 不被计入，因为他们当天没有会话。他们在 Day 3 会再次被计入。
### 为什么各渠道序列加总不等于总数？
一个用户可以订阅多个渠道，而每个渠道序列会计入订阅该渠道的所有用户。同时订阅推送和电子邮件的用户会在两个序列中都被计入，因此这些序列的重叠是设计使然。
### 天数按什么时区衡量？
UTC。天的边界对每个应用都相同，无法按应用单独设置。
### 为什么我在仪表板的其他地方能看到会话，但没有留存数据？
留存数据从 2026 年 7 月 24 日才开始被追踪。该日期之前的会话会出现在其他报告中，但从未被记录用于留存，因此任何起始日期在 2026 年 7 月 24 日之前的同期群都是空的。请参阅[会话](/docs/en/sessions)了解会话数据还会出现在哪些地方。
## 相关内容
解读曲线形状、比较同期群，并了解图表背后的方法论。
OneSignal 如何定义会话，以及如何跨用户的多台设备聚合会话数据。
按渠道追踪您的订阅受众的增长和减少。
仪表板、API、CSV 和事件流中每个指标的权威定义。