Mixpanel

Mixpanel est un outil d’analyse centré sur les événements qui suit les événements des utilisateurs plutôt que de capturer automatiquement les données. Intégrer Mixpanel à votre base de connaissances Document360 vous permet d’analyser comment les lecteurs interagissent avec votre contenu, quels articles suscitent l’engagement, où ils se situent et l’efficacité globale de votre site.

Avant que tu commences

• Vous avez besoin d’un compte Mixpanel.
• Vous avez besoin de votre jeton Mixpanel Project, disponible dans Mixpanel sous Paramètres > Paramètres de Projet > Jeton Projet.

Options de configuration

Lors de l’intégration Mixpanel, vous pouvez choisir entre deux types de configuration :

• Configuration de base : configuration standard qui suit automatiquement les pages vues après avoir saisi votre jeton Mixpanel Project. Utilisez-le pour une installation rapide avec un minimum d’effort.
• Configuration personnalisée : configuration avancée qui nécessite de charger et initialiser manuellement la bibliothèque Mixpanel. Utilisez-le lorsque vous souhaitez suivre des événements spécifiques au-delà des pages vues, comme des clics de boutons ou des soumissions de formulaires.

Comment configurer Mixpanel

Configuration de base

1. Dans le portail Document360, naviguez jusqu’à Connexions () > Intégrations () dans la barre de navigation de gauche.
2. Sélectionnez Mixpanel dans la liste des intégrations et cliquez sur Ajouter. La boîte d’affichage Ajouter une nouvelle intégration apparaît.
3. Sélectionnez l’option de configuration de base .
4. Voici une description pour cette intégration.
5. Saisissez votre jeton Mixpanel Project dans le champ ID Mixpanel . Pour plus de détails sur l’endroit où trouver votre jeton, consultez le guide d’installation de Mixpanel.
6. En option, étendez les conditions d’inclusion/exclusion du code pour appliquer le code en fonction de l’adresse IP, de l’espace de travail ou du langage.
7. Cliquez sur Ajouter.

Votre base de connaissances enverra désormais les données de page view à Mixpanel.

Configuration personnalisée

Utilisez la configuration personnalisée pour configurer une intégration avancée avec Mixpanel. Cette option vous permet d’ajouter du code JavaScript directement dans le panneau de configuration et de personnaliser le suivi des événements selon vos besoins.

1. Dans le portail Document360, naviguez dans Connexions () > Intégrations () dans la barre de navigation de gauche.
2. Sélectionnez Mixpanel dans la liste des intégrations et cliquez sur Ajouter. Le panneau Ajouter une nouvelle intégration apparaît.
3. Sélectionnez l’option Configuration personnalisée .
4. Voici une description pour cette intégration.
5. Collez votre extrait JavaScript dans le champ de code. Voir les exemples ci-dessous.
6. En option, étendez les conditions d’inclusion/exclusion du code pour appliquer le code en fonction de l’adresse IP, de l’espace de travail ou du langage.
7. Cliquez sur Ajouter.

Exemple : Charger et initialiser Mixpanel

Remplacez-le YOUR_PROJECT_TOKEN par votre véritable jeton Mixpanel Project depuis les paramètres Project de Mixpanel.

<script>
(function(f,b){
  if(!b.__SV){
    var e,g,i,h;window.mixpanel=b;b._i=[];
    b.init=function(e,f,c){function g(a,d){var b=d.split(".");
      2==b.length&&(a=a[b[0]],d=b[1]);
      a[d]=function(){a.push([d].concat(Array.prototype.slice.call(arguments,0)))}}
      var a=b;"undefined"!==typeof c?a=b[c]=[]:c="mixpanel";
      a.people=a.people||[];a.toString=function(a){var d="mixpanel";
      "mixpanel"!==c&&(d+="."+c);a||(d+=" (stub)");return d};
      a.people.toString=function(){return a.toString(1)+".people (stub)"};
      i="disable time_event track track_pageview track_links track_forms track_with_groups add_group set_group remove_group register register_once alias unregister identify name_tag set set_once union unset toString reset opt_in_tracking opt_out_tracking has_opted_in_tracking has_opted_out_tracking clear_opt_in_out_tracking get_group".split(" ");
      for(h=0;h<i.length;h++)g(a,i[h]);
      b._i.push([e,f,c])
    };
    b.__SV=1.2;
    e=f.createElement("script");
    e.type="text/javascript";e.async=!0;
    e.src="https://cdn.mxpnl.com/libs/mixpanel-2-latest.min.js";
    g=f.getElementsByTagName("script")[0];
    g.parentNode.insertBefore(e,g)
  }
})(document, window.mixpanel || []);
mixpanel.init("YOUR_PROJECT_TOKEN");
</script>

