CohortSpec

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 foi adquirida na primeira semana de setembro e acompanhar essa coorte nas próximas seis semanas. A seleção dos usuários adquiridos na primeira semana da coorte de setembro é especificada no objeto cohort. O objeto cohortsRange é especificado após essa coorte nas próximas seis semanas.

Para ver exemplos, consulte Exemplos do relatório de coorte.

A resposta do relatório poderia mostrar uma série temporal semanal em que digamos que seu app reteve 60% da coorte após três semanas e 25% dela 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 (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Campos
cohorts[]

object (Cohort)

Define os critérios de seleção para agrupar usuários em coortes.

A maioria dos relatórios de coorte define apenas uma coorte. Se vários coortes forem especificados, cada coorte poderá ser reconhecida no relatório pelo nome.
cohortsRange

object (CohortsRange)

Os relatórios de coorte seguem coortes em um período estendido. Esse intervalo especifica uma duração de deslocamento para seguir os coortes.
cohortReportSettings

object (CohortReportSettings)

Configurações opcionais para um relatório de coorte.

Coorte

Define os critérios de seleção de 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 (DateRange)
  }
}
Campos
name

string

Atribui um nome a essa coorte. A dimensão cohort é avaliada com esse nome em uma resposta de relatório. Se definido, não pode começar com cohort_ ou RESERVED_. Se não for definido, as coortes serão nomeadas pelo índice baseado em zero cohort_0, cohort_1 etc.
dimension

string

Dimensão usada pelo coorte. Obrigatório e só oferece suporte a firstSessionDate.
dateRange

object (DateRange)

A coorte seleciona usuários com a primeira data de contato entre a data de início e de término definidas no dateRange. Esse dateRange não especifica o período completo dos dados de eventos presentes em um relatório de coorte. Em um relatório de coorte, esse dateRange é estendido pela granularidade e pelo deslocamento presentes em cohortsRange. Os dados de eventos do período estendido dos relatórios estão presentes em um relatório de coorte.

Em uma solicitação de coorte, esse dateRange é obrigatório, e o dateRanges em RunReportRequest ou RunPivotReportRequest não pode ser especificado.

Esse dateRange geralmente precisa estar alinhado com a granularidade da coorte. Se a CohortsRange usar a granularidade diária, essa dateRange poderá ser um único dia. Se a CohortsRange usar granularidade semanal, essa dateRange poderá ser alinhada a um limite de semana, começando no domingo e terminando no sábado. Se a CohortsRange usar granularidade mensal, essa dateRange poderá ser alinhada a um mês, começando no primeiro e terminando no último dia do mês.

CohortsRange

Configura o período estendido de um relatório de coorte. Especifica uma duração de deslocamento para acompanhar os coortes.

Representação JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Campos
granularity

enum (Granularity)

Obrigatório. A granularidade usada para interpretar startOffset e endOffset no período estendido do relatório de um relatório de coorte.
startOffset

integer

startOffset especifica a data de início do período estendido do relatório de um relatório de coorte. startOffset geralmente é definido como 0 para que os relatórios contenham dados da aquisição da coorte em diante.

Se granularity for DAILY, o startDate do período estendido do relatório será startDate da coorte e mais startOffset dias.

Se granularity for WEEKLY, o startDate do período estendido do relatório será startDate da coorte e mais startOffset * 7 dias.

Se granularity for MONTHLY, o startDate do período estendido do relatório será startDate da coorte e mais startOffset * 30 dias.
endOffset

integer

Obrigatório. endOffset especifica a data de término do período estendido do relatório de um relatório de coorte. endOffset pode ser qualquer número inteiro positivo, mas geralmente é definido como 5 a 10 para que os relatórios contenham dados sobre a coorte para os próximos períodos de granularidade.

Se granularity for DAILY, o endDate do período estendido do relatório será endDate da coorte e mais endOffset dias.

Se granularity for WEEKLY, o endDate do período estendido do relatório será endDate da coorte e mais endOffset * 7 dias.

Se granularity for MONTHLY, o endDate do período estendido do relatório será endDate da coorte e mais endOffset * 30 dias.

Granularidade

A granularidade usada para interpretar startOffset e endOffset no período estendido do relatório de um relatório de coorte.

Enums
GRANULARITY_UNSPECIFIED Nunca deve ser especificado.
DAILY Granularidade diária. Usado normalmente se o dateRange do 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 tiver cohortNthWeek.
MONTHLY Granularidade mensal. Usado normalmente se a dateRange da coorte tiver duração de um mês e a solicitação contiver cohortNthMonth.

CohortReportSettings

Configurações opcionais de um relatório de coorte.

Representação JSON 
{
  "accumulate": boolean
}
Campos
accumulate

boolean

Se for verdadeiro, acumula o resultado do primeiro dia de contato até o dia de término. Indisponível em RunReportRequest.