CohortSpec
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
Campos |
cohorts[] |
object (Cohort )
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 |
object (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 |
object (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 (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 pela coorte. Obrigatório e compatível apenas com firstSessionDate .
|
dateRange |
object (DateRange )
A coorte seleciona usuários que tiveram o primeiro 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 deslocamento presentes em cohortsRange . Os dados de evento do período estendido do relatório estão presentes em um relatório de coorte. Em uma solicitação de coorte, esse dateRange é obrigatório, e o dateRanges no RunReportRequest ou no RunPivotReportRequest não pode ser especificado. Em geral, esse dateRange precisa estar alinhado à granularidade da coorte. Se CohortsRange usar a granularidade diária, essa dateRange poderá ser um único dia. Se CohortsRange usar granularidade semanal, esse dateRange poderá ser alinhado a um limite de semana, começando no domingo e terminando no sábado. Se CohortsRange usar granularidade mensal, esse dateRange poderá ser alinhado 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 seguir as 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 para o período estendido 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 mais startOffset dias. Se granularity for WEEKLY , o startDate do período estendido do relatório será startDate da coorte mais startOffset * 7 dias. Se granularity for MONTHLY , o startDate do período estendido do relatório será startDate da coorte 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 mais endOffset dias. Se granularity for WEEKLY , o endDate do período estendido do relatório será endDate da coorte mais endOffset * 7 dias. Se granularity for MONTHLY , o endDate do período estendido do relatório será endDate da coorte mais endOffset * 30 dias.
|
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 |
boolean
Se verdadeiro, acumula o resultado do primeiro dia de contato até o dia de término. Indisponível em RunReportRequest .
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-05-02 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Não contém as informações de que eu preciso"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Muito complicado / etapas demais"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Desatualizado"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema na tradução"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema com as amostras / o código"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Outro"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Fácil de entender"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Meu problema foi resolvido"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Outro"
}]