Installez Webful en toute tranquilité

Guide complet pour installer et utiliser Webful sur votre site

📚 Table des matières

1. Introduction

Webful est une solution d'analyse de trafic ultra-légère et respectueuse de la vie privée. Cette documentation vous guidera pas-à-pas pour installer Webful sur votre site web.

✨ Avant de commencer

  • Assurez-vous d'avoir créé un compte Webful
  • Identifiez votre type de site : WordPress ou site classique (HTML/PHP)
  • Prévoyez 5 minutes pour l'installation

Deux méthodes d'installation

🔌

Plugin WordPress

Installation automatique en 3 clics. Parfait pour les sites WordPress.

→ Voir le guide
💻

Code de tracking

Copier-coller un code dans votre site. Pour les sites HTML/PHP.

→ Voir le guide

2. Installation sur WordPress

⚠️ TRÈS IMPORTANT pour WordPress

❌ NE COPIEZ PAS le code de tracking HTML directement dans WordPress

WordPress bloque le JavaScript pour des raisons de sécurité. Si vous collez le code HTML dans un widget, dans l'éditeur de thème ou via un champ personnalisé, il ne fonctionnera pas.

✅ Solution : Utilisez le plugin officiel

Le plugin contourne les filtres de sécurité WordPress en injectant le code directement via wp_head(). C'est la seule méthode qui fonctionne pour WordPress.

1

Télécharger le plugin

Téléchargez le plugin Webful Analytics pour WordPress :

📥 Télécharger le plugin WordPress

💡 Note : Le fichier téléchargé s'appelle Webful-wordpress-plugin.zip. Ne le décompressez pas, WordPress le fera automatiquement.

2

