CohortSpec

La specifica delle coorti per un report sulle coorti.

I report sulle coorti creano una serie temporale della 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 è specificata nell'oggetto cohort. La coorte successiva per le sei settimane successive è specificata nell'oggetto cohortsRange.

Per alcuni esempi, consulta Esempi di report sulle coorti.

La risposta del report potrebbe mostrare una serie temporale settimanale in cui, ad esempio, la tua app ha mantenuto il 60% di questa coorte dopo tre settimane e il 25% dopo sei settimane. Queste due percentuali possono essere calcolate utilizzando la metrica cohortActiveUsers/cohortTotalUsers e saranno righe separate nel report.

Rappresentazione JSON
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
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 dal nome.

cohortsRange

object (CohortsRange)

I report sulle coorti seguono le coorti in un intervallo di date dei report esteso. Questo intervallo specifica una durata dell'offset per seguire le coorti.

cohortReportSettings

object (CohortReportSettings)

Impostazioni facoltative per un report sulle coorti.

Coorte

Definisce i criteri di selezione delle coorti. 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 (DateRange)
  }
}
Campi
name

string

Assegna un nome a questa coorte. La dimensione cohort viene assegnata a questo nome in una risposta del report. Se impostato, non può iniziare con cohort_ o RESERVED_. Se non è impostato, le coorti vengono denominate in base all'indice a partire da 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 del primo contatto è compresa tra la data di inizio e la data 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 sulle coorti, questo dateRange viene esteso dalla granularità e dall'offset presenti in cohortsRange; i dati sugli eventi per l'intervallo di date dei report esteso sono presenti in un report sulle coorti.

In una richiesta di coorte, questo dateRange è obbligatorio e il dateRanges in RunReportRequest o RunPivotReportRequest deve essere non specificato.

In genere, questo dateRange deve essere in linea con la granularità della coorte. Se CohortsRange utilizza la granularità giornaliera, dateRange può essere un solo giorno. Se CohortsRange utilizza la granularità settimanale, può essere allineato a un confine di settimana, che inizia di domenica e termina di sabato.dateRange Se CohortsRange utilizza la granularità mensile, questo dateRange può essere allineato a un mese, a partire dal primo e terminando con l'ultimo giorno del mese.

CohortsRange

Configura 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)

Obbligatorio. La granularità utilizzata per interpretare startOffset e endOffset per l'intervallo di date dei report estesi per un report sulle coorti.

startOffset

integer

startOffset specifica la data di inizio dell'intervallo di date dei report estesi per un report sulle coorti. startOffset viene in genere impostato su 0 in modo che i report contengano i dati dall'acquisizione della coorte in poi.

Se granularity è DAILY, il startDate dell'intervallo di date dei report esteso è startDate della coorte più startOffset giorni.

Se granularity è WEEKLY, il startDate dell'intervallo di date dei report esteso è startDate della coorte più startOffset * 7 giorni.

Se granularity è MONTHLY, il startDate dell'intervallo di date dei report esteso è startDate della coorte più startOffset * 30 giorni.

endOffset

integer

Obbligatorio. endOffset specifica la data di fine dell'intervallo di date dei report esteso per un report sulle coorti. endOffset può essere qualsiasi numero intero positivo, ma in genere viene impostato su un valore compreso tra 5 e 10 in modo che i report contengano i dati sulla coorte per i successivi periodi di tempo di granularità.

Se granularity è DAILY, il endDate dell'intervallo di date dei report esteso è endDate della coorte più endOffset giorni.

Se granularity è WEEKLY, il endDate dell'intervallo di date dei report esteso è endDate della coorte più endOffset * 7 giorni.

Se granularity è MONTHLY, il endDate dell'intervallo di date dei report esteso è endDate della coorte più endOffset * 30 giorni.

Granularità

La granularità utilizzata per interpretare startOffset e endOffset per l'intervallo di date dei report estesi per un report sulle coorti.

Enum
GRANULARITY_UNSPECIFIED Non deve mai essere specificato.
DAILY Granularità giornaliera. Utilizzato di frequente se il dateRange della coorte è un solo giorno e la richiesta contiene cohortNthDay.
WEEKLY Granularità settimanale. Viene utilizzato di solito se dateRange della coorte ha una durata di una settimana (da domenica a sabato) e la richiesta contiene cohortNthWeek.
MONTHLY Granularità mensile. Di uso comune se la 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 true, accumula il risultato dal giorno del primo contatto al giorno di fine. Non supportato in RunReportRequest.