A especificação de coortes para um relatório de coorte.
Os relatórios de coorte criam uma série temporal de retenção de usuários. Por exemplo, é possível selecionar a coorte de usuários que foram adquiridos na primeira semana de setembro e acompanhar essa coorte pelas próximas seis semanas. A seleção dos usuários adquiridos na primeira semana da coorte de setembro é especificada no objeto cohort
. O acompanhamento dessa coorte pelas próximas seis semanas é especificado no objeto cohortsRange
.
Para ver exemplos, consulte Exemplos de Relatório de coorte.
A resposta do relatório pode mostrar uma série temporal semanal em que digamos que seu app reteve 60% da coorte após três semanas e 25% após seis semanas. Essas duas porcentagens podem ser calculadas pela métrica cohortActiveUsers/cohortTotalUsers
e serão linhas separadas no relatório.
Representação JSON |
---|
{ "cohorts": [ { object ( |
Campos | |
---|---|
cohorts[] |
Define os critérios de seleção para agrupar usuários em coortes. A maioria dos relatórios define somente uma única coorte. Se várias coortes forem especificadas, cada uma delas poderá ser reconhecida no relatório pelo nome. |
cohortsRange |
Os relatórios de coorte seguem coortes para um período estendido de relatório. Esse intervalo especifica uma duração de deslocamento para seguir as coortes. |
cohortReportSettings |
Configurações opcionais para um relatório de coorte. |
Coorte
Define os critérios de seleção de uma coorte. Um coorte é um grupo de usuários que compartilham uma característica comum. Por exemplo, usuários com o mesmo firstSessionDate
pertencem à mesma coorte.
Representação JSON |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
Campos | |
---|---|
name |
Atribui um nome a essa coorte. A dimensão |
dimension |
Dimensão usada pela coorte. Obrigatório e compatível apenas com |
dateRange |
A coorte seleciona usuários que tiveram o primeiro contato entre a data de início e de término definidas no Em uma solicitação de coorte, esse Em geral, esse |
CohortsRange
Configura o período estendido de um relatório de coorte. Especifica uma duração de deslocamento para seguir as coortes.
Representação JSON |
---|
{
"granularity": enum ( |
Campos | |
---|---|
granularity |
Obrigatório. A granularidade usada para interpretar |
startOffset |
Se Se Se |
endOffset |
Obrigatório. Se Se Se |
Granularidade
A granularidade usada para interpretar startOffset
e endOffset
para o período estendido de um relatório de coorte.
Enums | |
---|---|
GRANULARITY_UNSPECIFIED |
Nunca deve ser especificado. |
DAILY |
Granularidade diária. Geralmente usado se o dateRange da coorte for um único dia e a solicitação contiver cohortNthDay . |
WEEKLY |
Granularidade semanal. Usado normalmente se a dateRange da coorte tiver uma semana de duração (começando no domingo e terminando no sábado) e a solicitação contém cohortNthWeek . |
MONTHLY |
Granularidade mensal. Usado normalmente se o dateRange da coorte tiver um mês de duração e a solicitação contiver cohortNthMonth . |
CohortReportSettings
Configurações opcionais de um relatório de coorte.
Representação JSON |
---|
{ "accumulate": boolean } |
Campos | |
---|---|
accumulate |
Se verdadeiro, acumula o resultado do primeiro dia de contato até o dia de término. Indisponível em |