Analíticas

Las analíticas requieren un plan Pro o Enterprise.

La página de analíticas en tu panel muestra datos sobre los visitantes de tu sitio, cómo interactúan con el asistente, qué buscan y sus comentarios. Utiliza esta información para identificar qué páginas son más valiosas para tus usuarios y realizar un seguimiento de las tendencias a lo largo del tiempo. Los datos de analíticas se actualizan con un pequeño retraso, normalmente en unos minutos desde la interacción. Los eventos muy recientes pueden no aparecer de inmediato.

Tráfico

La sección de tráfico de la página de analíticas muestra el total de visitantes, vistas de página, conversaciones del asistente, búsquedas y mensajes de comentarios de los usuarios. Revisa tus analíticas de tráfico para:

Supervisar tendencias de tráfico: Observa los cambios en el tráfico humano y de agentes después de actualizaciones o nuevo contenido para comprender el impacto de tus cambios.
Identificar páginas populares: Utiliza las páginas mejor clasificadas para comprender qué contenido es más importante para tus usuarios y así asegurarte de que esté actualizado y sea completo.
Rastrear fuentes de referencia: Comprende de dónde provienen tus usuarios para ayudarte a optimizar tu contenido para la audiencia adecuada.

Vistas de agentes

Mintlify identifica a los visitantes agentes por dirección IP y user agent. El recuento de visitantes agentes aproxima las fuentes distintas de tráfico de IA en lugar de sesiones o conversaciones individuales de agentes. Múltiples solicitudes desde la misma dirección IP cuentan como un solo visitante. Utiliza las vistas de agentes para ayudar a determinar:

Distribución de agentes de IA: Observa qué plataformas de IA acceden a tus documentos para saber qué herramientas prefieren tus usuarios.
Oportunidades de integración: Identifica qué plataformas de IA priorizar para optimización y pruebas.
Patrones de tráfico de IA: Supervisa qué agentes son más activos y cómo cambia su uso a lo largo del tiempo.

Asistente

La sección del asistente de la página de analíticas muestra el uso del asistente a lo largo del tiempo y el historial de chats. Temas del asistente agrupa las conversaciones por temas y categorías. Temas votados negativamente muestra qué temas reciben más comentarios negativos de los usuarios. Temas votados positivamente muestra qué temas reciben más comentarios positivos de los usuarios. Historial de chat muestra los registros de todas las conversaciones del asistente. Revisa tus analíticas del asistente para:

Supervisar el uso del asistente: Observa los cambios en el uso del asistente para comprender cómo tus usuarios interactúan con tu contenido.
Identificar temas frecuentes: Utiliza los temas y categorías con mayor frecuencia para comprender qué temas son más importantes para tus usuarios. Identifica lagunas en la cobertura y prioriza las actualizaciones de contenido.
Encontrar dónde tienen dificultades los usuarios: Utiliza el análisis de sentimiento para ver qué temas reciben comentarios negativos y prioriza mejorar ese contenido.
Revisar el historial de chat: Obtén datos detallados y de alta intención sobre cómo piensan tus usuarios acerca de tu producto revisando su historial de chat con el asistente. Ve qué términos usan, en qué necesitan ayuda y qué tareas intentan realizar.

Búsqueda

La sección de búsqueda de la página de analíticas muestra el volumen de búsquedas, las consultas sin resultados y las tasas de clics. Revisa tus analíticas de búsquedas para:

Supervisar las tendencias de búsqueda: Observa los cambios en las consultas de búsqueda para comprender cómo tus usuarios encuentran tu contenido y sobre qué temas quieren información.
Identificar consultas frecuentes: Utiliza las consultas frecuentes para comprender qué temas son más importantes para tus usuarios. Identifica lagunas en la cobertura y prioriza las actualizaciones de contenido.
Identificar tasas de clics bajas: Las tasas de clics (CTR) muestran cuántos usuarios hacen clic en un resultado de búsqueda después de escribir una consulta. Un CTR bajo puede indicar que los resultados de búsqueda no son relevantes para las consultas de los usuarios. Si tienes términos de búsqueda frecuentes con un CTR bajo, considera mejorar la relevancia de los resultados de búsqueda añadiendo palabras clave y actualizando tu contenido.

Comentarios

