Instalar el seguimiento de rastreadores de IA

Esta página recorre cada ruta de instalación clic a clic. Para saber qué mide el seguimiento de rastreadores y cómo funciona la verificación, consulta Rastreadores de IA.

Elige la guía que corresponda a donde corre tu sitio:

Antes de empezar: genera una clave de sitio

Toda instalación necesita una clave de sitio, uses la plataforma que uses:

1. En la app, ve a Rastreadores de IA → Instalar seguimiento.
2. Haz clic en Generar clave de sitio. Dale un nombre a la clave y, a ser posible, el dominio del que informará; el dominio también refuerza la verificación de rastreadores firmados para ese sitio.
3. Copia ambos valores del diálogo de confirmación: el ID de clave y el secreto de firma (empieza por ctk_). El secreto se muestra una sola vez; si lo pierdes, usa Rotar en la clave para generar un reemplazo.

Mantén el secreto de firma en privado: cualquiera que lo tenga puede enviar informes de tráfico falsificados para tu sitio. No lo subas a un repositorio público ni lo pegues en código del lado del cliente.

Worker de Cloudflare

Úsalo cuando tu DNS está en Cloudflare y el sitio pasa por su proxy (el interruptor de nube naranja). Es la opción más completa: ve cada petición en el borde, informa de los códigos de estado HTTP reales y funciona sin importar qué haya detrás de Cloudflare.

