> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-62a8a9a4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Analíticas
> Realiza un seguimiento del tráfico, tendencias de búsqueda, uso del asistente y comentarios de los usuarios en el panel de analíticas de Mintlify para mejorar el contenido y evaluar su eficacia.
Las analíticas requieren un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=analytics).
La página de [analíticas](https://app.mintlify.com/analytics) 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](/es/optimize/feedback) 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.
## 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.
1. Haz clic en **Export to CSV**.
2. Selecciona qué categoría exportar: tráfico, referencias, conversaciones del asistente, búsquedas o comentarios.
3. Mintlify te envía un correo electrónico con un enlace de descarga cuando la exportación esté lista.
### 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](https://mintlify.com/pricing?ref=analytics-streaming).
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
1. Ve a la página [Streaming](https://app.mintlify.com/settings/organization/streaming) de tu panel.
2. En la sección **Analytics streaming**, selecciona **Configure**.
3. Selecciona **Add destination**.
4. 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.
5. Selecciona **Add destination**.
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:
```json theme={null}
{
"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
1. Ve a la página [Streaming](https://app.mintlify.com/settings/organization/streaming) de tu panel.
2. En la sección **Analytics streaming**, selecciona **Configure**.
3. 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.
4. 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.
1. Ve a la página [Streaming](https://app.mintlify.com/settings/organization/streaming) de tu panel.
2. En la sección **Analytics streaming**, selecciona **Configure**.
3. En **Streamed deployments**, selecciona los deployments desde los que quieres enviar eventos.
4. 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.
```json theme={null}
{
"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.