CohortSpec
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Es la especificación de cohortes para un informe de cohorte.
Los informes de cohorte crean una serie temporal de retención de usuarios para la cohorte. Por ejemplo, puedes seleccionar la cohorte de usuarios que se adquirieron en la primera semana de septiembre y seguir esa cohorte durante las próximas seis semanas. La selección de los usuarios adquiridos en la primera semana de la cohorte de septiembre se especifica en el objeto cohort
. La siguiente cohorte de las próximas seis semanas se especifica en el objeto cohortsRange
.
Para ver ejemplos, consulta Ejemplos de informes de cohorte.
La respuesta del informe podría mostrar una serie temporal semanal en la que supongamos que tu app retuvo un 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 serán filas separadas en el informe.
Campos |
cohorts[] |
object (Cohort )
Define los criterios de selección para agrupar usuarios en cohortes. La mayoría de los informes de cohorte definen una sola cohorte. Si se especifican varias cohortes, cada una se puede reconocer en el informe por su nombre.
|
cohortsRange |
object (CohortsRange )
Los informes de cohorte siguen cohortes durante un período de informe extendido. Este rango especifica una duración de desplazamiento para seguir a las cohortes.
|
cohortReportSettings |
object (CohortReportSettings )
Configuración opcional para un informe de cohorte.
|
Cohorte
Define los criterios de selección de una 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 se asigna a este nombre en una respuesta de informe. Si se configura, no puede comenzar con cohort_ ni RESERVED_ . Si no se establece, las cohortes se nombran con su índice basado en cero cohort_0 , cohort_1 , etcétera.
|
dimension |
string
Dimensión que usa la cohorte. Obligatorio y solo admite firstSessionDate .
|
dateRange |
object (DateRange )
La cohorte selecciona a los usuarios cuya fecha de primer contacto se encuentra entre la fecha de inicio y la fecha de finalización definidas en dateRange . Este dateRange no especifica el período completo de datos de eventos que están presentes en un informe de cohorte. En un informe de cohorte, esta dateRange se extiende por el nivel de detalle y la compensación presentes en el cohortsRange . Los datos de eventos para el período extendido del informe están presentes en un informe de cohorte. En una solicitud de cohorte, este dateRange es obligatorio y no se debe especificar el dateRanges en RunReportRequest o RunPivotReportRequest . Por lo general, este dateRange debe estar alineado 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 un nivel de detalle semanal, este dateRange se puede alinear con un límite de semana, desde el domingo hasta el sábado. Si CohortsRange usa el nivel de detalle mensual, este dateRange se puede alinear con un mes, comenzando en el primer día y finalizando el último día del mes.
|
CohortsRange
Configura el período extendido del informe para un informe de cohorte. Especifica una duración de desplazamiento para seguir 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 los valores de startOffset y endOffset del período extendido del informe de un informe de cohorte.
|
startOffset |
integer
startOffset especifica la fecha de inicio del período extendido del informe para un informe de cohorte. startOffset suele establecerse en 0 para que los informes contengan datos desde la adquisición de la cohorte en adelante.
Si granularity es DAILY , el startDate del período extendido del informe es el startDate de la cohorte más startOffset días. Si granularity es WEEKLY , el startDate del período extendido del informe es el startDate de la cohorte más startOffset * 7 días. Si granularity es MONTHLY , el startDate del período extendido del informe 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 extendido del informe de un informe de cohorte. endOffset puede ser cualquier número entero positivo, pero suele establecerse entre 5 y 10, de modo que los informes contengan datos de la cohorte para los siguientes períodos de nivel de detalle. Si granularity es DAILY , el endDate del período extendido del informe es el endDate de la cohorte más endOffset días. Si granularity es WEEKLY , el endDate del período extendido del informe es el endDate de la cohorte más endOffset * 7 días. Si granularity es MONTHLY , el endDate del período extendido del informe 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 los valores de startOffset
y endOffset
del período extendido del informe de un informe de cohorte.
Enumeradores |
GRANULARITY_UNSPECIFIED |
Nunca se debe especificar. |
DAILY |
Nivel de detalle diario: Se suele usar si el dateRange de la cohorte es de un solo día y la solicitud contiene cohortNthDay . |
WEEKLY |
Nivel de detalle semanal. Se suele usar si la dateRange de la cohorte tiene una duración de una semana (comienza el domingo y finaliza el sábado) y la solicitud contiene cohortNthWeek . |
MONTHLY |
Nivel de detalle mensual: Se suele usar si la dateRange de la cohorte tiene una duración de un mes 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 de finalización. No se admite en RunReportRequest .
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-05-02 (UTC)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Falta la información que necesito"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Muy complicado o demasiados pasos"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Desactualizado"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema de traducción"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema con las muestras o los códigos"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Otro"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Fácil de comprender"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Resolvió mi problema"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Otro"
}]