3.1 KiB
| title | description | menu | aliases | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Admin::Cohort | 表示一组留存指标。 |
|
|
示例
以下是 2022 年 9 月的月度留存数据示例，假设有 2 位用户在 2022 年 9 月注册，并在该月至少活跃过一次。
{
"period": "2022-09-01T00:00:00+00:00",
"frequency": "month",
"data": [
{
"date": "2022-09-01T00:00:00+00:00",
"rate": 1.0,
"value": "2"
}
]
}
以下是 2022 年 9 月 8 日至 2022 年 9 月 14 日这一周的每日留存数据示例，假设有 2 位用户在 2022 年 9 月 8 日注册，其中 1 位用户在 2022 年 9 月 9 日后停止活跃。
{
"period": "2022-09-08T00:00:00+00:00",
"frequency": "day",
"data": [
{
"date": "2022-09-08T00:00:00+00:00",
"rate": 1.0,
"value": "2"
},
{
"date": "2022-09-09T00:00:00+00:00",
"rate": 1.0,
"value": "2"
},
{
"date": "2022-09-10T00:00:00+00:00",
"rate": 0.5,
"value": "1"
},
{
"date": "2022-09-11T00:00:00+00:00",
"rate": 0.5,
"value": "1"
},
{
"date": "2022-09-12T00:00:00+00:00",
"rate": 0.5,
"value": "1"
},
{
"date": "2022-09-13T00:00:00+00:00",
"rate": 0.5,
"value": "1"
},
{
"date": "2022-09-14T00:00:00+00:00",
"rate": 0.5,
"value": "1"
}
]
}
属性
period
描述: 周期开始的时间戳，午夜。
类型: (Datetime) 字符串
版本历史:
3.5.0 - 添加
frequency
描述: 返回数据的时间段大小。
类型: 字符串 (可枚举 oneOf)
day = 每日
month = 每月
版本历史:
3.5.0 - 添加
data
描述: 在给定周期内注册的用户的留存数据。
类型: Array of CohortData
版本历史:
3.5.0 - 添加
CohortData entity attributes
date
描述: 时间段开始的时间戳，午夜。
类型: (Datetime) 字符串
版本历史:
3.5.0 - 添加
rate
描述: 在指定 period 内注册并在给定 date 时间段内活跃的用户的百分比。
类型: 数值
版本历史:
3.5.0 - 添加
value
描述: 在指定的 period 内注册并在给定的 date 时间段内活跃的用户人数。
类型: 整数
版本历史:
3.5.0 - 添加
另请参考
{{< page-relref ref="methods/admin/retention" caption="admin/retention API 方法" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/admin/cohort_serializer.rb" caption="app/serializers/rest/admin/cohort_serializer.rb" >}}
{{< translation-status-zh-cn raw_title="Admin::Cohort" raw_link="/entities/Admin_Cohort/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}