CohortSpec

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 (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 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.