La specifica delle coorti per un report sulle coorti.
I report sulle coorti creano una serie temporale di fidelizzazione utenti per la coorte. Ad esempio, potresti selezionare la coorte di utenti acquisiti nella prima settimana di settembre e seguire questa coorte per le sei settimane successive. La selezione degli utenti acquisiti nella prima settimana della coorte di settembre è specificata nell'oggetto cohort
. Seguendo questa coorte per le prossime sei settimane, è specificata nell'oggetto cohortsRange
.
Ad esempio, consulta la sezione Esempi di report di coorte.
La risposta al report potrebbe mostrare una serie temporale settimanale in cui la tua app ha conservato il 60% di questa coorte dopo tre settimane e il 25% dopo sei settimane. Queste due percentuali possono essere calcolate dalla metrica cohortActiveUsers/cohortTotalUsers
e saranno righe separate nel report.
Rappresentazione JSON |
---|
{ "cohorts": [ { object ( |
Campi | |
---|---|
cohorts[] |
Definisce i criteri di selezione per raggruppare gli utenti in coorti. La maggior parte dei report sulle coorti definisce una sola coorte. Se vengono specificate più coorti, ciascuna può essere riconosciuta nel report con il relativo nome. |
cohortsRange |
I report sulle coorti seguono le coorti per un intervallo di date dei report esteso. Questo intervallo specifica la durata dell'offset per seguire le coorti. |
cohortReportSettings |
Impostazioni facoltative per un report sulle coorti. |
Coorte
Definisce un criterio di selezione della coorte. Una coorte è un gruppo di utenti che condividono una caratteristica comune. Ad esempio, gli utenti con lo stesso firstSessionDate
appartengono alla stessa coorte.
Rappresentazione JSON |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
Campi | |
---|---|
name |
Assegna un nome a questa coorte. Questo nome viene attribuito alla dimensione |
dimension |
Dimensione utilizzata dalla coorte. Obbligatorio e supporta solo |
dateRange |
La coorte seleziona gli utenti la cui data di primo contatto è compresa tra le date di inizio e di fine definite in In una richiesta di coorte, questo Questo valore |
CohortsRange
Consente di configurare l'intervallo di date dei report esteso per un report sulle coorti. Specifica una durata dell'offset per seguire le coorti.
Rappresentazione JSON |
---|
{
"granularity": enum ( |
Campi | |
---|---|
granularity |
Obbligatoria. La granularità utilizzata per interpretare i valori |
startOffset |
Se Se Se |
endOffset |
Obbligatoria. Se Se Se |
Granularità
La granularità utilizzata per interpretare i valori startOffset
e endOffset
per l'intervallo di date del report esteso per un report di coorte.
Enum | |
---|---|
GRANULARITY_UNSPECIFIED |
Non deve mai essere specificato. |
DAILY |
Granularità giornaliera. Comunemente utilizzato se il valore dateRange della coorte è di un solo giorno e la richiesta contiene cohortNthDay . |
WEEKLY |
Granularità settimanale. Comunemente utilizzato se il valore dateRange della coorte dura una settimana (a partire da domenica e termina il sabato) e la richiesta contiene cohortNthWeek . |
MONTHLY |
Granularità mensile. Comunemente utilizzato se il valore dateRange della coorte dura un mese e la richiesta contiene cohortNthMonth . |
CohortReportSettings
Impostazioni facoltative di un report sulle coorti.
Rappresentazione JSON |
---|
{ "accumulate": boolean } |
Campi | |
---|---|
accumulate |
Se il valore è true, accumula il risultato dal giorno del primo contatto a quello finale. Non supportata in |