Mixpanel

Mixpanel is een eventgerichte analysetool die gebruikersgebeurtenissen bijhoudt in plaats van automatisch data vast te leggen. Door Mixpanel te integreren met je kennisbank van Document360 kun je analyseren hoe lezers met je content omgaan, welke artikelen betrokkenheid stimuleren, waar ze afvallen en hoe effectief je site in het algemeen is.

Voordat je begint

• Je hebt een Mixpanel-account nodig.
• Je hebt je Mixpanel Project-token nodig, beschikbaar in Mixpanel onder Instellingen > Projectinstellingen > Project-token.

Configuratieopties

Bij het toevoegen van de Mixpanel-integratie kun je kiezen tussen twee configuratietypes:

• Basisconfiguratie: standaardopstelling die automatisch paginaweergaven bijhoudt nadat je je Mixpanel Project-token hebt ingevoerd. Gebruik dit voor een snelle opstelling met minimale moeite.
• Aangepaste configuratie: geavanceerde setup die vereist dat de Mixpanel-bibliotheek handmatig geladen en geïnitialiseerd moet worden. Gebruik dit wanneer je specifieke gebeurtenissen wilt bijhouden buiten paginaweergaven, zoals knopklikken of formulierinzendingen.

Hoe Mixpanel in te stellen

Basisconfiguratie

1. Navigeer in het Document360-portaal naar Connections () > Integraties () in de linker navigatiebalk.
2. Selecteer Mixpanel uit de lijst met integraties en klik op Toevoegen. De dialoogvenster 'Nieuwe integratie toevoegen ' verschijnt.
3. Selecteer de optie Basisconfiguratie .
4. Voer een beschrijving in voor deze integratie.
5. Voer je Mixpanel Project-token in in het veld Mixpanel ID . Voor details over waar je je token kunt vinden, zie de Mixpanel-installatiegids.
6. Optioneel kunt u Code-inclusie/uitsluitingsvoorwaarden uitbreiden om de code toe te passen op basis van IP-adres, werkruimte of taal.
7. Klik op Toevoegen.

Je kennisbank zal nu paginaweergavegegevens naar Mixpanel sturen.

Aangepaste configuratie

Gebruik Custom configuratie om een geavanceerde Mixpanel-integratie in te stellen. Met deze optie kun je JavaScript-code direct toevoegen in het configuratiepaneel en de gebeurtenistracking aanpassen aan jouw behoeften.

1. Navigeer in het Document360-portaal naar Connections () > Integrations () in de linker navigatiebalk.
2. Selecteer Mixpanel uit de lijst met integraties en klik op Toevoegen. Het panel 'Voeg nieuwe integratie ' aan verschijnt.
3. Selecteer de optie Aangepaste configuratie .
4. Voer een beschrijving in voor deze integratie.
5. Plak je JavaScript-fragment in het codeveld. Zie de onderstaande voorbeelden.
6. Optioneel kunt u Code-inclusie/uitsluitingsvoorwaarden uitbreiden om de code toe te passen op basis van IP-adres, werkruimte of taal.
7. Klik op Toevoegen.

Voorbeeld: Laad en initialiseer Mixpanel

Vervang YOUR_PROJECT_TOKEN het door je echte Mixpanel Project-token uit de Mixpanel-projectinstellingen.

<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>

Voorbeeld: Paginaweergave-tracking

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

Voorbeeld: Knopkliktracking

Vervang yourButtonId het met de daadwerkelijke ID van de knop die je wilt volgen, en werk "Your Button Label" bij met een betekenisvol label. Als je bijvoorbeeld een knop met het label "Abonneer" bijhoudt, gebruik "subscribeButton" dan en "Subscribe".

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

Controleer de configuratie

Als er na de installatie geen data in Mixpanel verschijnt, doorloop dan de volgende controles:

Bevestig je token

Zorg dat je het Mixpanel Project-token hebt ingevoerd en niet de Project-ID of het API-geheim.

Controleer de bron van de pagina

1. Open je kennisbanksite in een browser.
2. Klik met de rechtermuisknop ergens op de pagina en selecteer 'Broncode weergeven ' (snelkoppeling: Ctrl + U op Windows/Linux, ⌘+ Option+ U op Mac).
3. Druk Ctrl + F / ⌘ + F en zoek naar mixpanel. Als je het niet vindt, is het Mixpanel-integratiescript niet geïnjecteerd.

Controleer het tabblad Netwerk.

1. Open je kennisbanksite in een browser.
2. Druk op F12 (Windows/Linux) of ⌘ + Option + I (Mac) om Developer Tools te openen.
3. Ga naar het tabblad Netwerk .
4. Typ api.mixpanel.comin de filterbox .
5. Herlaad de pagina of voer een actie uit zoals het bekijken van een artikel. Als je verzoeken ziet om api.mixpanel.com, worden er gebeurtenissen verzonden. Als er geen verzoeken verschijnen, laadt de Mixpanel-bibliotheek niet of worden evenementen geblokkeerd.

Blokkeerders uitsluiten

Controleer op adblockers, cookie-toestemmingsbanners of beperkende Content Security Policies (CSP). Deze kunnen voorkomen dat Mixpanel data laadt of verzendt.

Workaround met behulp van aangepaste HTML

Als het Mixpanel-integratiescript niet correct laadt via de native integratie, kun je het toevoegen als een aangepaste HTML-integratie.

1. Navigeer in het Document360-portaal naar Verbindingen () > Integraties () in de linker navigatiebalk.
2. Selecteer Aangepaste HTML uit de lijst met integraties en klik op Toevoegen. Het panel 'Voeg nieuwe integratie ' aan verschijnt.
3. Plak het Mixpanel-bibliotheekfragment (zie hierboven "Mix panel laden en initialiseren").
4. Voeg je aangepaste event tracking-code toe onder het initialisatiefragment.
5. Klik op Toevoegen en test opnieuw in Mixpanel.

Best practices

• Gebruik de basisconfiguratie tenzij je aangepaste event tracking nodig hebt. Voor de meeste kennisbanken is het invoeren van het Projecttoken onder Basic-configuratie voldoende om paginaweergaven te gaan volgen.
• Initialiseer altijd de Mixpanel-bibliotheek voordat je trackingfuncties aanroept. In Custom configuratie plakt u eerst het volledige initialisatiefragment van de bibliotheek en voegt u vervolgens uw event tracking-code eronder toe.
• Test in een incognito-venster na het opslaan. Browsercaching kan ervoor zorgen dat verouderde scripts draaien, waardoor het lijkt alsof de wijzigingen niet zijn doorgevoerd.
• Gebruik Code-inclusie/uitsluitingsvoorwaarden om intern verkeer uit te sluiten. Voeg je kantoor-IP-adres toe als uitsluiting om te voorkomen dat teambezoeken je analysegegevens vertekenen.
• Noem evenementen om bij je naamgevingsconventie te passen. Mixpanel-gebeurtenisnamen zijn hoofdlettergevoelig en verschijnen zoals ze zijn in je dashboard. Gebruik consistente, beschrijvende namen zoals "Artikel bekeken" in plaats van "Paginaweergave" om je gegevens makkelijker leesbaar te maken.

FAQ