CohortSpec

La especificación de cohortes para un informe de cohorte.

Los informes de cohortes crean una serie temporal de la retención de usuarios de la cohorte. Por ejemplo, podrías seleccionar la cohorte de usuarios que se adquirieron en la primera semana de septiembre y seguirla durante las siguientes seis semanas. La selección de los usuarios adquiridos en la cohorte de la primera semana de septiembre se especifica en el objeto cohort. En el objeto cohortsRange, se especifica el seguimiento de esa cohorte durante las próximas seis semanas.

Para ver ejemplos, consulta Ejemplos de informes de cohorte.

La respuesta del informe podría mostrar una serie temporal semanal en la que se indique que tu aplicación retuvo el 60% de esta cohorte después de tres semanas y el 25% después de seis semanas. Estos dos porcentajes se pueden calcular con la métrica cohortActiveUsers/cohortTotalUsers y aparecerán en filas separadas en el informe.

Representación JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Campos
cohorts[]

object (Cohort)

Define los criterios de selección para agrupar a los usuarios en cohortes.

La mayoría de los informes de cohortes solo definen una. Si se especifican varias cohortes, cada una se puede reconocer en el informe por su nombre.
cohortsRange

object (CohortsRange)

Los informes de cohortes siguen a las cohortes durante un período extendido del informe. Este rango especifica una duración de compensación para seguir a las cohortes.
cohortReportSettings

object (CohortReportSettings)

Configuración opcional para un informe de cohorte.

Cohorte

Define un criterio de selección de cohorte. Una cohorte es un grupo de usuarios que comparten una característica en común. Por ejemplo, los usuarios con el mismo firstSessionDate pertenecen a la misma cohorte.

Representación JSON 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Campos
name

string

Asigna un nombre a esta cohorte. La dimensión cohort tiene este valor en una respuesta de informe. Si se establece, no puede comenzar con cohort_ ni RESERVED_. Si no se establecen, las cohortes se nombran según su índice basado en cero cohort_0, cohort_1, etcétera.
dimension

string

Es la dimensión que usa la cohorte. Es obligatorio y solo admite firstSessionDate.
dateRange

object (DateRange)

La cohorte selecciona a los usuarios cuya fecha de primer contacto está entre la fecha de inicio y la fecha de finalización definidas en dateRange. Este dateRange no especifica el período completo de los datos de eventos que se incluyen en un informe de cohorte. En un informe de cohorte, este dateRange se extiende con el nivel de detalle y el desfase presentes en el cohortsRange. Los datos de eventos para el período del informe extendido están presentes en un informe de cohorte.

En una solicitud de cohorte, este dateRange es obligatorio y el dateRanges en RunReportRequest o RunPivotReportRequest no se debe especificar.

Por lo general, este dateRange debe alinearse con el nivel de detalle de la cohorte. Si CohortsRange usa el nivel de detalle diario, este dateRange puede ser un solo día. Si CohortsRange usa nivel de detalle semanal, este dateRange se puede alinear con un límite de semana, que comienza el domingo y finaliza el sábado. Si CohortsRange usa nivel de detalle mensual, este dateRange se puede alinear con un mes, comenzando el primer día y finalizando el último día del mes.

CohortsRange

Configura el período del informe extendido para un informe de cohorte. Especifica una duración de compensación para seguir a las cohortes.

Representación JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Campos
granularity

enum (Granularity)

Obligatorio. Es el nivel de detalle que se usa para interpretar startOffset y endOffset para el período del informe extendido de un informe de cohorte.
startOffset

integer

startOffset especifica la fecha de inicio del período del informe extendido para un informe de cohorte. Por lo general, startOffset se establece en 0 para que los informes contengan datos a partir de la adquisición de la cohorte.

Si granularity es DAILY, el startDate del período del informe extendido es el startDate de la cohorte más startOffset días.

Si granularity es WEEKLY, el startDate del período del informe extendido es el startDate de la cohorte más startOffset * 7 días.

Si granularity es MONTHLY, el startDate del período del informe extendido es el startDate de la cohorte más startOffset * 30 días.
endOffset

integer

Obligatorio. endOffset especifica la fecha de finalización del período del informe extendido para un informe de cohorte. endOffset puede ser cualquier número entero positivo, pero se suele establecer entre 5 y 10 para que los informes contengan datos sobre la cohorte para los próximos períodos de nivel de detalle.

Si granularity es DAILY, el endDate del período del informe extendido es el endDate de la cohorte más endOffset días.

Si granularity es WEEKLY, el endDate del período del informe extendido es el endDate de la cohorte más endOffset * 7 días.

Si granularity es MONTHLY, el endDate del período del informe extendido es el endDate de la cohorte más endOffset * 30 días.

Nivel de detalle

Es el nivel de detalle que se usa para interpretar startOffset y endOffset para el período del informe extendido de un informe de cohorte.

Enumeraciones
GRANULARITY_UNSPECIFIED Nunca se debe especificar.
DAILY Nivel de detalle diario Se usa comúnmente si el dateRange de la cohorte es un solo día y la solicitud contiene cohortNthDay.
WEEKLY Nivel de detalle semanal. Se usa con frecuencia si el dateRange de la cohorte tiene una duración de una semana (comienza el domingo y termina el sábado) y la solicitud contiene cohortNthWeek.
MONTHLY Nivel de detalle mensual. Se usa con frecuencia si el dateRange de la cohorte tiene un mes de duración y la solicitud contiene cohortNthMonth.

CohortReportSettings

Configuración opcional de un informe de cohorte.

Representación JSON 
{
  "accumulate": boolean
}
Campos
accumulate

boolean

Si es verdadero, acumula el resultado desde el día del primer contacto hasta el día final. No se admite en RunReportRequest.