Solución de Problemas
Problemas comunes y sus soluciones al trabajar con VisitorFilters.
El Script No Recopila Eventos
Síntoma
El panel de control no muestra eventos después de instalar el script colector.
Soluciones
- Verifique que el script se esté cargando: Abra las DevTools del navegador → pestaña Red → filtre por "vf.js". Debería ver una respuesta 200.
- Compruebe el ID del sitio: Asegúrese de que
data-sitecoincida con su ID de sitio real del panel de control. - Bloqueo por CSP: Revise la consola del navegador para detectar violaciones de la Política de Seguridad de Contenido. Agregue nuestro dominio a sus directivas CSP.
- Bloqueadores de anuncios: Algunos bloqueadores de anuncios pueden interceptar nuestro script. Pruebe en una ventana de incógnito con las extensiones desactivadas.
- Verificación del dominio: El sitio debe estar verificado antes de que los eventos se procesen. Revise Sitios → Estado.
Las Reglas No Se Activan
Síntoma
Ha creado una regla pero no parece estar siendo aplicada.
Soluciones
- Compruebe la prioridad: Una regla Permitir de mayor prioridad puede estar coincidiendo antes que su regla de bloqueo.
- La regla está desactivada: Asegúrese de que el estado de la regla sea Activo.
- Condición no coincidente: Verifique la configuración de su condición. Use el Probador de Reglas en el panel de control para simular.
- Respuesta en caché: Si está probando usted mismo, su navegador puede estar sirviendo una página en caché. Borre la caché o use incógnito.
Alto Uso de Cuota
Síntoma
Su cuota mensual de eventos se está agotando más rápido de lo esperado.
Soluciones
- Tráfico de bots: Los bots también generan eventos. Agregue reglas de bloqueo de bots para reducir el consumo innecesario de eventos.
- Modo SPA: Si
data-spa="true"está configurado, cada cambio de ruta cuenta como un evento. Use esto solo para SPAs genuinas. - Múltiples instancias del script: Verifique que el script solo se incluya una vez por página (compruebe inclusiones duplicadas en diseños/parciales).
Fallos en la Entrega de Webhooks
Síntoma
Las entregas de webhooks aparecen como fallidas en el panel de control.
Soluciones
- Endpoint inaccesible: Asegúrese de que su servidor sea accesible públicamente y responda a solicitudes POST HTTPS.
- Tiempo de espera: Su endpoint debe responder en 10 segundos. Procese los webhooks de forma asíncrona.
- Respuesta no 2xx: Su endpoint debe devolver un código de estado 200-299 para confirmar la recepción.
- Certificado SSL: Asegúrese de que su endpoint tenga un certificado SSL válido (los certificados autofirmados son rechazados).
Problemas de Inicio de Sesión / Cuenta
- No puede iniciar sesión: Use el flujo de restablecimiento de contraseña. Si el correo electrónico no llega, revise la carpeta de spam.
- Bloqueado por 2FA: Use un código de recuperación. Si ha perdido los códigos de recuperación, contacte al soporte.
- Verificación de correo pendiente: Haga clic en "Reenviar verificación" en la pantalla de verificación. Revise la carpeta de spam.
¿Necesita Más Ayuda?
Si su problema no está cubierto aquí:
- Use el formulario de Comentarios en su panel de control para reportar errores o solicitar funciones
- Revise la página de Estado para cualquier incidente en curso