Comment auto-héberger l'analyse de votre site Web avec Plausible

0
169

Plausible est une alternative open-source à Google Analytics. Il est disponible en tant que produit hébergé commercial et en tant que logiciel auto-hébergé gratuit. Dans ce guide, nous vous montrerons comment configurer Plausible et commencer à obtenir des informations sur le trafic de votre site Web.

Présentation

Priorités plausibles sur la confidentialité, la simplicité et les mesures exploitables. Il est conforme à la législation GDPR, CCPA et PECR. Plausible ne place pas de cookies sur vos visiteurs & # 8217; appareils, vous n'aurez donc pas besoin de bannières de confidentialité intrusives sur votre page d'accueil.

Le tableau de bord Web Plausible a une conception minimale qui vous permet de voir le nombre de visiteurs, le nombre total de pages vues, les taux de rebond et la durée des visites. Il & # 8217; s également des données générales sur les pays d'origine, les sources de référence et les types d'appareils des visiteurs.

Pour auto-héberger Plausible, vous aurez besoin de Docker et Docker Compose. Plausible est disponible sur Docker Hub comme plausible/analytics, mais des conteneurs supplémentaires sont nécessaires pour exécuter les serveurs de base de données. Il est recommandé d'utiliser le fichier Docker Compose officiel dans le référentiel GitHub plausible/hébergeant pour commencer.

Installation de Plausible

Assurez-vous de & # 8217; Git, Docker et Docker Compose sont installés. Commencez par cloner le dépôt plausible/hébergement:

git clone https://github.com/plausible/hosting hébergement cd

Le référentiel contient des fichiers de configuration pré-préparés qui vous permettent de lancer rapidement une nouvelle installation Plausible. Le fichier docker-compose.yml doit être prêt à être utilisé. Il relie les conteneurs de dépendances au conteneur principal de l'application Plausible.

Plausible sera exposé sur le port 8000 de votre hôte. Si vous préférez un autre port, tel que 8800, recherchez la ligne ports: dans la section plausible de docker-compose.yml. Changez la ligne suivante de – 8000: 8000 à – 8800: 8000 pour lier le port hôte 8800 au port 8000 du conteneur & # 8217 ;.

Ensuite, ouvrez plausible-conf.env dans votre éditeur. Il s'agit du fichier de configuration du serveur d'applications Plausible. Il comprend cinq paramètres par défaut. Ils définissent le domaine du serveur et configurent un utilisateur administrateur initial.

< p>Remplacez respectivement les valeurs ADMIN_USER_EMAIL, ADMIN_USER_NAME et ADMIN_USER_PWD par votre adresse e-mail, votre nom et votre mot de passe. Votre mot de passe doit comporter au moins six caractères. Définissez BASE_URL sur le domaine sur lequel votre serveur Plausible sera hébergé. Vous pouvez utiliser http: //localhost: 8000 pour les tests locaux.

Le réglage final de la configuration est de fournir une clé secrète pour protéger le système d'authentification de Plausible. Générez une chaîne aléatoire et ajoutez-la comme valeur de SECRET_KEY_BASE. La chaîne doit contenir 64 caractères. Vous pouvez utiliser openssl rand pour créer une valeur sécurisée:

openssl rand -base64 64

Vous êtes maintenant prêt à démarrer Plausible!

docker-compose up -d

Cela peut prendre plusieurs secondes à Docker pour extraire les images du conteneur et démarrer tous les services. Une fois le processus d'extraction terminé, exécutez les journaux docker hosts_plausible_1 –follow pour vérifier si l'amorçage est terminé.

Visitez http: //localhost: 8000 dans votre navigateur lorsque vous voyez & # 8220; migrations réussies & # 8221; apparaissent dans les journaux. Vous devriez voir l'écran de connexion Plausible. Connectez-vous avec l'adresse e-mail et le mot de passe que vous avez configurés.

Vous serez invité à activer votre compte. Le processus d'activation vous envoie un code de vérification par e-mail. La configuration par défaut n'inclut pas le fonctionnement des e-mails sortants, il est donc préférable d'ignorer manuellement cette étape.