Installer le plugin dans WordPress

  1. a.

    Connectez-vous à votre administration WordPress

    Connexion WordPress

    Screenshot : wp-step1-login.webp (capture de l'écran de connexion WordPress)

  2. b.

    Dans le menu de gauche, allez dans Extensions → Ajouter

    Menu Extensions

    Screenshot : wp-step2-menu-extensions.webp

  3. c.

    Cliquez sur le bouton Téléverser une extension en haut de la page

    Téléverser une extension

    Screenshot : wp-step3-telecharger-extension.webp

  4. d.

    Cliquez sur Choisir un fichier et sélectionnez le fichier Webful-wordpress-plugin.zip

    Choisir le fichier

    Screenshot : wp-step4-choisir-fichier.webp

  5. e.

    Cliquez sur Installer maintenant

    WordPress va télécharger et installer le plugin automatiquement.

  6. f.

    Une fois l'installation terminée, cliquez sur Activer l'extension

    Activer le plugin

    Screenshot : wp-step5-activer.webp

✅ Le plugin est maintenant installé et activé !

3

Connecter votre site à Webful

  1. a.

    Dans le menu de gauche de WordPress, cliquez sur Webful

    Menu Webful

    Screenshot : wp-step6-menu-webful.webp

  2. b.

    Entrez vos identifiants Webful :

    • Email : votre email Webful
    • Mot de passe : votre mot de passe Webful
    Formulaire de connexion

    Screenshot : wp-step7-formulaire-connexion.webp

  3. c.

    Cliquez sur Connecter mon site

    Le plugin va automatiquement enregistrer votre site WordPress dans votre compte Webful.

  4. d.

    Vous verrez s'afficher le statut ✓ Connecté

    Site connecté

    Screenshot : wp-step8-connecte.webp (statut connecté + quota + paramètres)

🎉 Félicitations ! Votre site WordPress est maintenant connecté à Webful !

Le tracking est automatiquement activé sur toutes les pages de votre site.

🔧 Problème connu : Cloudflare Rocket Loader

Votre site utilise Cloudflare Rocket Loader ?

Si votre site passe par Cloudflare avec l'option Rocket Loader activée, le tracking Webful peut ne pas fonctionner correctement (0 activités affichées).

🔍 Comment détecter le problème ?

Affichez le code source de votre page (clic droit → "Afficher le code source") et recherchez le script Webful :

<!-- ❌ SI VOUS VOYEZ CECI, C'EST LE PROBLÈME : -->

<script src="https://webful.fr/tracking/webful-track.js"

data-api-key="..."

data-base-url="https://webful.fr"

type="ecdf2855a0ad2e30a525e5a5-text/javascript"></script>

Si le type contient un code aléatoire au lieu de simplement "text/javascript", c'est que Cloudflare Rocket Loader modifie le script.

✅ Solution 1 : Exclure Webful de Rocket Loader (Recommandé)

Modifiez le fichier du plugin WordPress pour ajouter l'attribut data-cfasync="false" :

  1. Connectez-vous à votre FTP ou au gestionnaire de fichiers de votre hébergeur
  2. Allez dans /wp-content/plugins/webful/webful.php
  3. Trouvez la ligne qui ajoute le script (fonction webful_tracking_code())
  4. Ajoutez data-cfasync="false" dans la balise script :

<script src="https://webful.fr/tracking/webful-track.js"

data-api-key="<?= esc_attr($api_key) ?>"

data-base-url="https://webful.fr"

data-cfasync="false"></script>

✅ Cet attribut indique à Cloudflare de ne pas modifier ce script spécifique.

✅ Solution 2 : Désactiver Rocket Loader (Alternative)

Si la Solution 1 ne fonctionne pas, vous pouvez désactiver complètement Rocket Loader :

  1. Connectez-vous à votre compte Cloudflare
  2. Sélectionnez votre domaine
  3. Allez dans Speed → Optimization
  4. Désactivez Rocket Loader

ℹ️ Note : Rocket Loader est censé accélérer le chargement JavaScript, mais peut causer des problèmes de compatibilité avec certains scripts. La plupart des sites modernes n'en ont plus besoin.

🧪 Vérifier que ça fonctionne

  1. Videz le cache Cloudflare (dans votre panneau Cloudflare → Caching → Purge Everything)
  2. Videz le cache de votre navigateur (Ctrl+F5 ou Cmd+Shift+R)
  3. Affichez le code source de votre page et vérifiez que le script a maintenant data-cfasync="false"
  4. Attendez 5 minutes et consultez vos statistiques Webful

⚙️ Paramètres optionnels

Dans la page de configuration du plugin, vous pouvez personnaliser le comportement :

Ne pas tracker les administrateurs connectés

Vos propres visites ne seront pas comptabilisées (recommandé)

Pages à exclure du tracking

Excluez certaines pages (ex: /merci, /confirmation)

3. Installation sur un site classique

📌 Cette méthode est pour les sites HTML, PHP, ou tout site non-WordPress.
Si vous avez un site WordPress, utilisez plutôt le plugin WordPress.

1

Ajouter votre site dans Webful

  1. a.

    Connectez-vous à votre dashboard Webful

  2. b.

    Allez dans Mes sites

    Menu Mes sites

    Screenshot : classic-step1-mes-sites.webp

  3. c.

    Cliquez sur + Ajouter un site

    Bouton ajouter un site

    Screenshot : classic-step2-ajouter-site.webp

  4. d.

    Remplissez le formulaire :

    • Nom du site : un nom pour identifier votre site (ex: "Mon Blog")
    • URL du site : l'adresse complète de votre site (ex: https://monsite.com)
    Formulaire d'ajout de site

    Screenshot : classic-step3-formulaire.webp

  5. e.

    Cliquez sur Créer le site

    Webful va générer automatiquement un code de tracking unique pour votre site.

2

Copier le code de tracking

  1. a.

    Une fois le site créé, vous verrez le code de tracking s'afficher

    Code de tracking

    Screenshot : classic-step4-code-tracking.webp

  2. b.

    Cliquez sur le bouton Copier le code

    Le code ressemble à ceci :

    <script src="https://webful.fr/tracking/Webful-track.js" data-api-key="VOTRE_CLE_API_UNIQUE"></script>
3

Installer le code sur votre site

Collez le code de tracking dans la section <head> de toutes les pages de votre site :

<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Ma Page</title> <!-- Code de tracking Webful --> <script src="https://webful.fr/tracking/Webful-track.js" data-api-key="VOTRE_CLE_API"></script> </head> <body> <!-- Contenu de votre page --> </body> </html>

⚠️ Important :

  • Placez le code dans le <head>, pas dans le <body>
  • Le code doit être présent sur toutes les pages que vous souhaitez tracker
  • Si vous utilisez un template/header commun, ajoutez-le une seule fois dans ce fichier

💡 Astuce :

Si votre site utilise un fichier header.php ou header.html partagé par toutes les pages, ajoutez le code une seule fois dans ce fichier. Il sera automatiquement présent sur toutes les pages !

✅ Le tracking est maintenant installé sur votre site !

4. Vérifier que ça fonctionne

Une fois le tracking installé (WordPress ou site classique), vérifiez que tout fonctionne correctement :

1️⃣

Visitez votre site

Ouvrez votre site dans un navigateur de navigation privée (pour ne pas être bloqué si vous avez activé "Ne pas tracker les admins")

2️⃣

Naviguez sur 2-3 pages

Cliquez sur plusieurs pages de votre site pour générer des visites

3️⃣

Vérifiez le dashboard Webful

Connectez-vous à votre dashboard Webful

Dashboard avec statistiques

Screenshot : verif-step1-dashboard.webp (dashboard montrant des stats)

Vous devriez voir vos visites apparaître dans les statistiques ! 📊

✅ Tout fonctionne parfaitement !

Vous pouvez maintenant suivre toutes vos statistiques en temps réel depuis votre dashboard Webful.

❓ Les statistiques n'apparaissent pas ?

Consultez la section Questions fréquentes ci-dessous.

5. Questions fréquentes

❓ Les statistiques n'apparaissent pas dans mon dashboard

Vérifiez les points suivants :

  • Le code est-il installé ? Affichez le code source de votre page (Clic droit > Code source) et recherchez "Webful"
  • Attendez quelques secondes : les données sont envoyées quand vous quittez la page ou après 30 secondes
  • Navigation privée : utilisez un navigateur en mode navigation privée pour tester
  • Bloqueurs de pub : certains bloqueurs peuvent bloquer le tracking, désactivez-les temporairement
  • Cache du navigateur : videz le cache et rechargez la page (Ctrl+Shift+R ou Cmd+Shift+R)
❓ Le plugin WordPress ralentit-il mon site ?

Non ! Le script de tracking Webful fait moins de 1 Ko et est chargé de manière asynchrone.

Il n'a aucun impact perceptible sur la vitesse de chargement de votre site.

❓ J'ai une erreur "Content Security Policy" dans la console

Qu'est-ce que c'est ?

La Content Security Policy (CSP) est une politique de sécurité qui contrôle quelles sources externes peuvent charger des scripts sur votre site.

Solution :

Vous devez autoriser https://webful.fr dans votre CSP.

Dans votre fichier PHP (index.php, header.php...) :

header("Content-Security-Policy: script-src 'self' ... https://webful.fr; connect-src 'self' ... https://webful.fr; ");

Ou dans une balise <meta> HTML :

<meta http-equiv="Content-Security-Policy" content="script-src 'self' https://webful.fr; connect-src 'self' https://webful.fr;">

⚠️ Important : Ajoutez https://webful.fr dans deux directives :

  • script-src : pour charger le script de tracking
  • connect-src : pour envoyer les données analytics
❓ Mes propres visites sont-elles comptabilisées dans les statistiques ?

Non, vos visites ne sont PAS comptabilisées si vous êtes connecté à Webful !

✅ Protection automatique activée

Lorsque vous êtes connecté à votre compte Webful et que vous visitez votre propre site, vos visites ne sont pas enregistrées dans les statistiques. Cela garantit des données précises et représentatives de vos vrais visiteurs.

⚠️ Important : Comment tester le tracking sans fausser vos statistiques

Si vous souhaitez tester que le tracking fonctionne correctement sur votre site, vous devez :

  • Option 1 : Utiliser un autre navigateur (si vous êtes connecté sur Chrome, testez avec Firefox ou Safari)
  • Option 2 : Utiliser une fenêtre de navigation privée (Ctrl+Shift+N sur Chrome/Edge, Cmd+Shift+N sur Safari)
  • Option 3 : Vous déconnecter de Webful avant de tester

💡 Astuce : La navigation privée est la méthode la plus simple et la plus rapide pour tester.

ℹ️ Note technique : Cette protection fonctionne grâce à votre session de connexion Webful. Le système détecte automatiquement que vous êtes le propriétaire du site et exclut vos visites des statistiques.

❓ Webful est-il conforme au RGPD ?

Oui, totalement ! Webful est conçu pour être respectueux de la vie privée :

  • Aucun cookie n'est utilisé
  • Aucune donnée personnelle identifiable n'est collectée
  • Les adresses IP sont hachées de manière irréversible
  • Conformité RGPD native
❓ Puis-je tracker plusieurs sites avec un seul compte ?

Oui ! Le nombre de sites dépend de votre plan :

  • Gratuit : 1 site
  • Solo : 1 sites
  • Pro : 3 sites
  • Entreprise : 10 ou plus

→ Voir tous les tarifs

❓ Comment désinstaller Webful ?

WordPress :

  1. Désactivez le plugin dans Extensions > Extensions installées
  2. Cliquez sur "Supprimer"

Site classique :

  1. Supprimez le code de tracking de votre fichier HTML/PHP
  2. Supprimez le site depuis votre dashboard Webful (optionnel)
❓ Comment mettre à jour le plugin WordPress ?

Pour mettre à jour le plugin Webful vers une nouvelle version sans perdre votre configuration :

✅ Important : Vos identifiants et paramètres sont préservés !

La configuration est stockée dans la base de données WordPress, pas dans les fichiers du plugin.

Étapes de mise à jour :

  1. Téléchargez la nouvelle version

    Rendez-vous dans votre dashboard Webful et téléchargez le fichier ZIP de la dernière version

  2. Installez la nouvelle version

    Dans WordPress, allez dans Extensions → Ajouter → Téléverser une extension

  3. Sélectionnez le fichier ZIP

    Cliquez sur "Choisir un fichier" et sélectionnez le nouveau fichier webful-wordpress-plugin.zip

  4. Remplacez l'extension actuelle

    WordPress détectera que le plugin existe déjà et proposera "Remplacer l'extension actuelle" → Cliquez dessus

  5. Vérifiez que tout fonctionne

    Allez dans le menu WEBFUL de WordPress et vérifiez que le statut est "✅ Site connecté"

✅ C'est terminé !

Vos identifiants sont intacts, le tracking continue de fonctionner. Aucune reconnexion nécessaire.

⚠️ Ne désinstallez PAS le plugin

Si vous désactivez puis supprimez le plugin, vous perdrez votre configuration. Utilisez uniquement la méthode "Remplacer l'extension actuelle".

❓ Où trouver de l'aide supplémentaire ?

Si vous avez besoin d'aide, plusieurs options s'offrent à vous :

Notre équipe répond généralement sous 24h les jours ouvrés.

Prêt à commencer ?

Créez votre compte Webful gratuit et installez le tracking en 5 minutes

Créer un compte gratuit Se connecter