Google Analytics avancé (v4)

[AJ_Quick]

	Résumé	Suivi avancé des événements Google Analytics 4 pour Discourse
	Lien du dépôt	https://github.com/multidimension-al/discourse-google-analytics
	Guide d’installation	Comment installer des plugins dans Discourse

Le cœur de Discourse envoie à Google Analytics un seul page_view par navigation. Ce plugin ajoute des événements pour le temps de lecture, la progression de lecture et l’achèvement, et peut éventuellement prendre en charge les vues de page afin d’exclure les routes de messages privés et d’administration.

POURQUOI NE PAS UTILISER L’ÉTICETTE SEO/GA ANALYTICS INTÉGRÉE ?

Vous pouvez le faire, et pour de nombreux forums, cela suffit. L’étiquette du cœur fonctionne, et ce plugin s’exécute par-dessus sans la remplacer.

La différence réside dans ce qui est mesuré. Un page_view indique qu’une URL a été chargée. Il ne peut pas dire si quelqu’un a lu ce qui s’y trouvait, donc une lecture de vingt minutes d’un long sujet et un rebond instantané apparaissent identiques dans vos rapports. Ce plugin mesure combien de temps quelqu’un a réellement lu, jusqu’où il est allé dans le sujet et s’il a atteint la fin. Ce sont les signaux qui méritent d’être pris en compte pour prendre des décisions de contenu, et ceux qui rendent une audience de remarketing digne d’être constituée.

Les rapports propres à Discourse (Administration → Rapports) sont un système distinct et restent le meilleur endroit pour les métriques internes. Il ne s’agit ici que de ce qui est transmis à Google Analytics.

Fonctionnalités

• 13 événements communautaires : vues de sujets, engagement et jalons de progression de lecture, achèvement de lecture, résumés par visite, recherche, inscription, connexion, création de sujet, réponses, likes, signets
• Lecture mesurée par rapport au flux de messages et au temps d’attention, et non par la profondeur de défilement
• Deux modes : étendre l’étiquette existante du cœur, ou prendre en charge l’étiquette et les vues de page
• Les messages privés, les catégories restreintes et les routes d’administration ne génèrent aucun événement
• Les titres de sujets et les termes de recherche sont désactivés par défaut
• Le trafic du personnel peut être marqué comme trafic interne GA4, par groupe
• Page de diagnostic et avertissements dans le tableau de bord d’administration en cas de mauvaise configuration

Configuration

1. Installation

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/multidimension-al/discourse-google-analytics.git

Puis exécutez ./launcher rebuild app.

2. Choisissez un mode. Administration → Paramètres → Google Analytics 4.

Extension du cœur (par défaut) — le cœur conserve l’étiquette et les vues de page, le plugin ajoute des événements par-dessus. Définissez le ga universal tracking code du cœur sur votre G-XXXXXXXXXX et ga version sur v4_gtag.

Géré — le plugin prend en charge l’étiquette et les vues de page, ce qui lui permet d’exclure les routes PM et d’administration. Effacez le ga universal tracking code du cœur, définissez ga4 integration mode sur managed et placez votre ID dans ga4 measurement id.

3. Activez discourse ga4 enabled.

4. Optionnel — trafic interne. ga4 internal traffic groups est défini par défaut sur les administrateurs et les modérateurs. Cela n’a d’effet qu’une fois que vous avez créé le filtre correspondant dans GA4 sous Administration → Paramètres de données → Filtres de données → Trafic interne, en faisant correspondre traffic_type à internal.

5. Vérification. Administration → Plugins → Google Analytics → Diagnostics.

Pour passer une configuration existante du mode Extension du cœur au mode Géré, utilisez Adopt existing Discourse GA configuration sur la page de diagnostic plutôt que de modifier les paramètres manuellement.

Paramètres

Nom	Description
discourse ga4 enabled	Active le plugin. Désactivé par défaut.
ga4 integration mode	core_extension (le cœur possède l’étiquette) ou managed (le plugin la possède).
ga4 measurement id	ID de mesure GA4, pour le mode géré.
ga4 track page views	Envoie page_view. Mode géré uniquement.
ga4 track topic views	Envoie discourse_topic_view une fois par visite de sujet.
ga4 track topic engagement	Envoie discourse_topic_engaged aux jalons de temps de lecture.
ga4 engagement milestones	Secondes de lecture active auxquelles déclencher. Défaut 10|30|60|180.
ga4 track topic progress	Envoie discourse_topic_progress aux jalons de position de lecture.
ga4 progress milestones	Pourcentages du sujet auxquels déclencher. Défaut 25|50|75|100.
ga4 track read completion	Envoie discourse_topic_read_complete lorsqu’un lecteur atteint la fin.
ga4 read complete min seconds	Temps de lecture minimal avant que la fin ne compte comme achèvement.
ga4 track read summaries	Envoie discourse_topic_read_summary lorsqu’un lecteur quitte un sujet.
ga4 read summary min seconds	En dessous de ce seuil, une visite est traitée comme un rebond et non résumée.
ga4 track search	Envoie search lorsqu’une recherche pleine page renvoie des résultats.
ga4 track registration	Envoie sign_up après la création d’un compte.
ga4 track login	Envoie login après une connexion réussie. Désactivé par défaut.
ga4 track topic creation	Envoie discourse_topic_created.
ga4 track replies	Envoie discourse_reply_created.
ga4 track likes	Envoie discourse_post_liked. Supprimer un like n’envoie rien.
ga4 track bookmarks	Envoie discourse_bookmark_created.
ga4 send search terms	Envoie également ce qui a été recherché. Désactivé par défaut — les recherches de forum contiennent souvent des informations personnelles.
ga4 send page titles	Inclut le titre de la page. Désactivé par défaut — sur une route de sujet, il s’agit du titre du sujet.
ga4 track private message activity	Un événement PM agrégé ne contenant aucun identifiant. Désactivé par défaut.
ga4 login required is restricted	Sur un forum nécessitant une connexion, retient les identifiants de sujet et de catégorie.
ga4 send trust level	Inclut le niveau de confiance 0–4 en tant que paramètre d’événement.
ga4 internal traffic groups	Les membres de ces groupes sont marqués traffic_type=internal. Défaut : administrateurs, modérateurs.
ga4 suppress in embed	N’envoie rien en mode intégration.
ga4 debug mode	Journalise les événements et les décisions de suppression dans la console du navigateur.

Notes

• En mode Extension du cœur, le cœur possède toujours les vues de page, donc les URL de PM et les titres de sujets sont toujours envoyés. Seul le mode Géré change cela.
• N’enregistrez pas topic_id comme dimension personnalisée GA4 — il est non borné et atteindra les limites de cardinalité de la propriété.
• Le rapport Administration → Rapports → Recherches tendance de Discourse enregistre les clics, ce qui vous indique quelles recherches ont échoué. GA4 ne peut pas le faire. C’est pourquoi ga4 send search terms est désactivé par défaut.