Exemple : suivi de la vue de page

<script>
mixpanel.track("Page View", {
  "Page URL": window.location.href,
  "Page Title": document.title,
  "Referrer": document.referrer || ""
});
</script>

Exemple : suivi par clics de boutons

Remplacez-le yourButtonId par l’ID réel du bouton que vous souhaitez suivre, et mettez à jour "Your Button Label" avec une étiquette pertinente. Par exemple, si vous suivez un bouton intitulé « S’abonner », utilisez "subscribeButton" et "Subscribe".

<script>
document.getElementById("yourButtonId")
  .addEventListener("click", function() {
    mixpanel.track("Button Click", {
      "Button Name": "Your Button Label",
      "Page URL": window.location.href
    });
  });
</script>

Vérifiez la configuration

Si aucune donnée n’apparaît dans Mixpanel après la configuration, effectuez les vérifications suivantes :

Confirmez votre jeton

Assurez-vous d’avoir saisi le jeton Mixpanel Project et non le Project ID ou le secret de l’API.

Consultez la source de la page

1. Ouvrez votre site de base de connaissances dans un navigateur.
2. Faites un clic droit n’importe où sur la page et sélectionnez Voir la source de la page (raccourci : Ctrl + U sous Windows/Linux, ⌘+ Option+ U sur Mac).
3. Appuyez Ctrl + F sur / ⌘ + F et recherchez . mixpanel Si vous ne le trouvez pas, le script d’intégration Mixpanel n’a pas été injecté.

Vérifie l’onglet Réseau

1. Ouvrez votre site de base de connaissances dans un navigateur.
2. Appuyez sur F12 (Windows/Linux) ou ⌘ + Option + I (Mac) pour ouvrir les outils de développement.
3. Va dans l’onglet Réseau .
4. Dans la boîte filtre, tapez api.mixpanel.com.
5. Rechargez la page ou effectuez une action comme consulter un article. Si vous voyez des demandes à api.mixpanel.com, des événements sont en cours d’envoi. Si aucune requête n’apparaît, la bibliothèque Mixpanel ne se charge pas ou les événements sont bloqués.

Exclure les bloqueurs

Vérifiez la présence de bloqueurs de publicités, de bannières de consentement aux cookies ou de politiques de sécurité de contenu (CSP) restrictives. Ces éléments peuvent empêcher Mixpanel de charger ou d’envoyer des données.

Solution de contournement utilisant le HTML personnalisé

Si le script d’intégration Mixpanel ne se charge pas correctement via l’intégration native, vous pouvez l’ajouter comme une intégration HTML personnalisée à la place.

1. Dans le portail Document360, naviguez jusqu’à Connexions () > Intégrations () dans la barre de navigation de gauche.
2. Sélectionnez HTML personnalisé dans la liste des intégrations et cliquez sur Ajouter. Le panneau Ajouter une nouvelle intégration apparaît.
3. Collez l’extrait de la bibliothèque Mixpanel (voir « Charger et initialiser Mixpanel » ci-dessus).
4. Ajoutez votre code de suivi d’événements personnalisé sous le fragment d’initialisation.
5. Cliquez sur Ajouter et testez à nouveau dans Mixpanel.

Meilleures pratiques

• Utilisez la configuration de base sauf si vous avez besoin d’un suivi d’événements personnalisé. Pour la plupart des bases de connaissances, entrer le jeton Project sous configuration Basic suffit pour commencer à suivre les pages vues.
• Initialisez toujours la bibliothèque Mixpanel avant d’appeler les fonctions de suivi. En configuration personnalisée, collez d’abord l’extrait complet d’initialisation de la bibliothèque, puis ajoutez votre code de suivi d’événements en dessous.
• Testez dans une fenêtre incognito après avoir sauvegardé. Le cache du navigateur peut faire tourner des scripts obsolètes, ce qui donne l’impression que les changements n’ont pas eu effet.
• Utilisez les conditions d’inclusion/exclusion du Code pour exclure le trafic interne. Ajoutez votre adresse IP de bureau comme exclusion pour éviter que les visites d’équipe ne faussent vos données analytiques.
• Renomme les événements pour qu’ils correspondent à votre convention de nommage. Les noms des événements Mixpanel sont sensibles aux majuscules et apparaissent tels quels dans votre tableau de bord. Utilisez des noms cohérents et descriptifs comme « Article consulté » plutôt que « Page View » pour faciliter la lecture de vos données.

FAQ