Clause de non-responsabilité: Cet article a été généré par traduction automatique.

Mixpanel

Prev Next

Offres prenant en charge cette fonctionnalité : Business Enterprise

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 vous permet d’analyser comment les lecteurs interagissent avec votre contenu, quels articles stimulent l’engagement, où ils se déplacent et mesurer l’efficacité de votre site.

Document360 prend en charge Mixpanel comme l’une de ses nombreuses intégrations tierces.


Prérequis avant d’intégrer Mixpanel avec Document360

  • Un compte Mixpanel

  • Votre jeton Mixpanel Project (disponible dans Mixpanel sous Paramètres > Paramètres de projet > jeton Project).


Options de configuration

Lors de l’intégration Mixpanel avec Document360, vous pouvez choisir parmi deux options de configuration :

  • Configuration de base : configuration standard qui suit automatiquement les pages vues après avoir saisi votre jeton Mixpanel Project.

  • Configuration personnalisée : Configuration avancée qui nécessite de charger et initialiser manuellement la bibliothèque Mixpanel . Vous pouvez ensuite ajouter un code de suivi personnalisé pour des événements spécifiques.

Configuration de base

Utilisez la configuration Basic si vous voulez une configuration rapide qui suit automatiquement les pages vues avec un minimum d’effort.

  1. Naviguer vers  Connections () > Integrations dans la barre de navigation de gauche du portail de la base de connaissances.

  2. Mixpanel dans la liste des intégrations et cliquez sur Ajouter.

    La fenêtre Ajouter une nouvelle intégration apparaîtra.

  3. Sélectionnez l’option de configuration de base .

  4. Voici la description.

  5. Saisissez votre jeton Mixpanel Project dans le champ Mixpanel. Pour plus de détails sur l’endroit où trouver votre jeton Mixpanel Project, consultez le guide d’installation Mixpanel.

  6. En option, utilisez la fonction d’inclusion/exclusion de code pour appliquer le code en fonction de l’adresse IP, de l’espace de travail ou du langage.

  7. Cliquez sur Ajouter pour sauvegarder votre intégration.

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

NOTE

Si vous souhaitez suivre des événements supplémentaires (comme des clics de boutons ou des soumissions de formulaires), vous pouvez utiliser l’option Configuration personnalisée.

Configuration personnalisée

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

  1. Naviguer vers  Connections () > Integrations dans la barre de navigation de gauche du portail de la base de connaissances.

  2. Mixpanel dans la liste des intégrations et cliquez sur Ajouter. Le panneau Ajouter une nouvelle intégration apparaîtra.

  3. Sélectionnez l’option Configuration personnalisée .

  4. Saisissez la description dans le panneau Ajouter une nouvelle intégration .

  5. Collez votre extrait JavaScript (voir exemples ci-dessous).

  6. En option, utilisez la fonction d’inclusion/exclusion de code pour appliquer le code en fonction de l’adresse IP, de l’espace de travail ou du langage.

  7. Cliquez sur Ajouter pour sauvegarder votre intégration.

ATTENTION

La configuration personnalisée ne charge pas Mixpanel . Vous devez d’abord inclure la bibliothèque Mixpanel et l’initialiser avec votre jeton Mixpanel Project.

Exemple : Charger et initialiser Mixpanel

Remplacez-le YOUR_PROJECT_TOKEN par votre véritable jeton Mixpanel Project depuis les paramètres Project 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>

NOTE

Vous pouvez renommer "Page View" un autre nom d’événement comme "Article Viewed" ou "Category Opened", selon ce que vous souhaitez suivre.

Exemple : suivi par clics de boutons

Remplacez-le yourButtonId par l’ID réel du bouton que vous souhaitez suivre, et mettez à jour "Button Name" avec une étiquette pertinente.

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

NOTE

Par exemple, si vous suivez un bouton intitulé « S’abonner », remplacez yourButtonId par "subscribeButton" et "Your Button Label" par "Subscribe".

ASTUCE PRO

Les exemples de code ci-dessus ne montrent que les cas d’usage les plus courants (vues de page et clics de boutons). Si vous souhaitez suivre d’autres types d’événements personnalisés, tels que la soumission de formulaires, les lectures vidéo ou la profondeur de défilement, consultez la documentation du SDK JavaScript Mixpanel. Il comprend une liste complète de méthodes, de propriétés et de schémas avancés de suivi des événements.


Vérifiez la configuration

Si aucune donnée n’apparaît dans Mixpanel :

  • Confirmez votre jeton
    Assurez-vous d’avoir saisi le jeton Mixpanel Project (pas Project ID ou API secret).

  • 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 (Windows/Linux) ou ⌘+Option+U (Mac).

    3. Appuyez sur Ctrl+F / ⌘+F et cherchez mixpanel.

      • Si vous ne le trouvez pas, le script 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 développeur.

    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.

ASTUCE PRO

Testez toujours dans une fenêtre incognito ou privée. Cela garantit que vous chargez les derniers scripts publiés et évite les problèmes causés par la mise en cache du navigateur.

Solution de contournement utilisant le HTML personnalisé

Si le script d’intégration ne se charge pas correctement, vous pouvez ajouter une intégration HTML personnalisée comme solution de contournement.

  1. Naviguer vers  Connections () > Integrations dans la barre de navigation de gauche du portail de la base de connaissances.

  2. Sélectionnez HTML personnalisé dans la liste des intégrations et cliquez sur Ajouter. Le panneau Ajouter une nouvelle intégration apparaîtra.

  3. Collez l’extrait de la bibliothèque Mixpanel (voir « Charger et initialiser Mixpanel » ci-dessus).

  4. Ajoutez votre code personnalisé de suivi d’événements.

  5. Sauvegardez votre intégration et testez à nouveau dans Mixpanel.