La pestaña de comentarios muestra un gráfico de barras de los comentarios a lo largo del tiempo y elementos específicos de comentarios. Consulta Comentarios para obtener más información sobre cómo utilizar los datos de comentarios para mejorar tu contenido.

Filtrar período de tiempo

Utiliza el selector de rango para ajustar el período de tiempo de los datos mostrados.

El selector de rango expandido para mostrar opciones para visualizar diferentes períodos de tiempo de datos.

Exportar analíticas

Exporta categorías de analíticas a CSV para un análisis más profundo, generación de informes o archivo. Las exportaciones respetan el rango de tiempo seleccionado.

Haz clic en Export to CSV.
Selecciona qué categoría exportar: tráfico, referencias, conversaciones del asistente, búsquedas o comentarios.
Mintlify te envía un correo electrónico con un enlace de descarga cuando la exportación esté lista.

El botón de exportar a CSV en la página de analíticas.

Exportaciones del asistente

Las exportaciones del asistente incluyen las consultas, respuestas, fuentes y una columna resolutionStatus que indica si el asistente respondió con éxito a cada pregunta (answered o unanswered). Utiliza la columna resolutionStatus para identificar lagunas en la documentación reveladas por preguntas que el asistente no pudo resolver.

Ejemplos de prompts de análisis para exportaciones del asistente:

Enumera todas las consultas que no tenían fuentes citadas.
Encuentra patrones en las interacciones fallidas.
Agrupa las consultas sin respuesta por tema para priorizar las actualizaciones de contenido.

Transmitir eventos de analíticas

La transmisión de analíticas está disponible en los planes Enterprise.

Transmite eventos de analíticas a Amazon S3 casi en tiempo real. Usa la transmisión para enviar eventos a tu data warehouse o a canalizaciones de analíticas sin esperar a las exportaciones CSV. Los miembros con permiso para actualizar la configuración de la organización pueden agregar varios destinos, elegir qué categorías de eventos enviar y seleccionar desde qué deployments transmitir. La transmisión de analíticas usa un modelo de inclusión: no se transmite ningún evento hasta que selecciones al menos una categoría y al menos un deployment. La misma selección de categorías y deployments se aplica a todos los destinos.

Agregar un destino

Ve a la página Streaming de tu panel.
En la sección Analytics streaming, selecciona Configure.
Selecciona Add destination.
Introduce una etiqueta opcional para identificar el destino y luego proporciona los detalles de conexión de Amazon S3: bucket, región de AWS, ID de clave de acceso y clave de acceso secreta. Opcionalmente, introduce un prefijo que Mintlify agregará al principio de cada clave de objeto.
Selecciona Add destination.

Preparar credenciales de Amazon S3

Crea un usuario de IAM con una clave de acceso cuya política permita escribir en el bucket de destino. Mintlify no admite actualmente la asunción de roles ni credenciales temporales que requieran un token de sesión. Como mínimo, otorga s3:PutObject en el bucket y el prefijo de clave que planeas usar. Por ejemplo:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject"],
      "Resource": "arn:aws:s3:::your-bucket-name/analytics/*"
    }
  ]
}

Usa el ID de clave de acceso y la clave de acceso secreta de ese usuario de IAM al agregar el destino. El prefijo de clave es opcional. Mintlify lo agrega al principio de cada clave de objeto.

Para dejar de transmitir a un destino, abre la configuración de transmisión y selecciona el icono de eliminar junto al destino.

Seleccionar categorías transmitidas

Ve a la página Streaming de tu panel.
En la sección Analytics streaming, selecciona Configure.

En Streamed categories, selecciona las categorías que quieres enviar.

Categoría	Ejemplos
Page views	Eventos de vista de página y de Markdown.
Navigation	Clics en elementos de navegación, clics en CTA de navegación y cambios de versión.
Search	Consultas de búsqueda, clics en resultados, cierres de búsqueda y comparaciones de búsqueda.
Page components	Interacciones con expandibles, acordeones, bloques de código y el playground de la API.
Feedback	Pulgares arriba, pulgares abajo y envíos de comentarios detallados.
AI Assistant	Conversaciones del asistente, fuentes, sugerencias, comentarios y errores.
Context menu & MCP	Acciones del menú contextual, copias de enlaces MCP, instalaciones de servidores MCP y llamadas a herramientas MCP.

Los ejemplos resumen cada categoría. Usa el valor eventType transmitido para identificar el evento exacto.

Selecciona Save changes.

