CohortSpec

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 (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 proprio nome.
cohortsRange

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

object (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 (DateRange)
  }
}
Campi
name

string

Assegna un nome a questa coorte. Questo nome viene assegnato alla dimensione cohort in una risposta a un report. Se impostato, non può iniziare con cohort_ o RESERVED_. Se non viene impostato, le coorti vengono chiamate in base al loro indice su 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 del primo contatto è compresa tra la data di inizio e quella 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 valore di 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 sulle coorti.

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

Questo dateRange deve generalmente essere in linea con la granularità della coorte. Se CohortsRange utilizza una granularità giornaliera, il valore di dateRange può essere un solo giorno. Se CohortsRange utilizza una granularità settimanale, questo dateRange può essere allineato a una settimana, da domenica a sabato. Se CohortsRange utilizza una granularità mensile, questo dateRange può essere allineato a un mese, iniziando dal primo fino all'ultimo giorno del mese.

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 (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Campi
granularity

enum (Granularity)

Obbligatorio. La granularità utilizzata per interpretare i valori startOffset e endOffset per l'intervallo di date del report esteso per un report sulle coorti.
startOffset

integer

startOffset specifica la data di inizio dell'intervallo di date del report esteso per un report sulle coorti. Il valore startOffset viene generalmente impostato su 0 per far sì che i report contengano i dati relativi all'acquisizione della coorte in poi.

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

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

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

integer

Obbligatorio. 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 di solito è impostato da 5 a 10 in modo che i report contengano dati sulla coorte per i successivi periodi di tempo con granularità.

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

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

Se granularity è MONTHLY, il endDate dell'intervallo di date esteso del report è 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 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

boolean

Se impostato su true, accumula il risultato dal giorno del primo contatto al giorno di fine. Non supportata nel seguente paese: RunReportRequest.