> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/insights/onsite/traffic/vercel-agent-analytics.md). # de Vercel Conecta tu proyecto de Vercel a AirOps para rastrear el tráfico de bots de IA mediante Vercel Log Drains. Conecta tu proyecto de Vercel con AirOps para rastrear el tráfico de bots de IA. AirOps aprovisiona automáticamente un **Drenaje de registros de Vercel** cuando instalas la integración, clasifica las visitas de bots de IA (ChatGPT, Claude, Perplexity, Google y más) y muestra información en tu panel de Agent Analytics. *** ### Prerrequisitos * Una **AirOps** cuenta con Agent Analytics habilitado * Una **Vercel Pro o Enterprise** cuenta (los Log Drains no están disponibles en los planes Hobby) * Una **proyecto de Vercel** que sirve tu sitio web en un dominio personalizado * Una **Brand Kit** en AirOps cuyo dominio coincide con el dominio de implementación de Vercel (configurable en Context > Brand Kits > Brand URL) Si no estás seguro de si tu brand kit está configurado correctamente, consulta con tu contacto de Customer Success de AirOps antes de instalar. *** ### Paso 1: Instala AirOps desde Vercel Marketplace 1. Abre la URL de instalación: [`https://vercel.com/integrations/airops-agent-analytics/new`](https://vercel.com/integrations/airops-agent-analytics/new) 2. Vercel muestra un selector de equipo. Selecciona el **equipo de Vercel** que es propietario del proyecto que quieres rastrear. 3. Vercel muestra la pantalla **Instalar AirOps Agent Analytics** Bajo «Selecciona a qué proyectos tendrá acceso la integración», elige **Proyectos específicos** y selecciona solo el/los proyecto(s) que sirven a tu sitio de marca rastreado. 4. Haz clic en **Instalar**. {% hint style="info" %} Recomendamos encarecidamente **Proyectos específicos** frente a **Todos los proyectos**. «Todos los proyectos» da a la integración acceso a cada proyecto dentro de tu equipo de Vercel, incluidos los no relacionados (sitios de marketing, herramientas internas, despliegues de vista previa). AirOps filtra los registros que no coinciden con el dominio de tu brand kit antes de almacenarlos, pero aun así generan egreso del drain de Vercel (aproximadamente $0.50/GB) en tu factura. Elegir solo el proyecto del sitio de marca mantiene predecibles los costos de Vercel y evita transmitir tráfico que se descartará. {% endhint %} *** ### Paso 2: Conéctate a tu espacio de trabajo de AirOps Después de autorizar en Vercel, serás redirigido de vuelta a AirOps. * Si tu cuenta de AirOps tiene acceso a **un espacio de trabajo**, la integración se conecta automáticamente. * Si tienes acceso a **varios espacios de trabajo**, aparece un selector. Selecciona el espacio de trabajo al que quieres vincular esta integración de Vercel. AirOps aprovisiona automáticamente un Vercel Log Drain en tu equipo seleccionado. No se requiere configuración manual de URL de endpoint, secretos de firma ni encabezados Bearer. Serás redirigido a la página de integración AirOps Agent Analytics en Vercel, confirmando que la instalación se completó. *** ### Paso 3: Verifica la conexión En AirOps, ve a **Insights > Settings > General** de cualquier brand kit y desplázate hasta la **Integraciones conectadas** sección. Deberías ver una **de Vercel** fila con: * Una insignia verde **Conectado** insignia * El nombre de tu equipo de Vercel conectado * Una **Desinstalar en Vercel** acción Los datos comienzan a fluir en cuanto tu sitio recibe tráfico de un bot de IA. Con volúmenes bajos de tráfico, Vercel agrupa los registros y los entrega cada **30 a 60 segundos**. {% hint style="warning" %} de Vercel **Prueba** (en la configuración de Drains del lado de Vercel) solo envía registros sintéticos sin datos de solicitud. Una prueba aprobada no **no** significa que el tráfico real aparecerá en AirOps; solo confirma que el endpoint es accesible. El tráfico real de agentes llega una vez que un bot de IA realiza una solicitud a tu sitio que coincide con los proyectos configurados. {% endhint %} *** ### Solución de problemas | Síntoma | Causa probable | Solución | | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | La fila de Vercel muestra **Conectado** pero no aparece ningún dato en Insights Traffic | El dominio de tu brand kit no coincide con el dominio de despliegue de Vercel | En AirOps, abre la configuración de Brand Kit y confirma que la URL de marca coincide con el dominio que realmente sirve tu proyecto de Vercel (por ejemplo, `acme.com` no `www.acme.com` si tu sitio se sirve en `acme.com`). | | Vercel te envía un correo con «drain errored» | El endpoint de AirOps devolvió 4xx/5xx durante más de 50 entregas en una hora, o más del 80% de las entregas en una hora | Contacta con Customer Success de AirOps. Podemos diagnosticarlo a partir de los registros del servidor. | | El drain aparece como «active» pero no aparecen filas después de 5 minutos | Lo probaste con la URL de implementación autogenerada de Vercel (por ejemplo, `-.vercel.app`) | La protección de implementación de Vercel en planes Pro devuelve 401 a los bots en estas URLs. Usa en su lugar el alias público de tu proyecto o un dominio personalizado. | | El botón de prueba se aprueba, pero nunca aparece datos reales | Estás accediendo a rutas que devuelven 404 en un despliegue estático | Los 404 en despliegues solo estáticos se sirven desde la caché de borde de Vercel sin invocar el drain. Visita una ruta conocida que realmente exista en tu despliegue. | | La columna de bytes muestra 0 para algunas solicitudes | Los aciertos de caché estática no incluyen `responseByteSize` | Esto es lo esperado en activos estáticos almacenados en caché por Vercel. Otras métricas (estado, agente de usuario, tiempo) no se ven afectadas. | | Quitaste la integración en Vercel pero AirOps todavía muestra **Conectado** | La página muestra un estado desactualizado | Haz una recarga forzada de la página de AirOps (Cmd+Shift+R en Mac, Ctrl+Shift+R en Windows). El webhook de desinstalación de Vercel es asíncrono y tarda unos segundos en llegar. | *** ### Requisitos del plan Los Vercel Log Drains están disponibles solo en **Vercel Pro y Enterprise** planes. Los planes Hobby no pueden crear drains; si tu equipo está en Hobby, tendrás que actualizar antes de instalar. Vercel cobra el egreso del drain a aproximadamente $0.50 por GB transmitido, cargado en tu factura de Vercel. Para sitios con poco tráfico, esto suele ser menos de $1 al mes. Para sitios con mucho tráfico, reduce el costo de dos maneras: limita la instalación a **Proyectos específicos** solo en el proyecto del sitio de marca (consulta el Paso 1) y, en la configuración por entorno de Vercel, comienza con solo Producción y excluye los despliegues de vista previa. *** ### Configuración de seguridad y de privilegio mínimo #### Permisos necesarios para instalar **En Vercel:** cualquier usuario con el **Miembro** rol en tu equipo de Vercel puede instalar la integración. No se requiere ser Owner. Configurar integraciones forma parte de las responsabilidades estándar del rol de Member ([roles de acceso de Vercel](https://vercel.com/docs/rbac/access-roles)). **En AirOps:** el usuario que complete la instalación debe haber iniciado sesión en AirOps y ser miembro del espacio de trabajo de destino, y funciona cualquier rol de AirOps. #### Usuario dedicado de estilo servicio AirOps no tiene un primitivo separado de identidad de máquina distinto de un usuario, pero la integración está diseñada para que el usuario que instala sea solo el actor en el momento de la instalación y no el principal en tiempo de ejecución. Puedes cumplir las expectativas de privilegio mínimo tratando una cuenta de usuario dedicada como un proxy de cuenta de servicio: 1. Invita a un usuario nombrado y dedicado (por ejemplo, `vercel-airops@yourcompany.com`) a tu espacio de trabajo de AirOps. Usa el rol de menor privilegio que ofrezca tu espacio de trabajo. 2. Inicia sesión una vez como ese usuario y completa la instalación OAuth. 3. Después de completar la instalación, ese usuario no tiene autoridad en tiempo de ejecución. La integración sigue autenticándose mediante el token de API del espacio de trabajo descrito abajo. Puedes eliminar al usuario del espacio de trabajo después si tu política de seguridad lo requiere; la integración seguirá funcionando. El mismo patrón aplica del lado de Vercel: un usuario dedicado de Vercel con el rol Member puede hacer la instalación y luego quedarse como miembro inactivo del equipo. #### Autenticación en tiempo de ejecución Después de la instalación, ninguna sesión de usuario interviene en ninguna entrega del drain. La autenticación en cada entrega tiene dos capas: * **firma HMAC-SHA1** del cuerpo de la solicitud, con clave de un secreto del drain por instalación generado por AirOps en el momento de la instalación. Vercel envía la firma en el encabezado `x-vercel-signature` en cada entrega. * **token Bearer** en el encabezado `Authorization` El token es la **clave API de AirOps de tu espacio de trabajo**, escrita en la configuración del drain durante la instalación. Ambos factores están a nivel de espacio de trabajo, no de usuario. El usuario que instala solo se registra en los metadatos de auditoría de AirOps. #### Rotación de tokens La clave API del espacio de trabajo se puede rotar en la app en **Cuenta > Espacio de trabajo > Clave API** (requiere rol de administrador del espacio de trabajo de AirOps). Hay dos cosas que entender antes de rotar: * El drain de Vercel tiene el token anterior incrustado en su `Authorization` encabezado saliente. Después de la rotación, el drain comenzará a fallar la autenticación hasta que la integración se reinstale desde Vercel (lo que escribe el nuevo token en un nuevo drain). * La misma clave API del espacio de trabajo autentica otras API de AirOps (API pública, servidor MCP, SDK). Rotarla afecta a todas ellas, no solo a Vercel. Si la cadencia de rotación forma parte de tu política de cumplimiento, la secuencia segura es: rota el token de AirOps y luego reinstala inmediatamente la integración de Vercel desde el listado del marketplace de Vercel. #### Lo que esta integración no hace * No solicita ámbitos en tu cuenta de Vercel más allá de lo necesario para crear y gestionar un log drain en el equipo seleccionado. No puede leer el código fuente del proyecto, las variables de entorno ni los registros de despliegue fuera del flujo de solicitudes del drain. * No escribe de vuelta en tu cuenta de Vercel de forma continua. Después del aprovisionamiento inicial del drain, AirOps solo recibe datos de Vercel; no vuelve a llamar a la API de Vercel a menos que reinstales o desconectes. Si tu revisión de seguridad necesita más detalle, contacta con Customer Success de AirOps y podemos guiar a tu equipo a través del flujo de datos a nivel de implementación. *** ### Desconexión Para eliminar la integración de Vercel: 1. En AirOps, abre **Insights > Settings > General > Connected Integrations**. 2. Haz clic en **Desinstalar en Vercel** en la fila de Vercel. Esto te lleva a la página de integraciones de tu equipo de Vercel. 3. Busca la integración de AirOps y haz clic en **Eliminar**. Confirma. 4. AirOps marca la integración como **Desconectada** en tu siguiente actualización de la página. Tus datos históricos de Vercel permanecen en AirOps después de desconectarte. Para reanudar el seguimiento, haz clic en **Reinstalar en Vercel** desde la misma fila. *** ### Qué rastrea AirOps Una vez conectado, AirOps automáticamente: * **Ingresa todas las solicitudes servidas por Vercel:** vistas de página, activos, llamadas a la API * **Clasifica el tráfico de bots de IA:** identifica visitas de ChatGPT, Claude, Google, Perplexity, Meta, Apple, Bing, Bytedance, Common Crawl y otros * **Categoriza el comportamiento de rastreo:** distingue entre rastreadores de entrenamiento de IA (GPTBot, ClaudeBot, etc.), capturas de búsqueda de IA (PerplexityBot, OAI-SearchBot, etc.) y navegación por IA iniciada por el usuario (ChatGPT-User, Claude-User, etc.) * **Muestra analíticas:** desgloses del tráfico, proporciones bot frente a humano y tendencias de rastreo en tu panel --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.airops.com/docs/es/insights/onsite/traffic/vercel-agent-analytics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.