Exécutez la commande suivante dans votre terminal:

docker exec hébergement_plausible_db_1 psql – U postgres -d plausible_db -c “UPDATE users SET email_verified = true;”

Cela exécute une requête SQL simple sur la base de données Plausible. La requête effacera l'indicateur de vérification en attente de chaque utilisateur.

Revenir à http: //localhost: 8000 dans votre navigateur. Vous devriez maintenant voir le tableau de bord Plausible. Il sera vide car vous n’avez ajouté aucun site.

Connecter votre site Web à Plausible

Un seul serveur Plausible peut collecter des données à partir de plusieurs sites Web indépendants. Vous devez utiliser le tableau de bord Plausible pour enregistrer chaque site que vous surveillerez. Vous ajoutez ensuite le script de suivi JavaScript plausible au code HTML de votre site. Cela rapporte chaque page vue à votre serveur Plausible. Le script de suivi réduit pèse moins de 1 Ko.

Cliquez sur & # 8220; Ajouter un site Web & # 8221; dans le tableau de bord Plausible. Vous devrez fournir des informations de base sur votre site. Entrez la racine du nom de domaine comme example.com, sans aucun préfixe de sous-domaine. Cela permet aux métriques d'exemple.com et www.example.com d'être collectées par la même propriété de site. Choisissez un fuseau horaire approprié à utiliser lors du calcul des rapports.

Cliquez sur & # 8220; Ajouter un extrait & # 8221; pour confirmer vos paramètres. Plausible affichera votre site & # 8217; s & lt; script & gt; extrait de tag. Ajoutez le code à la balise & lt; head & gt; section HTML de votre site Web. Chaque chargement de page téléchargera le script et rapportera les métriques à Plausible.

& lt;! DOCTYPE html & gt; & nbsp; & lt; html & gt; & lt; tête & gt; & lt; meta charset = & quot; utf-8 & quot;/& gt; & lt; title & gt; Mon site Web & lt;/title & gt; & lt; script async defer data-domain = & quot; example.com & quot; src = & quot; http: //localhost: 8000/js/plausible.js & quot; & gt; & lt;/script & gt; & lt;/tête & gt; & nbsp; & lt; corps & gt; & lt; h1 & gt; Exemple de site Web & lt;/h1 & gt; & lt;/corps & gt; & lt;/html & gt;

Plausible ne fonctionne pas avec les domaines localhost. Si vous souhaitez effectuer un test sur un site fonctionnant sur votre machine, envisagez d'utiliser/etc/hosts pour y mapper un domaine temporaire:

127.0.0.1 foobar.net

Enregistrez foobar.net comme domaine de votre site dans Plausible , puis visitez foobar.net dans votre navigateur. Votre site Web devrait s'afficher et les appels commenceront à apparaître dans Plausible.

Une fois la configuration de votre connexion au site terminée, cliquez sur Plausible & # 8217; s & # 8220; Commencer à collecter des données & # 8221; bouton pour accéder au tableau de bord de votre site.

Explorer Plausible

L'interface utilisateur simpliste de Plausible & # 8217; s vous donne un aperçu rapide des performances de votre site. Les indicateurs clés tels que le nombre total de pages vues et les visiteurs uniques sont affichés en haut de l'écran. Plus loin dans votre tableau de bord, vous verrez les listes de vos pages les plus performantes, de vos référents externes et des types d'appareils de visiteur. Les données affichent par défaut les 30 derniers jours; vous pouvez changer cela en utilisant le menu déroulant en haut à droite.

Pour accéder aux paramètres de votre site, cliquez sur le nom du site en haut à gauche. Appuyez sur & # 8220; Paramètres du site & # 8221; dans le menu déroulant. Ici, vous pouvez gérer la configuration de votre site.

La & # 8220; Visibilité & # 8221; La section vous permet de rendre votre tableau de bord visible publiquement, sans vous connecter à Plausible. Vous pouvez également générer des liens partageables uniques que vous pouvez distribuer à des personnes spécifiques.

