Solución de problemas

Las situaciones más frecuentes, del síntoma a la causa. Regla de oro de la plataforma: la recogida nunca devuelve un error visible a sus visitantes; los rechazos son silenciosos del lado de la página, pero siempre diagnosticables aquí.

No aparece ningún dato

En orden:

1. La clave. ¿El data-site (o la clave del SDK/plugin) corresponde exactamente a la clave de la pantalla de instalación? Una clave desconocida → 403 silencioso.
2. ¿Se carga el script? Pestaña Red del navegador: qm.js en 200 y luego un POST …/collect en 202 cuando usted navega. ¿No hay ninguna petición? Compruebe defer, la inclusión del script y window.__qmDisable.
3. CSP. Una Content-Security-Policy estricta bloquea la carga o el POST; consulte las directivas script-src / connect-src en Instalación.
4. Autoexclusión. Ha activado la autoexclusión del propietario, ha marcado su rol en el plugin de WordPress, o ha colocado el marcador de exclusión visitando el sitio con ?qm_ignore=1: sus propias visitas no cuentan. Pruebe en navegación privada o desde otro dispositivo, y vea la sección siguiente.
5. La pantalla de instalación verifica la recepción en directo: manténgala abierta durante la prueba.

No me veo en mis propias estadísticas

Sus propias visitas pueden quedar descartadas por tres mecanismos distintos, y ninguno de ellos se anuncia:

1. El marcador de exclusión. Ha cargado una página del sitio con ?qm_ignore=1: este navegador ya no se cuenta en este sitio, durante cinco años. Vuelva a cargar cualquier página con ?qm_ignore=0, desde el mismo navegador, para volver a la medición. Como el marcador nunca se transmite, la plataforma ignora que existe: no puede avisarle, y solo usted puede retirarlo.
2. La autoexclusión del propietario activada en el panel, o su rol marcado en el plugin de WordPress.
3. window.__qmDisable = true definido por una extensión, un entorno de preproducción o la consola.

Si ninguno de los tres se aplica, la causa está en otra parte: repase la lista anterior, donde una clave ausente o equivocada sigue siendo la más frecuente.

Mis cifras difieren de Google Analytics

Es lo esperado. Las definiciones difieren, en ambos sentidos:

• Puede ver más: el seguimiento de servidor reduce el efecto de los bloqueadores y las reglas de carga pueden diferir de GA; compare únicamente ámbitos sujetos a las mismas elecciones de consentimiento.
• Verá menos: los bots conocidos se descartan; los visitantes de un mismo hogar/oficina detrás de una misma IP y un mismo navegador se fusionan.
• Los únicos de varios días están sobreestimados: sin identificador persistente (ese es el principio), un visitante que vuelve otro día cuenta de nuevo. Exacto a escala diaria, estándar de la categoría.
• Las sesiones expiran tras 30 minutos de inactividad, y la duración de la última página de una sesión es desconocida.

Detalle completo: la página pública « Cómo contamos ».

El hit es rechazado (diagnóstico de red)

El endpoint siempre responde, pero el estado indica por qué un hit no cuenta:

El píxel p.gif siempre responde 200; su estado real está en la cabecera X-QM-Status.

Firma inválida en modo firmado

La firma HMAC se rechaza si la marca de tiempo se desvía más de ±5 minutos (anti-replay). Causa n.º 1: el reloj del servidor emisor (contenedor, VM congelada). Sincronice mediante NTP. Compruebe también que la clave secreta utilizada es la del sitio correcto, y regenérela si se ha filtrado.

Periodo de prueba expirado o cuota superada

• Periodo de prueba expirado: los hits se aceptan (202) pero se cuentan como dropped, visibles como tales en el panel, no en sus estadísticas. Pase a un plan para reanudar el conteo.
• Cuota mensual: zona de gracia hasta ×1,2 del plan, correos de alerta al 80 % y al 100 %. Más allá de la gracia, nada se pierde en silencio durante el mes en curso: la limitación solo se activa tras dos meses consecutivos de exceso, se anuncia, y los hits que dejan de analizarse siguen contándose y mostrándose.

Duplicados o páginas vistas de más

• Script incluido dos veces (layout + bundler): sin consecuencias, el tracker se bloquea (window.__qmLoaded).
• SPA: una navegación hacia la misma URL no emite un duplicado; el seguimiento pushState se desactiva con data-spa="false".
• WordPress modo « ambos »: las páginas vistas idénticas recibidas con menos de 2 s de diferencia se deduplican del lado del servicio.
• Recargas reales (F5): son páginas vistas legítimas; GA también las cuenta.

Un evento no aparece en las conversiones

Un objetivo de tipo evento coincide con el nombre exacto (compra ≠ Compra). Un objetivo de tipo página coincide con la ruta con comodines (/gracias, /docs/*). Compruebe también los límites: nombre ≤ 120 caracteres, ≤ 30 propiedades; más allá, se trunca.

El evento en sí aparece en el panel de Eventos desde el primer envío; la conversión solo aparece si el objetivo existe (créelo antes de su prueba, o vuelva a probar tras crearlo).

Tráfico de desarrollo o de staging en las estadísticas

Cuatro medidas, acumulables: una clave separada para el staging (o ninguna clave: sin clave, no se envía nada), las rutas excluidas en los ajustes del sitio, window.__qmDisable = true definido por el entorno, y el marcador de exclusión colocado una vez por navegador (?qm_ignore=1). Del lado de WordPress, los roles de administrador/editor están excluidos por defecto.