Referencia
Solución de problemas
La mayoría de los problemas se ven en las herramientas de desarrollo del navegador en menos de un minuto. Empiece por el modo de depuración y busque su síntoma más abajo.
Empiece por el modo de depuración
Añada ?wm_debug=1 a la dirección de cualquier página, o data-debug="true" a la etiqueta, y abra la consola. El rastreador muestra cada lote que envía y, si se detiene, el motivo. En modo de depuración envía con fetch en lugar de sendBeacon, así que la respuesta del colector se ve en la pestaña Red.
Modo de depuraciónHTML
<script defer
src="https://cdn-stg.webmetric.io/v1/b.js"
data-key="wm_w_your_write_key"
data-host="https://in-stg.webmetric.io"
data-debug="true"></script>Síntomas y soluciones
| Síntoma | Causa | Solución |
|---|---|---|
Ninguna solicitud a /e | El script no se cargó, la etiqueta no tiene data-key, o el navegador envía Do Not Track o Global Privacy Control. | Busque en la consola un aviso sobre data-key y en la pestaña Red el archivo b.js. Pruebe con un navegador sin ninguna de las dos señales. |
b.js o /e falla con una solicitud bloqueada | Un bloqueador de anuncios o de contenido en ese navegador. | Pruebe con el bloqueador en pausa. Los visitantes que bloquean la analítica no se registran, y es su decisión. |
403 origin_not_allowed | La página no está en el dominio del proyecto ni en uno de sus subdominios. Es habitual con servidores de pruebas, vistas previas y direcciones de plataforma como myshopify.com o webflow.io. | Revise el dominio del proyecto en Configuración. Un sitio en otro dominio necesita su propio proyecto. |
401 unknown_key | La clave de escritura está mal escrita, revocada o pertenece a otro proyecto. | Vuelva a copiar la etiqueta del panel de instalación. |
410 project_deleted | El proyecto se eliminó. | Cree un proyecto y use su clave de escritura. |
402 quota_exceeded | Su organización ha usado sus eventos del mes y el margen de cortesía. | Cambie a un plan mayor en Plan y uso, o espere a que empiece el mes. Los datos ya recogidos se conservan. |
429 rate_limited | Demasiados eventos de un mismo proyecto en poco tiempo. | Suele ser código que llama a track() en un bucle. Busque llamadas repetidas. |
400 invalid_payload | Un lote no superó la validación. | Use la etiqueta del panel de instalación. Si usa el paquete npm, actualícelo. |
Las solicitudes responden 204 pero no aparece nada | El colector acepta y descarta las solicitudes de bots conocidos, de navegadores que envían Do Not Track o Global Privacy Control y de sus direcciones IP excluidas. Responde igual en todos los casos, para que un bot bloqueado no descubra nada. | Pruebe con un navegador normal, desde una dirección que no esté en su lista de exclusión. |
| La consola indica que se rechazó un script o una conexión | Su Content Security Policy bloquea la CDN o el colector. | Añada las dos fuentes como se indica en Content Security Policy. |
| La etiqueta está en la página pero faltan sus atributos data- | Un plugin de caché u optimización reescribió la etiqueta. | Excluya b.js de la combinación, la minificación y la carga diferida, y vacíe la caché. |
| Los eventos aparecen con unos segundos de retraso | Los eventos se envían por lotes cada cinco segundos, y cuando la página se oculta. | Espere unos segundos, o cambie de pestaña para enviar el lote. |
| No hay reproducciones de sesiones | La reproducción solo funciona en los planes que la incluyen, y no en páginas con data-replay="false", ni con data-replay="consent" antes del consentimiento. También se detiene al alcanzar el límite mensual de grabaciones. | Revise su plan y sus grabaciones en Plan y uso, y los atributos de la etiqueta. |
Qué dominios se aceptan
- El propio dominio del proyecto, por ejemplo example.com, y www.example.com.
- Cualquier subdominio, como shop.example.com o staging.example.com.
- localhost y 127.0.0.1, mientras Aceptar eventos de localhost esté activado en la configuración del proyecto. Lo está en un proyecto nuevo. El tráfico local cuenta en su uso, así que desactívelo cuando el sitio esté publicado.
- Los otros hosts permitidos en la configuración del proyecto: un host exacto como partner.example.org, o *.example.net para todos los subdominios de example.net. Un comodín no incluye example.net.
- Todo lo demás se rechaza con
origin_not_allowed, incluido otro dominio de nivel superior como example.co.uk.
Pasar el colector por un proxy
No se admite enviar los eventos a través de un proxy en su propio servidor. El colector vería la dirección de su servidor para cada visitante, lo que mezcla a los visitantes y oculta su país.
Si sigue sin funcionar
Con la sesión iniciada, envíenos un mensaje desde el panel. Incluye por usted su organización, su plan y su proyecto, así que describa lo que esperaba y lo que pasó en su lugar.