Embudos de eventos guardados
Cree embudos de eventos ordenados y con límites de tiempo e investigue a las personas detrás de cada paso.
En esta página
Un embudo guardado mide un recorrido con eventos que ya recopilas. es útil para flujos como vista de producto → pago → pago, una secuencia de incorporación, o una ruta de soporte a conversión. No es el antiguo embudo de solo reacción en la descripción general de Analytics: un embudo guardado funciona con el vocabulario de eventos compartido.
Cree un embudo
Abra Análisis → Embudos y cree un embudo con entre dos y veinte pasos. Asigne a un nombre claro para cada paso y elija uno o más nombres de eventos alternativos. Una alternativa coincidente de completa ese paso.
También puede agregar una condición en las propiedades del evento, un segmento de audiencia y un filtro de identidad . Estos utilizan el mismo vocabulario de eventos, condiciones y segmentos aprobados que el resto del producto. No se puede ingresar una ruta de propiedad como una expresión arbitraria .
El orden es estricto: un cliente llega al paso 2 sólo después de llegar al paso 1, y así sucesivamente. Si los eventos llegan en el mismo instante, su orden de eventos duradero decide la secuencia. Un evento que ocurrió antes del paso anterior no completa el embudo.
Hora, identidad y audiencia
Cada informe tiene un límite UTC from inclusivo y to exclusivo. Elija un rango
de no más de 366 días. Además, puede establecer una ventana de conversión
de un minuto a 366 días; un paso posterior fuera de esa ventana no se cuenta.
El informe funciona con identidades de clientes canónicas. Cuando se combinan perfiles, sus eventos se evalúan como un solo cliente cuyo origen del evento admite la identidad canónica de . Los eventos anónimos siguen el filtro de identidad del embudo y no se convierte silenciosamente en una persona conocida.
La pertenencia al segmento se lee del segmento publicado actualmente en el momento del informe . No es una instantánea histórica, por lo que un segmento que cambie hoy puede cambiar qué clientes califican para un informe solicitado hoy. El rango del informe permanece fijo mientras la regla de audiencia esté vigente.
Elija deliberadamente el modo de conversión:
- Todos actualmente mantiene la primera conversión válida para un cliente, el mismo resultado que Primero. Sigue estando disponible por compatibilidad; aún no está disponible una agregación distinta para cada progresión.
- Primero mantiene la primera conversión válida de un cliente. Los registros
- Repetidos repiten conversiones válidas después de la primera, pero todavía no se reflejan en el informe visible. Los contadores, métricas, desgloses y cohortes de utilizan una mejor progresión por cliente, independientemente del seleccionado. modo. Trate Repetir como una configuración de compatibilidad, no como un informe de múltiples conversiones.
Leer el informe
Cada paso muestra la cantidad de clientes, la conversión del primer paso y del paso anterior, la baja y el tiempo medio desde el paso anterior. Un desglose de propiedad configurado por devuelve como máximo 25 valores con nombre más Otro, , por lo que una propiedad de alta cardinalidad no puede crear un informe ilimitado.
La tendencia UTC tiene segmentos diarios continuos que abarcan exactamente el rango
[from, to) solicitado. Su primer segmento parcial comienza en from; Los depósitos posteriores
comienzan a la medianoche UTC. Los cubos vacíos contienen ceros.
Las advertencias son señales deterministas de la calidad de los datos, no afirmaciones de
de importancia estadística. zero_denominator significa que ningún visitante llegó al primer paso, por lo que
Las tasas de conversión no están disponibles. high_cardinality_truncated significa que
los valores de desglose se agruparon en Otros después del límite de 25 valores. Hay
no hay advertencia de partial_data. Un denominador cero se muestra como cero en lugar de como
porcentaje engañoso.
Cohortes y segmentos
Seleccione un recuento de pasos para abrir su cohorte. Puedes inspeccionar el cliente canónico. resúmenes y hojear los resultados con un cursor; evento sensible crudo las propiedades no están expuestas en el cajón de cohortes.
Puede guardar una cohorte completada o descartada como un segmento dinámico. el segmento almacena el ID del embudo, la revisión inmutable, el paso, el rango de fechas limitado y un Filtro de rotura aprobado opcional. No guarda una lista única de identificaciones de clientes. Recalcular ese segmento evalúa la revisión del embudo registrada de nuevo.
Revisiones y edición segura
Al guardar una edición se crea la siguiente revisión del embudo. Los informes y segmentos de cohortes pueden seguir usando una revisión anterior, por lo que el análisis histórico sigue siendo legible. Si otra persona guarda primero, vuelva a cargar o clonar el embudo en lugar de sobrescribir su revisión. Puede clonar, archivar o eliminar un embudo. Se rechaza la eliminación cuando otro objeto compatible todavía hace referencia a él. Ejemplo de API
Utilice un token de acceso personal con analytics:read para un informe. Los valores debajo de
son marcadores de posición, no datos ni credenciales reales del cliente.
curl -X POST "$BASE_URL/api/bots/$BOT_ID/funnels/$FUNNEL_ID/query" \
-H "Authorization: Bearer $PAT" \
-H "Content-Type: application/json" \
-d '{
"revision": 3,
"from": "2026-07-01T00:00:00Z",
"to": "2026-08-01T00:00:00Z"
}'
Una edición obsoleta devuelve 409 con funnel revision conflict; un rango no válido o
ilimitado devuelve 400 o 422 dependiendo de dónde falla la validación.
Para una solicitud de cohorte, envíe el mismo rango limitado más step_position,
completed, limit y el cursor devuelto en la página siguiente. Para crear un segmento de cohorte
también se necesita segments:write.