Plugin de WordPress

El plugin oficial de Quiet Metrics conecta su sitio WordPress sin tocar código: script first-party, tracking del lado del servidor imbloqueable, o ambos.

Instalación

Durante la beta privada, el plugin se entrega como .zip previa solicitud al soporte (Dato de contacto protegido: active JavaScript para mostrarlo), al no estar todavía publicado en el directorio de WordPress.org: Plugins → Añadir nuevo → Subir plugin, actívelo y abra Ajustes → Quiet Metrics. (La publicación en el directorio de WordPress.org llegará con la apertura pública; las actualizaciones se hacen reinstalando el .zip encima, los ajustes se conservan.)

Elegir el modo

Script (first-party). El archivo qm.js es una copia local servida por su propio sitio, y los hits pasarían por la REST API de su sitio (/wp-json/quiet-metrics/v1/collect) antes de ser retransmitidos al servicio. Ningún dominio de terceros en el navegador: las listas de bloqueo por dominio son inoperantes. Este modo todavía no está disponible: su retransmisión pasa por su servidor y exigiría una firma del sitio que aún no está implementada, sea cual sea la clave secreta introducida. Por ahora no se mide ninguna visita con este modo, y un mensaje se lo indica en la administración de WordPress. Esto se corregirá con la publicación del plugin; use el modo servidor mientras tanto (ver más abajo).

Servidor (imbloqueable). Las páginas vistas se envían por PHP al final de la petición, sin JavaScript: invisible para los bloqueadores de publicidad. Introduzca la clave secreta: sin ella, todos sus visitantes se contarían con la IP de su servidor (¡un solo visitante!).

Ambos. El script sigue las navegaciones finas (SPA, temas muy dinámicos) y el servidor recupera a los visitantes que bloquean el JS. Sin doble conteo: el servicio deduplica las páginas vistas idénticas (misma página, mismo visitante) recibidas con menos de 2 segundos de diferencia.

Casos particulares

Caché de página completa (WP Rocket, WP Super Cache, Varnish, Cloudflare APO…). En modo servidor, el PHP no se ejecuta en las páginas servidas desde la caché: esas visitas no se cuentan. Con una caché de página completa, use el modo script (o ambos): el JS se ejecuta en el navegador del visitante, con o sin caché.

Plugins de seguridad que restringen la REST API. El modo script retransmite los hits mediante POST /wp-json/quiet-metrics/v1/collect: esta ruta pública debe permanecer accesible (añada el namespace quiet-metrics/v1 a la lista blanca de su plugin de seguridad). Síntoma de un bloqueo: errores 401/403 en esta ruta en la pestaña Red del navegador.

Multisitio. Los ajustes son propios de cada sitio de la red. Cree un sitio (y una clave) de Quiet Metrics por cada sitio WordPress para obtener estadísticas separadas.

Cuentas conectadas. Los roles marcados en los ajustes nunca se cuentan, ni del lado del script (el archivo no se inyecta) ni del lado del servidor.

Exclusión a petición del visitante. Quien cargue cualquier página de su sitio con ?qm_ignore=1 deja de ser contado, y ?qm_ignore=0 lo devuelve a la medición. El plugin se encarga de ello sin ningún ajuste que tocar, en los tres modos de recogida: vea el marcador de exclusión. Esto no sustituye a los roles y las rutas excluidas: aquellos pertenecen al administrador, el marcador pertenece al visitante.

Eventos personalizados

Del lado del navegador (modo script activo):

<script>qm('registro', { plan: 'pro' });</script>

Del lado PHP (tema, hook, en cualquier lugar después de la carga de los plugins):

quiet_metrics_event( 'compra', array( 'importe' => 49 ) );

Ejemplo con WooCommerce para contar los pedidos confirmados:

add_action( 'woocommerce_thankyou', function ( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( $order ) {
        quiet_metrics_event( 'compra', array(
            'importe' => (float) $order->get_total(),
            'articulos' => $order->get_item_count(),
        ) );
    }
} );

El envío PHP es no bloqueante y silencioso en caso de fallo: la analítica nunca rompe su tienda. Para contar una conversión, cree el objetivo compra (tipo evento) en el panel.