🛡️ Bot Shield

¿Qué es?

Un script JavaScript que se instala en la web del cliente y detecta si el visitante es un bot o tráfico fraudulento. Los bots hacen clic en anuncios de Google Ads sin intención real de compra, desperdiciando presupuesto.

¿Cómo funciona?

¿Qué señales detecta?

Señal	¿Qué mide?	Bot típico
WebDriver	Si el navegador está automatizado (Selenium, Puppeteer)	Automático
Canvas / WebGL	Fingerprint del navegador — bots usan headless sin GPU real	Sin GPU
Movimiento ratón	Humanos mueven el ratón irregularmente, bots no	Sin movimiento
Interacción táctil	Scroll, clics, tiempo en página	0 interacciones
Resolución / Idioma	Dimensiones atípicas, idioma que no corresponde al país	800×600
GeoIP	El servidor detecta el país de la IP	VPN / Datacenter
UTMs	Captura gclid, utm_source, utm_campaign, etc.	Contexto de campaña

Resultado: Bot Score

Cada visita recibe un score de 0 a 100:

Score	Clasificación	Acción
0 – 39	Humano legítimo	No se hace nada
40 – 69	Sospechoso	Se registra para análisis
70 – 100	Bot / tráfico fraudulento	Se registra + alerta en dashboard

¿Dónde se ven los datos?

• Dashboard: Sección "🛡️ Bot Shield" → tabla con todas las visitas, filtrable por site, campaña, fuente, etc.
• Google Sheets: Las visitas de bots se envían automáticamente a un Sheet compartido (configurable por cliente).
• Mapa de calor: Visualización geográfica de dónde vienen los bots.

Instalación del script

El script se instala en la web del cliente con una sola línea antes del cierre de </body>:

El data-site-id se obtiene al crear el site en el dashboard.

¿Qué es?

Un sistema que analiza los search terms (términos de búsqueda reales) de Google Ads y detecta automáticamente cuáles deberían ser keywords negativas para no desperdiciar presupuesto en clics irrelevantes.

Flujo completo

Paso 1: Subir el CSV

1. En Google Ads, ve a Campañas → Insights → Search Terms
2. Filtra por las campañas que quieras analizar
3. Descarga en formato CSV
4. En el Dashboard, sección "🧠 Negativas IA":
   • Selecciona el cliente en el dropdown
   • Arrastra o selecciona el CSV

Paso 2: La IA clasifica

El sistema envía los términos a la IA (OpenAI) junto con el perfil del cliente (marca, productos, audiencia). La IA clasifica cada término en una de tres categorías:

Veredicto IA	Significado	Ejemplo
🚫 NEGATIVE	Irrelevante para el cliente, debería bloquearse	"venta de coches usados" para un concesionario de nuevos
✅ KEEP	Relevante, hay que mantenerlo activo	"comprar skoda octavia nuevo"
⚠️ REVIEW	La IA no está segura, necesita revisión humana	"skoda opiniones" (puede ser intención de compra o solo curiosidad)

Cada veredicto viene con un porcentaje de confianza (0–100%). A mayor confianza, más segura está la IA.

Paso 3: Revisión humana

La tabla muestra todos los términos clasificados. Puedes:

Acción	Botón	¿Qué hace?
Negativizar	🚫 Negativizar	Confirma que este término debe ser keyword negativa → se incluirá en la exportación para Google Ads
Mantener	✅ Mantener	Este término es relevante, no lo toques → NO se incluirá como negativa
Auto-negativizar	🚫 Auto-negativizar IA ≥80%	Negativiza automáticamente todos los que la IA marcó como NEGATIVE con confianza ≥80%

Atajos de teclado

Tecla	Acción
A	Negativizar los seleccionados
R	Mantener los seleccionados

Paso 4: Exportar negativas

1. Haz clic en "⬇ CSV Negativas" arriba de la tabla
2. Se descarga un CSV con formato [keyword] (concordancia exacta)
3. En Google Ads:
   • Ve a Herramientas → Listas de palabras clave negativas
   • Crea o edita una lista
   • Importa el CSV descargado

Bot Detector

¿El script ralentiza la web?

No. El script se carga de forma asíncrona, pesa menos de 5KB y se ejecuta después del page load. No bloquea el renderizado ni afecta a Core Web Vitals.

¿Bloquea bots automáticamente?

No, actualmente solo detecta y registra. No bloquea tráfico. El objetivo es dar visibilidad al equipo de paid para tomar decisiones (p.ej. excluir IPs en Google Ads).

¿Cada cuánto se actualizan los datos?

En tiempo real. Cada visita se registra al instante. El dashboard se refresca automáticamente cada 60 segundos.

Negativizador IA

¿Puedo subir el mismo CSV dos veces?

Sí. El sistema detecta duplicados por search_term + campaign + ad_group y no crea entradas repetidas.

¿Puedo cambiar de opinión después de negativizar?

Sí. Puedes seleccionar el término y cambiarlo a "Mantener" en cualquier momento, siempre que no lo hayas subido ya a Google Ads.

¿Cómo sé si la IA está acertando?

Fíjate en el porcentaje de confianza: términos con >80% de confianza suelen acertar. Si ves que se equivoca en un patrón concreto, podemos ajustar el perfil del cliente (productos, términos protegidos, etc).

¿Qué pasa con los "protected terms"?

En el perfil del cliente puedes configurar términos protegidos — la IA nunca sugerirá negativizarlos. Ejemplo: si el cliente vende "Skoda", puedes proteger "skoda" para que nunca lo marque como negativo.

¿El sistema sube las negativas directamente a Google Ads?

No, actualmente no. El flujo es manual: exportas el CSV y lo importas tú en Google Ads. Esto es intencional para que el equipo de paid tenga control total antes de aplicar cambios.