Saltar al contenido
Telemetry
Explorar documentación
GuíasActualizado el 28 de julio de 2026Revisado por los equipos editorial y de producto de Telemetry2 min de lectura

Usa esta documentación con tu agente de programación

Abra un paquete de mensajes enfocados para Claude Code, Codex, Cursor u otro agente de codificación, luego adáptelo al flujo de trabajo que se describe aquí.

En esta página
  1. Emitir hitos duraderos
  2. Calcular dos formas de conversión.
  3. Segmentar solo después de que funcione el viaje base.

Análisis del recorrido del producto con SQL

El recorrido de un producto puede contar sesiones, usuarios, cuentas o intentos. Elegir la unidad después de observar el resultado hace que el análisis sea inestable. Defina la unidad de conteo, los hitos ordenados, las reglas de identidad y la ventana de observación antes de escribir SQL.

Emitir hitos duraderos

Utilice nombres de eventos que describan los resultados del producto completo, como landing_viewed, signup_completed, workspace_created y first_query_run. Incluya un identificador de cuenta o sesión con revisión de privacidad, un nombre de paso estable, orden de pasos, fuente de adquisición limitada y marca de tiempo UTC.

No infiera un hito completado a partir de un clic en un botón cuando la operación subyacente puede fallar. Deduplicar eventos repetidos cuando el productor pueda volver a intentarlo. Documente si el recorrido debe realizarse dentro de una sesión y si los usuarios pueden omitir o repetir pasos.

Calcular dos formas de conversión.

La recorrido del producto receta SQL produce:

  • journey_completion_pct, que compara cada paso con el primer paso.
  • step_to_step_pct, que compara cada paso con el paso inmediatamente anterior.

La primera responde qué parte de la población entrante alcanza un hito. El segundo ubica la transición con la mayor pérdida local. El dispositivo incluido tiene cinco sesiones de entrada y dos que alcanzan el hito de la primera consulta, por lo que ambos porcentajes se pueden reproducir en el navegador SQL parque infantil.

Para embudos de producción más estrictos, primero reduzca a un hito temprano por sesión, verifique el orden de los pasos con funciones de ventana y elija una duración máxima del recorrido. El Guía de análisis del embudo SQL explica esas opciones con más detalle.

Segmentar solo después de que funcione el viaje base.

Valide el recorrido no segmentado antes de agregar dimensiones de origen, plan, dispositivo o experimento. Cada segmento necesita suficiente tiempo de observación completa y suficientes sesiones para respaldar una decisión. Mantenga el recuento bruto al lado de cada tasa.

El caso de uso de análisis de productos conecta el viaje SQL con la activación y la retención. Utilice el guía de implementación de funciones cuando la pregunta sea si una liberación controlada cambió el viaje o su confiabilidad.

Función relacionada del producto

Ejecute DataFusion SQL de solo lectura sobre tablas de eventos estructurados y reutilice el resultado.

Responsabilidad y referencias técnicas

El equipo editorial de Telemetry es responsable de esta explicación; el equipo de producto revisa el comportamiento, los ejemplos y las limitaciones.

Consultar los criterios editoriales