Les & # 8220; Objectifs & # 8221; La section fournit un mécanisme de base de suivi des objectifs/de surveillance des événements. Vous pouvez définir des URI cibles, telles que/checkout-complete, que Plausible suivra.

Créez des objectifs en vous dirigeant vers les & # 8220; Objectifs & # 8221; section, en cliquant sur & # 8220; Ajouter un objectif & # 8221; et en remplissant le formulaire pour fournir un URI de page à suivre. Lorsqu'un utilisateur visite l'URI, il & # 8217; apparaît sous & # 8220; Conversions par objectif & # 8221; au bas de votre tableau de bord.

Configuration des e-mails

Les & # 8220; Rapports sur les e-mails & # 8221; L'élément de paramètres du site vous permet d'accepter les rapports hebdomadaires sur les performances du site et les notifications de pics de trafic inhabituels. Celles-ci ne fonctionneront pas à moins que vous ne fournissiez à Plausible les paramètres de messagerie sortants appropriés.

Plausible peut envoyer via un serveur SMTP ou le service de messagerie transactionnelle Postmark. Pour utiliser SMTP, mettez à jour votre plausible-conf.env avec les paramètres supplémentaires suivants:

  • MAILER_EMAIL & # 8211; Adresse e-mail que Plausible enverra en tant que
  • SMTP_HOST_ADDR & # 8211; Serveur SMTP auquel se connecter (par exemple, localhost)
  • SMTP_HOST_PORT & # 8211; Port du serveur SMTP
  • SMTP_USER_NAME & # 8211; Nom d'utilisateur pour se connecter en tant que
  • SMTP_USER_PWD & # 8211; Mot de passe à fournir au serveur SMTP (si nécessaire)
  • SMTP_HOST_SSL_ENABLED & # 8211; Soit vrai ou faux pour indiquer s'il faut utiliser SSL pour les connexions SMTP.

Si vous souhaitez utiliser Postmark, assurez-vous d'abord que vous disposez d'un compte Postmark et d'une clé API. Mettez ensuite à jour plausible-conf.env avec les paramètres suivants:

MAILER_ADAPTER = Bamboo.PostmarkAdapter POSTMARK_API_KEY = & lt; votre clé API & gt;

Une fois que vous avez terminé de peaufiner votre configuration Plausible, exécutez docker-compose up -d pour appliquer les modifications et redémarrer vos conteneurs. Vous devriez désormais pouvoir utiliser les fonctions de messagerie de Plausible & # 8217;.

Activation des données de pays

Le tableau de bord de Plausible & # 8217; s comprend une carte widget qui montre les pays d'origine de vos visiteurs. Ces données ne sont pas activées par défaut. Il dépend de la base de données
, qui n'est pas distribuée avec Plausible lui-même.

Vous avez besoin d'un compte GeoLite2 pour activer les fonctionnalités de géolocalisation de Plausible. La création d'un compte produira un identifiant de compte et une clé de licence. Remplacez ces valeurs par les variables GEOIPUPDATE_ACCOUNT_ID et GEOIPUPDATE_LICENSE_KEY dans votre fichier geoip/geoip.conf.

Ensuite, utilisez la commande suivante pour ajouter un conteneur de base de données GeoLite2 à votre pile Plausible:

docker-compose – f docker-compose.yml -f geoip/docker-compose.geoip.yml up

Docker extraira la base de données GeoLite et la rendra disponible pour le conteneur Plausible. Les futurs événements de page vue devraient alors inclure des données de géolocalisation qui seront visibles sur le tableau de bord Plausible.

Résumé

Plausible est un simple système d'analyse de site Web que vous pouvez vous-même- hôte. Il vous permet d'inspecter la portée de votre site sans avoir recours à un service tiers. Les utilisateurs ne seront pas suivis sur le Web ni frustrés par les bannières de cookies.

Vous pouvez effectuer une mise à jour vers les futures versions de Plausible en exécutant git pull et docker-compose up -d –pull. Cela mettra à jour votre instance de serveur en cours d'exécution pour qu'elle corresponde à la dernière image Plausible publiée sur Docker Hub.