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 se descartan, incluidos los que se hacen pasar por un navegador corriente (un navegador real siempre anuncia su idioma, y un bot que copia su identidad casi nunca lo hace); los visitantes de un mismo hogar u 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 envío es rechazado (diagnóstico de red)

El endpoint siempre responde, pero el estado indica por qué un envío 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 envíos 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 eventos 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.

Leer el panel

La franja en tiempo real es compacta y enlaza a su pantalla detallada. Visitantes, páginas vistas y sesiones conservan sus minigráficos; rebote, duración y eventos usan las mismas tarjetas Filament, con fondos, contornos y tipografía coherentes. El gráfico de audiencia aparece antes del diagnóstico de recopilación.

Los rechazos registrados y los envíos fuera de cuota siguen visibles con el diagnóstico plegado. Solo el exceso de cuota recibe un color de atención: el filtrado normal no se presenta como un incidente.

Una distribución con una sola categoría muestra su etiqueta, el 100 % y su volumen, sin un gran anillo. Los gráficos se mantienen cuando hay varias categorías.

Encontrar los errores 404

La tabla «Páginas no encontradas (404)» muestra las diez rutas más señaladas, sus ocurrencias y la diferencia en eventos frente al período anterior. Sigue las fechas y filtros del panel; desactivar la comparación oculta las diferencias.

Lee eventos llamados 404, agrupados por la ruta normalizada de su URL, dentro del historial conservado. No tener resultados no garantiza que no haya errores: hay que activar el seguimiento y los datos eliminados no se reconstruyen. «Nuevo» indica que no se conserva ningún evento del período anterior.

Para completar esta tabla, elija un solo método en cada página de error:

• Laravel: QUIET_METRICS_TRACK_404=true con el puente 0.4.0.
• Symfony: track_404: true con el bundle 0.4.0.
• WordPress: activar «Pages introuvables» en modo servidor, desde 0.4.0.
• Script JavaScript: data-404="true" solo en el script de la plantilla 404.

El evento se añade a la página vista y consume cuota. Una página HTML 404 puede contarse como página vista sin aparecer en esta tabla si el evento independiente está desactivado. La ruta procede de la URL del evento, no de su propiedad personalizada path.