Specificare le coorti per un report sulle coorti.
I report sulle coorti creano una serie temporale di fidelizzazione degli utenti per la coorte. Ad esempio, potresti selezionare la coorte di utenti acquisiti nella prima settimana di settembre e seguirla per le sei settimane successive. La selezione degli utenti acquisiti nella coorte della prima settimana di settembre viene specificata nell'oggetto cohort
. La seguente coorte per le sei settimane successive viene specificata nell'oggetto cohortsRange
.
Per alcuni esempi, consulta la sezione Esempi di report di coorte.
La risposta al report potrebbe mostrare una serie temporale settimanale in cui l'app ha conservato il 60% di questa coorte dopo tre settimane e il 25% di questa coorte 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 proprio nome. |
cohortsRange |
I report sulle coorti seguono le coorti per un intervallo di date del report esteso. Questo intervallo specifica una durata dell'offset da seguire per le coorti. |
cohortReportSettings |
Impostazioni facoltative per un report sulle coorti. |
Coorte
Definisce un criterio di selezione della coorte. Una coorte è un gruppo di utenti con 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 assegnato alla dimensione |
dimension |
Dimensione utilizzata dalla coorte. Obbligatorio e supporta solo |
dateRange |
La coorte seleziona gli utenti la cui data del primo contatto è compresa tra la data di inizio e quella di fine definite in In una richiesta di coorte, questo valore Questo |
CohortsRange
Consente di configurare l'intervallo di date del report esteso per un report sulle coorti. Specifica una durata di offset per seguire le coorti.
Rappresentazione JSON |
---|
{
"granularity": enum ( |
Campi | |
---|---|
granularity |
Obbligatorio. La granularità utilizzata per interpretare i valori |
startOffset |
Se Se Se |
endOffset |
Obbligatorio. 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 sulle coorti.
Enum | |
---|---|
GRANULARITY_UNSPECIFIED |
Non deve mai essere specificato. |
DAILY |
Livello di granularità giornaliera. Comunemente utilizzato se il valore dateRange della coorte è un solo giorno e la richiesta contiene cohortNthDay . |
WEEKLY |
Livello di granularità settimanale. Comunemente utilizzato se il valore dateRange della coorte ha una durata di una settimana (da domenica a sabato) e la richiesta contiene cohortNthWeek . |
MONTHLY |
Livello di granularità mensile. Di uso comune se l'attributo dateRange della coorte ha una durata di un mese e la richiesta contiene cohortNthMonth . |
CohortReportSettings
Impostazioni facoltative di un report sulle coorti.
Rappresentazione JSON |
---|
{ "accumulate": boolean } |
Campi | |
---|---|
accumulate |
Se impostato su true, accumula il risultato dal giorno del primo contatto al giorno di fine. Non supportata nel seguente paese: |