mintlify__docs/es/optimize/analytics.mdx

---
title: "Analíticas"
description: "Consulta el tráfico, tendencias de búsqueda, uso del asistente y comentarios de los usuarios en el panel de analíticas de Mintlify para mejorar tu contenido."
keywords: ["analytics","metrics","page views","traffic","trends","insights","impressions","CTA","call-to-action"]
boost: 3
---

<Info>
  Las analíticas requieren un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=analytics).
</Info>

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.

<div id="traffic">
  ## Tráfico
</div>

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.

<Frame>
  <img
    src="/images/analytics/traffic-light.png"
    alt="La sección de tráfico de la página de analíticas."
    className="block dark:hidden"
  />

  <img
    src="/images/analytics/traffic-dark.png"
    alt="La sección de tráfico de la página de analíticas."
    className="hidden dark:block"
  />
</Frame>

<div id="agent-views">
  ### Vistas de agentes
</div>

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.

<div id="assistant">
  ## Asistente
</div>

La sección del asistente de la página de analíticas muestra el uso del asistente a lo largo del tiempo y una tarjeta de conversaciones con dos vistas.

- **Categorías de conversaciones** agrupa las conversaciones en categorías y temas. Selecciona una categoría para ver sus temas y, luego, selecciona un tema para abrir un panel con métricas de satisfacción y todas las conversaciones de ese tema.
- **Todas las conversaciones** muestra todas las conversaciones del asistente del rango de fechas seleccionado con una insignia de feedback en cada fila. Selecciona una conversación para abrir la transcripción completa.

Utiliza el menú desplegable **Filtrar** para acotar cualquiera de las dos vistas a conversaciones con feedback **Positivo** o **Negativo**. Los filtros de feedback se aplican en el servidor, por lo que los resultados se mantienen completos entre páginas.

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**: Profundiza en categorías y temas para comprender sobre qué preguntan más tus usuarios. Identifica lagunas en la cobertura y prioriza las actualizaciones de contenido.
- **Encontrar dónde tienen dificultades los usuarios**: Filtra por feedback negativo para ver qué conversaciones valoraron mal los usuarios y prioriza mejorar el contenido subyacente.
- **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 las conversaciones con el asistente. Ve qué términos usan, en qué necesitan ayuda y qué tareas intentan realizar.

<Frame>
  <img
    src="/images/analytics/assistant-light.png"
    alt="La sección del asistente de la página de analíticas."
    className="block dark:hidden"
  />

  <img
    src="/images/analytics/assistant-dark.png"
    alt="La sección del asistente de la página de analíticas."
    className="hidden dark:block"
  />
</Frame>

<div id="search">
  ## Búsqueda
</div>

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.

<Frame>
  <img
    src="/images/analytics/search-light.png"
    alt="La sección de búsqueda de la página de analíticas."
    className="block dark:hidden"
  />
  
  <img
    src="/images/analytics/search-dark.png"
    alt="La sección de búsqueda de la página de analíticas."
    className="hidden dark:block"
  />
</Frame>

<div id="user-engagements">
  ## Interacciones de usuarios
</div>

La sección Interacciones de usuarios muestra cómo los visitantes interactúan con tu contenido y tus llamadas a la acción. Incluye un resumen, tendencias de interacción por página, rutas frecuentes por la documentación y embudos de búsqueda y del asistente. Todas las tarjetas utilizan el rango de tiempo seleccionado para esta sección.

<div id="interactions-overview">
  ### Resumen
</div>

La tarjeta **Resumen** muestra:

- **Total de interacciones**: Los clics en el CTA y las acciones a nivel de página combinados.
- **Promedio de interacciones por sesión**: El total de interacciones dividido entre las sesiones con actividad de CTA, acciones o vistas de página.
- **Tasa de clics del CTA**: Los clics en el CTA divididos entre las vistas de página humanas, con un máximo del 100 %.

Cada métrica incluye una insignia de variación que compara el período seleccionado con el período anterior de la misma duración.

<div id="actions-over-time">
  ### Acciones realizadas a lo largo del tiempo
</div>

