Conectar fuentes de registros

El fragmento de seguimiento informa de lo que se ejecuta en un navegador o en tu servidor, pero muchos bots de IA descargan páginas sin llegar a ejecutar JavaScript. Las fuentes de registros cubren ese hueco: conecta los registros de tu CDN o de tu servidor y se contabilizarán todas las peticiones relevantes para la IA, cada una con su propia etiqueta de origen para que puedas distinguir las visitas que proceden de los registros de las que proceden del fragmento.

Solo se guardan las peticiones relevantes para la IA. Se conservan los rastreadores de IA conocidos, los agentes con aspecto de bot y las visitas que llegan desde asistentes de IA; el resto del tráfico se descarta al recibirse y nunca se guarda en ningún sitio. Los niveles de verificación se aplican a las visitas procedentes de los registros exactamente igual que a las del fragmento.

Todas las fuentes de registros se autentican con una clave de ingesta de registros, distinta de las claves de tu fragmento de seguimiento, que solo sirve para enviar registros. Todo lo que se describe a continuación está en Ajustes → Conexiones → Seguimiento del sitio web, en la pestaña Registros del servidor.

Cloudflare (un clic)Copy Anchor Link

La vía más rápida para los sitios que pasan por el proxy de Cloudflare. Crea un token de API con exactamente tres permisos: Workers Scripts Edit, Zone Read y Workers Routes Edit. Pega el token y tu dominio, y Citlyze despliega un pequeño Worker en tu zona y lo vincula a la ruta de tu dominio.

El Worker se limita a dejar pasar el tráfico: nunca lee ni modifica el cuerpo de las peticiones ni de las respuestas, y si se produce un error interno, deja pasar la petición igualmente, así que tu sitio nunca se ve afectado. Envía los metadatos de la petición (ruta, estado, user agent, IP, referente, país) después de servir la respuesta. El token se usa una sola vez durante la configuración y nunca se guarda.

Ten en cuenta dos cosas:

• La ruta solo se activa en los registros DNS con proxy (nube naranja).
• En el plan gratuito de Workers, las peticiones comparten una cuota diaria. La opción de prefiltrado hace que el Worker solo envíe los user agents de IA, lo que ahorra cuota, pero los rastreadores que se registren después no se detectarán hasta que vuelvas a desplegar el Worker.

¿Prefieres no pegar un token? Elige la opción manual y Citlyze generará el mismo código del Worker para que lo pegues tú en el panel de Cloudflare.

Para zonas con muchísimo tráfico, Cloudflare Logpush es mejor opción: crea un destino HTTP que apunte a tu URL de ingesta con la clave como parámetro key= de la URL, y Citlyze filtrará los lotes recibidos del mismo modo.

Vercel (log drain)Copy Anchor Link

Pega un token de Vercel y Citlyze creará un log drain que envía automáticamente los registros de peticiones. Limítalo a un proyecto o deja el campo del proyecto vacío para cubrir todo el equipo. El token se guarda cifrado con un único fin: eliminar el drain cuando desconectes la fuente. La ingesta en sí se autentica con la clave de ingesta de registros incluida en la URL del drain.

Webhook genéricoCopy Anchor Link

Cualquier sistema que pueda enviar JSON por POST puede enviar registros. Envía lotes de hasta 500 entradas al endpoint de ingesta con tu clave de ingesta de registros en la cabecera X-API-Key. Cada entrada incluye la marca de tiempo, el método, la URL, el estado y el user agent y, de forma opcional, la IP del cliente, el referente y el país. Encontrarás el contrato completo en la referencia de la API de ingesta de registros.

Subida de archivosCopy Anchor Link

Para una carga puntual de datos históricos, pega una parte de tus registros de acceso directamente en la pestaña Subida. Se admiten dos formatos: CSV con una fila de encabezados (los encabezados habituales de las exportaciones de las CDN se reconocen automáticamente) y el formato combinado de registros de Apache/Nginx. Las entradas de hace más de 30 días se omiten, y el resumen indica cuántas líneas se han analizado, guardado y descartado.

Si subes dos veces el mismo archivo, se rechaza, así que una carga de datos históricos nunca se cuenta dos veces.

Otras CDNCopy Anchor Link

Los usuarios de CloudFront y Akamai ya pueden usar el mismo endpoint mediante el contrato del webhook genérico: dirige a la URL de ingesta, con tu clave, una función Lambda@Edge, un destino HTTPS de DataStream o cualquier herramienta de envío de registros. Los flujos nativos de un clic para estos proveedores llegarán en función de la demanda.

Cómo leer los resultadosCopy Anchor Link

Las visitas procedentes de los registros aparecen en las mismas vistas de rastreadores de IA y de tráfico de IA que las del fragmento. La API pública indica el origen en cada fila, así que en las exportaciones puedes separar lo que vio el fragmento de lo que vieron tus registros.

Las visitas procedentes de los registros incluyen el código de estado HTTP real, así que también alimentan los análisis de errores y redirecciones de Páginas rastreadas. Usa una sola fuente por sitio: si un fragmento de seguimiento y una fuente de registros envían datos del mismo dominio, cada visita se cuenta dos veces; la página de instalación te avisa cuando ocurre.