1. En Rastreadores de IA → Instalar seguimiento, abre la pestaña Cloudflare y copia el fragmento.
2. Sustituye SITE_KEY_ID y ctk_SITE_KEY_SECRET en el fragmento por tu ID de clave y tu secreto de firma.
3. En el panel de Cloudflare, ve a Workers & Pages → Create → Create Worker. Dale un nombre (por ejemplo ai-crawler-tracker) y haz clic en Deploy para crear el worker vacío.
4. Haz clic en Edit code, sustituye el ejemplo generado por tu fragmento y haz clic en Deploy otra vez.
5. Conecta el worker a tu sitio: abre Settings → Domains & Routes → Add → Route del worker, elige tu zona y añade la ruta example.com/*. Si tu sitio también se sirve en www.example.com, añade una segunda ruta para www.example.com/*.
6. Listo: sin cambios de código en tu sitio. El worker deja pasar cada petición a tu origen sin modificarla e informa de las visitas coincidentes en segundo plano.

Dos cosas que comprobar:

• La ruta debe cubrir todas las rutas de página (/*); de lo contrario, las visitas de rastreadores a páginas sin ruta son invisibles.
• Si ya tienes un worker en esas rutas, Cloudflare solo ejecuta un worker por ruta; integra la lógica del fragmento en tu worker existente en vez de añadir un segundo.

Middleware de Vercel / Next.js

Úsalo para una app Next.js desplegada en Vercel. El mismo archivo también funciona en Next.js autoalojado.

1. En Rastreadores de IA → Instalar seguimiento, abre la pestaña Vercel / proxy inverso y copia el fragmento.
2. En tu repositorio de Next.js, crea middleware.ts en la raíz del proyecto (o en src/ si tu app vive ahí) y pega el fragmento.
3. Sustituye SITE_KEY_ID y ctk_SITE_KEY_SECRET por tu ID de clave y tu secreto de firma.
4. Si ya tienes un middleware.ts, no añadas un segundo archivo; Next.js solo ejecuta uno. Copia el bloque auxiliar del fragmento en tu archivo existente, llama a su lógica de informe al principio de tu función de middleware y asegúrate de que tu config matcher sigue cubriendo todas las rutas.
5. Haz commit y despliega.

Notas:

• El middleware se ejecuta antes de que exista la respuesta, así que los eventos informan de su estado HTTP como unknown. Es lo esperado; los insights de errores necesitan la instalación de Cloudflare o de servidor propio.
• En Vercel, la IP del visitante se toma de una cabecera que establece la plataforma y es fiable. Si autoalojas Next.js detrás de tu propio proxy, asegúrate de que la cabecera de IP reenviada que lee el fragmento la establece tu proxy y no llega tal cual desde el cliente.

Plugin de WordPress

Úsalo para cualquier sitio WordPress donde puedas instalar plugins.

1. En Rastreadores de IA → Instalar seguimiento, abre la pestaña WordPress y haz clic en Descargar plugin.
2. En el admin de WordPress, ve a Plugins → Añadir nuevo → Subir plugin, elige el zip descargado, haz clic en Instalar ahora y luego en Activar.
3. Ve a Ajustes → AI Crawler Tracker y rellena los tres campos:
   • Tracker base URL: https://app.citlyze.com
   • Key ID: tu ID de clave
   • Signing secret: tu secreto ctk_... El plugin no informa de nada hasta que rellenas la URL base.
4. Haz clic en Enviar evento de prueba. Deberías ver una confirmación de conexión; eso demuestra tus credenciales y la conectividad de extremo a extremo.

Advertencia: las cachés de página completa y las CDN pueden responder a las peticiones sin ejecutar WordPress, lo que infracuenta las visitas de rastreadores. Si tu sitio tiene mucha caché detrás de Cloudflare, prefiere la instalación del Worker de Cloudflare.

Servidor propio / Node

Úsalo para sitios a medida que alojas tú mismo: AWS, Google Cloud, Azure, un VPS o contenedores. El fragmento es un middleware estilo Express para Node 20 o más reciente (también corre en Bun y Deno).

1. En Rastreadores de IA → Instalar seguimiento, abre la pestaña Servidor propio / Node y copia el fragmento.
2. Guárdalo como aeo-tracker.mjs junto al punto de entrada de tu servidor.
3. Sustituye SITE_KEY_ID y ctk_SITE_KEY_SECRET por tu ID de clave y tu secreto de firma. Si tu equipo prefiere variables de entorno, léelas en las dos constantes al principio del archivo; lo importante es mantener el secreto fuera del control de versiones.
4. Registra el middleware antes de tus rutas:

   import { aeoCrawlerTracker } from "./aeo-tracker.mjs";
   app.use(aeoCrawlerTracker());

5. Si tu servidor está detrás de un balanceador de carga o un proxy inverso (nginx, ALB), configura Express para que confíe en él (por ejemplo app.set("trust proxy", 1)) de modo que el middleware informe de la IP real del cliente y no de la del proxy. La verificación de identidad de los rastreadores comprueba esa IP.
6. Despliega. El middleware informa después de que termina cada respuesta, así que no añade latencia e incluye los códigos de estado HTTP reales.

¿No usas Express? El handler devuelto recibe argumentos (req, res, next) normales y se adapta a Fastify, Koa o al servidor http de Node. Para otros lenguajes (Python, Go, PHP, Ruby, ...), implementa el protocolo de baliza firmada; es un único POST HTTPS firmado por cada petición coincidente.

Webflow

El hosting propio de Webflow no puede ejecutar código del lado del servidor, y los scripts del navegador no ven a los rastreadores de entrenamiento de IA, así que el seguimiento se instala en una capa de proxy delante de Webflow:

1. Webflow admite proxies inversos autogestionados en los planes Enterprise; acuérdalo con tu contacto de Webflow y enruta tu dominio a través de tu proxy (Cloudflare, CloudFront, Fastly o tu propio nginx).
2. Instala el tracker en esa capa de proxy:
   • Proxy en Cloudflare → sigue la guía del Worker de Cloudflare.
   • Tu propio proxy Node → sigue la guía de Servidor propio / Node.
   • Cualquier otra cosa → implementa el protocolo de baliza firmada en tu proxy.
3. Verifica como se describe más abajo.

Las apps de Webflow Cloud no sirven para seguir todo el sitio: solo atienden las peticiones bajo su ruta de montaje, así que nunca ven las visitas de rastreadores a tus páginas normales.

Shopify

Las tiendas Shopify estándar no pueden ejecutar este tracker: Shopify no permite a los comerciantes ejecutar código del lado del servidor en las peticiones de la tienda y no admite poner un proxy (como Cloudflare) delante de una tienda. Los scripts del navegador no son una alternativa: los rastreadores de entrenamiento de IA nunca ejecutan JavaScript, y un script de navegador expondría tu secreto de firma.

Qué puedes hacer:

• Las tiendas headless construidas con Hydrogen y alojadas en Oxygen (o cualquier montaje autoalojado) ejecutan código del lado del servidor; integra la lógica del fragmento de Servidor propio / Node en el manejador de peticiones del servidor de tu tienda.
• Para tiendas estándar, tus demás mediciones de Citlyze (seguimiento de prompts, citas, auditorías GEO) funcionan sin importar dónde esté alojada la tienda.

Verifica tu instalación

• En Rastreadores de IA → Instalar seguimiento, la tabla de claves de sitio tiene una columna Último evento. Se actualiza en cuanto tu instalación entrega su primer informe aceptado; cuentan tanto las visitas de rastreadores como los clics humanos desde respuestas de IA.
• Los usuarios de WordPress pueden confirmar la entrega de inmediato con Enviar evento de prueba (los eventos de prueba verifican credenciales y conectividad, pero no actualizan Último evento).
• Dale tiempo: en sitios con poco tráfico, la primera visita real de un rastreador puede tardar horas o unos pocos días. En cuanto llegan eventos, Rastreadores de IA → Analítica se rellena.
• Si no llega nada tras un par de días, vuelve a comprobar que el ID de clave y el secreto de firma de tu instalación corresponden a una clave activa (no revocada) y que tu ruta o middleware cubre todas las rutas de página.