Analytics

Les analytics vanityURLs s’exécutent dans le Cloudflare Worker. Elles ne demandent pas de JavaScript de tracking navigateur, de cookies ou de compte visiteur.

Cloudflare Web Analytics et Real User Measurement (RUM) ne font pas partie du baseline vanityURLs. Gardez Cloudflare RUM désactive sauf si un opérateur veut explicitement de la telémetrie navigateur en dehors du modèle d’événements serveur du redirecteur.

Le Worker envoie les analytics avec ctx.waitUntil().¹ Les redirections et les pages devraient continuer à répondre même si le fournisseur analytics est lent ou indisponible.

Les limites fournisseur dépendent du compte et du produit. Vérifiez la documentation courante du fournisseur et le plan lié à l’instance avant d’activer une collecte à fort volume.

Le Worker utilise les endpoints de collecte pour les analytics runtime. Traitez les clés API de gestion, API de reporting, scripts helper et événements de collecte comme des chemins séparés avec leurs propres limites et identifiants.

Références : documentation API Fathom, documentation Umami sending stats, et documentation API-key Umami Cloud.

Champs de configuration

Configurez les analytics avec des variables Worker dans wrangler.toml et des secrets Worker lorsqu’un script helper a besoin d’un jeton API.

Événements

Les pages de consultation localisées utilisent ces chemins publics :

Les probes reconnues par la blocklist runtime retournent un 404 simple avant les analytics. Les probes PHP et WordPress courantes ne devraient pas polluer les métriques de miss.

Les requêtes bloquées par Cloudflare avant le Worker n’émettent pas d’événements analytics vanityURLs. Utilisez Cloudflare Security Events et Cloudflare analytics pour le trafic bloqué par Access, WAF, rate limiting, contrôles bot, contrôles crawler, DNS ou politique TLS.

Les surfaces analytics Cloudflare sont des outils de référence, pas des prérequis de configuration :

• Security Events : trafic bloque avant le Worker par WAF, rate limiting, Access, contrôles bot ou AI Crawl Control
• Workers analytics : volume de requêtes d’infrastructure, erreurs, temps CPU, wall time et duree
• DNS Analytics : diagnostics DNS pendant une enquété de routage ou de delegation
• Web Analytics / RUM : désactive par défaut et non prevu dans le baseline

Payload Umami

Umami reçoit les pageviews comme pageviews natives. Les redirections, misses, consultations et bots normalisés sont envoyés comme événements nommés avec des données structurées.

Les payloads Umami incluent :

• identifiant du site
• URL demandée
• referrer
• premier tag de langue depuis Accept-Language
• user agent visiteur ou user agent de remplacement pour bot
• IP visiteur selon UMAMI_GEO_IP_MODE

Les données d’événements non-pageview peuvent inclure :

• type d’événement
• slug
• hostname cible
• état de cycle de vie effectif
• libellé de planification
• statut de redirection
• erreur de redirection ou résultat de consultation, lorsque présent
• pays et colo depuis les métadonnées Cloudflare
• correlation ID
• chemin et query demandés
• famille bot, lorsque détectée

Payload Fathom

Fathom reçoit des requêtes de collecte natives depuis le Worker. Les pageviews sont envoyées comme pageviews; les redirections, misses, consultations et bots sont envoyés comme événements Fathom nommés.

Les champs de requête Fathom incluent :

• identifiant du site
• origine de page
• chemin de page
• referrer
• certains paramètres query et campagne
• client ID généré pour la requête de collecte
• nom d’événement pour les événements non-pageview
• payload d’événement pour les événements non-pageview

Les payloads d’événement Fathom peuvent inclure :

• type d’événement
• slug
• hostname cible
• état de cycle de vie effectif
• libellé de planification
• statut de redirection
• erreur de redirection ou résultat de consultation, lorsque présent
• pays et colo depuis les métadonnées Cloudflare
• correlation ID
• chemin et query demandés

Mode IP

UMAMI_GEO_IP_MODE contrôle si le Worker transmet CF-Connecting-IP à Umami.

La collecte Fathom ne demande pas de transmettre CF-Connecting-IP depuis le Worker. Le Worker envoie les requêtes Fathom natives avec le user agent visiteur lorsque c’est prudent, et utilise un user agent générique Worker pour le trafic bot connu.