同类群组报告的同类群组规范。
同类群组报告会为同类群组创建用户留存率时间序列。例如,您可以选择在 9 月的第一周获取的用户同类群组,并在接下来的 6 周内跟踪该同类群组。cohort
对象中会指定选择 9 月第一周同类群组中获取的用户。在接下来的六周内,追踪该同类群组在 cohortsRange
对象中指定。
如需查看示例,请参阅同类群组报告示例。
报告响应可以显示每周时间序列,其中假设您的应用在三周后保留了此同类群组的 60%,在六周后保留了此同类群组的 25%。这两个百分比可以通过指标“cohortActiveUsers/cohortTotalUsers
”计算得出,在报告中将显示为不同的行。
JSON 表示法 |
---|
{ "cohorts": [ { object ( |
字段 | |
---|---|
cohorts[] |
定义将用户分组为同类群组的选择条件。 大部分同类群组报告仅定义一个同类群组。如果指定了多个同类群组,则报告中可以按同类群组的名称识别每个同类群组。 |
cohortsRange |
同类群组报告在较长的报告日期范围内跟踪同类群组。此范围用于指定同类群组的偏移时长。 |
cohortReportSettings |
同类群组报告的可选设置。 |
同类群组
定义同类群组选择条件。同类群组是具有共同特征的一组用户。例如,具有相同firstSessionDate
的用户属于同一个同类群组。
JSON 表示法 |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
字段 | |
---|---|
name |
为该同类群组指定名称。在报告响应中,维度 |
dimension |
同类群组使用的维度。必需,仅支持 |
dateRange |
该同类群组选择首次接触日期介于 在同类群组请求中,此 此 |
CohortsRange
为同类群组报告配置延长的报告日期范围。指定跟踪同类群组的偏移时长。
JSON 表示法 |
---|
{
"granularity": enum ( |
字段 | |
---|---|
granularity |
必需。一个粒度,用于解读同类群组报告中较长报告日期范围内的 |
startOffset |
如果“ 如果“ 如果“ |
endOffset |
必需。 如果“ 如果“ 如果“ |
细化程度
一个粒度,用于解读同类群组报告中较长报告日期范围内的startOffset
和endOffset
。
枚举 | |
---|---|
GRANULARITY_UNSPECIFIED |
不应指定。 |
DAILY |
按天细分。通常用于同类群组的 dateRange 为一天且请求包含 cohortNthDay 的情况。 |
WEEKLY |
按周细分。通常在以下情况下使用:同类群组的 dateRange 持续一周(从星期日开始,到星期六结束),并且请求包含 cohortNthWeek 。 |
MONTHLY |
按月细分。通常用于同类群组的 dateRange 持续一个月且请求包含 cohortNthMonth 的情况。 |
CohortReportSettings
同类群组报告的可选设置。
JSON 表示法 |
---|
{ "accumulate": boolean } |
字段 | |
---|---|
accumulate |
如果为 true,累积从首次接触日到结束日期的累积结果。在 |