CohortSpec
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
Campi |
cohorts[] |
object (Cohort )
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 |
object (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 |
object (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 (DateRange )
}
} |
Campi |
name |
string
Assegna un nome a questa coorte. Questo nome viene attribuito alla dimensione cohort in una risposta al report. Se impostato, non può iniziare con cohort_ o RESERVED_ . Se non viene configurato, le coorti vengono denominate in base all'indice in base zero cohort_0 , cohort_1 e così via.
|
dimension |
string
Dimensione utilizzata dalla coorte. Obbligatorio e supporta solo firstSessionDate .
|
dateRange |
object (DateRange )
La coorte seleziona gli utenti la cui data di primo contatto è compresa tra le date di inizio e di fine definite in dateRange . Questo dateRange non specifica l'intervallo di date completo dei dati sugli eventi presenti in un report sulle coorti. In un report di coorte, questo dateRange è esteso dalla granularità e dall'offset presenti nel cohortsRange ; i dati sugli eventi per l'intervallo di date del report esteso sono presenti in un report di coorte. In una richiesta di coorte, questo dateRange è obbligatorio e dateRanges in RunReportRequest o RunPivotReportRequest non deve essere specificato. Questo valore dateRange dovrebbe generalmente essere allineato alla granularità della coorte. Se CohortsRange utilizza la granularità giornaliera, questo dateRange può corrispondere a un solo giorno. Se CohortsRange utilizza la granularità settimanale, questo dateRange può essere allineato al limite di una settimana, a partire da domenica fino a sabato. Se CohortsRange utilizza la granularità mensile, questo dateRange può essere allineato a un mese, a partire dal primo fino all'ultimo giorno del mese.
|
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 (Granularity ),
"startOffset": integer,
"endOffset": integer
} |
Campi |
granularity |
enum (Granularity )
Obbligatoria. La granularità utilizzata per interpretare i valori startOffset e endOffset per l'intervallo di date del report esteso per un report di coorte.
|
startOffset |
integer
startOffset specifica la data di inizio dell'intervallo di date del report esteso per un report sulle coorti. startOffset è generalmente impostato su 0 per fare in modo che i report contengano i dati relativi all'acquisizione della coorte in poi.
Se granularity è DAILY , il startDate dell'intervallo di date del report esteso è pari a startDate della coorte più startOffset giorni. Se granularity è WEEKLY , il startDate dell'intervallo di date del report esteso è pari a startDate della coorte più startOffset * 7 giorni. Se granularity è MONTHLY , il startDate dell'intervallo di date del report esteso è pari a startDate della coorte più startOffset * 30 giorni.
|
endOffset |
integer
Obbligatoria. endOffset specifica la data di fine dell'intervallo di date del report esteso per un report sulle coorti. endOffset può essere qualsiasi numero intero positivo, ma in genere è impostato su un valore compreso tra 5 e 10, in modo che i report contengano dati sulla coorte per diversi periodi di tempo con granularità. Se granularity è DAILY , il endDate dell'intervallo di date del report esteso è pari a endDate della coorte più endOffset giorni. Se granularity è WEEKLY , il endDate dell'intervallo di date del report esteso è pari a endDate della coorte più endOffset * 7 giorni. Se granularity è MONTHLY , il endDate dell'intervallo di date del report esteso è pari a endDate della coorte più endOffset * 30 giorni.
|
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 |
boolean
Se il valore è true, accumula il risultato dal giorno del primo contatto a quello finale. Non supportata in RunReportRequest .
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-05-02 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Mancano le informazioni di cui ho bisogno"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Troppo complicato/troppi passaggi"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Obsoleti"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema di traduzione"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema relativo a esempi/codice"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Altra"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile da capire"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Il problema è stato risolto"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Altra"
}]