El gráfico **Acciones realizadas a lo largo del tiempo** rastrea dos series por separado:

- **Clics en el CTA**: Clics en el [botón principal de la barra de navegación](/es/organize/settings-structure#navbar). Esta serie requiere un botón `navbar.primary` en `docs.json`.
- **Acciones**: Acciones del menú contextual, copias de bloques de código, solicitudes del playground de la API y comentarios de aprobación o desaprobación.

La tabla clasifica las páginas por la suma de clics y acciones. Incluye Vistas de página, Clics, Tasa de CTA, Acciones y Tasa de acciones. La tasa de CTA corresponde a los clics en el CTA divididos entre las vistas humanas. La tasa de acciones corresponde a las acciones divididas entre las vistas humanas.

<div id="user-flow">
  ### Flujo de usuarios
</div>

La tarjeta **Rutas del flujo de usuarios** muestra las rutas que siguen los visitantes después de entrar en la documentación desde una página seleccionada. El selector enumera hasta diez páginas con más sesiones iniciales. El gráfico sigue las sesiones a través de la página de entrada y hasta tres interacciones de página posteriores.

Para interpretar un flujo de usuarios:

1. Selecciona un punto de entrada.
2. Pasa el cursor sobre un nodo para ver las sesiones que entran (**Entrada**), las que continúan a otra página (**Salida**) y la tasa de abandono cuando corresponda.

Cada columna muestra hasta seis páginas con nombre, ordenadas por las sesiones que llegan. Las demás se combinan en un nodo **Other (N páginas)** al final de la columna. La agrupación conserva las sesiones que continúan, por lo que el abandono refleja a quienes no siguen navegando. La última columna no muestra el abandono porque el gráfico no presenta otra página posterior.

Usa los flujos para identificar rutas frecuentes, encontrar páginas donde los visitantes se detienen y comparar patrones entre puntos de entrada o períodos. No necesitas configurar el sitio. Cuando el Flujo de usuarios está disponible para tu despliegue, los datos aparecen después de que la documentación recibe tráfico.

<div id="user-funnel">
  ### Embudo de usuarios
</div>

La tarjeta **Embudo de usuarios** cuenta las sesiones en cada etapa y muestra cuántas llegaron o abandonaron antes. Usa el selector para cambiar entre **Búsqueda a respuesta**, la vista predeterminada, y **Conversación del asistente**.

#### Búsqueda a respuesta

| Etapa | Descripción |
| --- | --- |
| **Búsqueda abierta** | La sesión abrió la interfaz de búsqueda. Esta etapa solo aparece en períodos que comienzan el 31 de julio de 2026 o después y contienen eventos de apertura. |
| **Consulta introducida** | La sesión envió una consulta de búsqueda. |
| **Resultado seleccionado** | La sesión hizo clic en un resultado de búsqueda. |
| **Página visitada** | La sesión vio la página abierta desde un resultado de búsqueda. |
| **Acción realizada** | Después de visitar la página, la sesión hizo clic en un CTA, usó una acción del menú contextual, copió un bloque de código, envió una solicitud del playground de la API o envió comentarios de aprobación o desaprobación. |

Usa el abandono entre etapas para identificar si los visitantes tienen dificultades para buscar, elegir un resultado, llegar a la página o seguir interactuando después.

#### Conversación del asistente

El embudo del asistente excluye las sesiones marcadas como spam e incluye estas etapas:

| Etapa | Descripción |
| --- | --- |
| **Conversación iniciada** | La sesión contenía actividad del asistente. |
| **Respuesta obtenida** | El asistente completó al menos una respuesta en la sesión. |
| **Pregunta de seguimiento** | El asistente completó al menos dos respuestas en la sesión. |
| **Interacción con la respuesta** | La misma sesión contenía al menos una respuesta completada y un clic en una fuente, una copia de respuesta, un clic en un resultado de búsqueda web o comentarios de aprobación o desaprobación. |

La etapa Interacción no requiere que el evento ocurra después de la respuesta completada ni que exista una pregunta de seguimiento.

Revisa tus analíticas de interacciones de usuarios para:

- **Identificar páginas de alta intención**: Las páginas con una alta tasa de clics del CTA suelen indicar visitantes que están listos para dar el siguiente paso, como registrarse en tu producto o hablar con tu equipo de ventas.
- **Comprender qué contenido importa a tus usuarios**: Revisa las páginas de alta intención para conocer qué contenido motiva a las personas a interactuar más a fondo con tu producto o servicio. Asegúrate de que estas páginas estén bien mantenidas y considera añadir más contenido relacionado si es necesario.

<div id="feedback">
  ## Comentarios
</div>

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.

<div id="filter-time-period">
  ## Filtrar período de tiempo
</div>

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

<Frame>
  <img
    src="/images/analytics/range-selector-light.png"
    alt="El selector de rango expandido para mostrar opciones para visualizar diferentes períodos de tiempo de datos."
    className="block dark:hidden"
  />

  <img
    src="/images/analytics/range-selector-dark.png"
    alt="El selector de rango expandido para mostrar opciones para visualizar diferentes períodos de tiempo de datos."
    className="hidden dark:block"
  />
</Frame>

<div id="export-analytics">
  ## Exportar analíticas
</div>

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.

<Frame>
  <img
    src="/images/analytics/export-to-csv-light.png"
    alt="El botón de exportar a CSV en la página de analíticas."
    className="block dark:hidden"
  />

  <img
    src="/images/analytics/export-to-csv-dark.png"
    alt="El botón de exportar a CSV en la página de analíticas."
    className="hidden dark:block"
  />
</Frame>

<div id="traffic-exports">
  ### Exportaciones de tráfico
</div>

Las exportaciones de tráfico desglosan las vistas de página por categoría de visitante para que puedas ver qué parte de tu tráfico proviene de humanos en comparación con agentes, rastreadores de búsqueda y otros bots.

| Columna | Descripción |
| --- | --- |
| `humanViews` | Vistas de página HTML del tráfico no generado por bots. |
| `aiViews` | Vistas de agentes de IA como ChatGPT, Claude y Cursor, además de las solicitudes de páginas en Markdown de clientes que no son rastreadores reconocidos. |
| `searchIndexViews` | Vistas de rastreadores de búsqueda e indexación, como Googlebot, Bingbot y OAI-SearchBot. |
| `trainingViews` | Vistas de rastreadores que recopilan contenido para el entrenamiento de modelos de IA, como GPTBot, ClaudeBot y CCBot. |
| `otherAiViews` | Vistas de otros bots relacionados con IA que no encajan en las categorías anteriores. |
| `totalViews` | La suma de `humanViews` y `aiViews`. |

Mintlify clasifica cada vista utilizando patrones conocidos de user-agent para rastreadores de búsqueda, rastreadores de entrenamiento y asistentes de IA. Las categorías son mutuamente excluyentes, por lo que cada vista cuenta para exactamente una columna.

<Note>
  `searchIndexViews`, `trainingViews` y `otherAiViews` no se contabilizan en `totalViews`.
</Note>

<div id="assistant-exports">
  ### Exportaciones del asistente
</div>

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.

<Tip>
  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.
</Tip>

<div id="stream-analytics-events">
  ## Transmitir eventos de analíticas
</div>

<Info>
  La transmisión de analíticas está disponible en los [planes Enterprise](https://mintlify.com/pricing?ref=analytics-streaming).
</Info>

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.

<div id="add-a-destination">
  ### Agregar un destino
</div>

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**.

<Accordion title="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:

  ```json
  {
    "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.
</Accordion>

Para dejar de transmitir a un destino, abre la configuración de transmisión y selecciona el icono <Icon icon="trash-2" /> de eliminar junto al destino.

<div id="select-streamed-categories">
  ### Seleccionar categorías transmitidas
</div>

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**.

<div id="select-streamed-deployments">
  ### Seleccionar deployments transmitidos
</div>

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.

<div id="understand-streamed-data">
  ### Comprender los datos transmitidos
</div>

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.

<Accordion title="Ejemplo de evento transmitido">
  ```json
  {
    "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": {}
    }
  }
  ```
</Accordion>

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.

<Warning>
  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.
</Warning>