Seleccionar deployments transmitidos

Elige qué deployments de tu organización envían eventos. Cada deployment aparece por subdominio. Seleccionar All deployments selecciona todos los deployments que existen cuando guardas la configuración. Si creas otro deployment más adelante, vuelve a la configuración de transmisión y selecciónalo.

Ve a la página Streaming de tu panel.
En la sección Analytics streaming, selecciona Configure.
En Streamed deployments, selecciona los deployments desde los que quieres enviar eventos.
Selecciona Save changes.

No se transmite ningún evento hasta que selecciones al menos una categoría y al menos un deployment.

Comprender los datos transmitidos

Mintlify escribe objetos JSON delimitados por saltos de línea (.jsonl) en tu bucket. Los nombres de los objetos se generan a partir de marcas de tiempo UTC. Si configuras un prefijo de clave, Mintlify escribe los objetos bajo ese prefijo. Cada línea contiene un sobre de evento con eventType y payload. eventType es el nombre del evento, como docs.content.view. payload contiene el evento de analíticas como un objeto JSON o una cadena codificada en JSON. Si payload es una cadena, conviértela a JSON antes de cargarla en tu data warehouse.

Ejemplo de evento transmitido

{
  "eventType": "docs.content.view",
  "payload": {
    "event_id": "4b91fdbc-4677-4e03-b51b-5f2da41c8654",
    "subdomain": "docs",
    "user_id": "",
    "anon_id": "anon_01JZ8W6QKEJ6ECG1T7QK2S5PZ2",
    "session_id": "session_01JZ8W8CS5JC8T18HXH8ES7Z5M",
    "created_at": "2026-07-22T23:21:41.063Z",
    "event": "docs.content.view",
    "path": "/quickstart",
    "referrer": "https://www.example.com/",
    "user_agent": "Mozilla/5.0",
    "ip": "203.0.113.10",
    "properties": {}
  }
}

El payload del evento contiene los siguientes campos:

Campo	Descripción
`event_id`	UUID que identifica el evento. Úsalo como clave de deduplicación al cargar datos.
`subdomain`	Subdominio del deployment que generó el evento.
`user_id`	ID del usuario autenticado, cuando está disponible.
`anon_id`	ID del visitante anónimo, cuando está disponible.
`session_id`	ID de la sesión del visitante o del asistente, cuando está disponible.
`created_at`	Marca de tiempo ISO 8601 que indica cuándo ocurrió el evento.
`event`	Nombre del evento. Coincide con `eventType` en el sobre.
`path`	Ruta de la documentación donde ocurrió el evento.
`referrer`	URL de referencia, cuando está disponible.
`user_agent`	Cadena de agente de usuario del navegador o cliente.
`ip`	Dirección IP del visitante.
`properties`	Datos específicos del evento como un objeto JSON o una cadena codificada en JSON.

Los cambios de configuración pueden tardar hasta un minuto en aplicarse.

Los eventos transmitidos pueden contener datos personales, como direcciones IP, identificadores de usuario y sesión, consultas y respuestas del asistente, y comentarios o información de contacto enviados como feedback. Aplica los controles de acceso, las políticas de retención y los demás requisitos de tratamiento de datos adecuados para tu organización.

Primeros pasos

Organizar

Personalizar

Crear contenido

Documentar APIs

Desplegar

Optimizar

Tráfico

Vistas de agentes

Asistente

Búsqueda

Comentarios

Filtrar período de tiempo

Exportar analíticas

Exportaciones del asistente

Transmitir eventos de analíticas

Agregar un destino

Seleccionar categorías transmitidas

Seleccionar deployments transmitidos

Comprender los datos transmitidos

​Tráfico

​Vistas de agentes

​Asistente

​Búsqueda

​Comentarios

​Filtrar período de tiempo

​Exportar analíticas

​Exportaciones del asistente

​Transmitir eventos de analíticas

​Agregar un destino

​Seleccionar categorías transmitidas

​Seleccionar deployments transmitidos

​Comprender los datos transmitidos

Tráfico

Vistas de agentes

Asistente

Búsqueda

Comentarios

Filtrar período de tiempo

Exportar analíticas

Exportaciones del asistente

Transmitir eventos de analíticas

Agregar un destino

Seleccionar categorías transmitidas

Seleccionar deployments transmitidos

Comprender los datos transmitidos