Mixpanel

Mixpanel ist ein ereigniszentriertes Analysetool, das Nutzerereignisse verfolgt und nicht automatisch Daten erfasst. Die Integration von Mixpanel in Ihre Document360-Wissensdatenbank ermöglicht es Ihnen zu analysieren, wie Leser mit Ihren Inhalten interagieren, welche Artikel Engagement fördern, wo sie absinken und wie effektiv Ihre Website insgesamt ist.

Bevor du anfängst

• Du brauchst ein Mixpanel-Konto.
• Du brauchst dein Mixpanel Project Token, das in Mixpanel unter Einstellungen > Projekteinstellungen > Projekttoken verfügbar ist.

Konfigurationsoptionen

Beim Hinzufügen der Mixpanel-Integration können Sie zwischen zwei Konfigurationstypen wählen:

• Grundkonfiguration: Standard-Setup, das Seitenaufrufe automatisch verfolgt, nachdem du dein Mixpanel Project Token eingegeben hast. Nutze das für einen schnellen Aufbau mit minimalem Aufwand.
• Benutzerdefinierte Konfiguration: eine erweiterte Einrichtung, die das manuelle Laden und Initialisieren der Mixpanel-Bibliothek erfordert. Nutzen Sie dies, wenn Sie bestimmte Ereignisse über Seitenaufrufe hinaus verfolgen möchten, wie Button-Klicks oder Formulareinreichungen.

Wie man Mixpanel einrichtet

Grundkonfiguration

1. Im Document360-Portal navigieren Sie in der linken Navigationsleiste zu Verbindungen () > Integrationen ().
2. Wählen Sie Mixpanel aus der Liste der Integrationen und klicken Sie auf Hinzufügen. Der Dialog "Neue Integration hinzufügen " erscheint.
3. Wählen Sie die Option Basiskonfiguration .
4. Geben Sie eine Beschreibung für diese Integration ein.
5. Gib dein Mixpanel-Projekt-Token im Feld Mixpanel ID ein. Für Details, wo du deinen Token finden kannst, siehe den Mixpanel-Installationsleitfaden.
6. Optional erweitern Sie Code-Einschluss-/Ausschlussbedingungen , um den Code basierend auf IP-Adresse, Arbeitsbereich oder Sprache anzuwenden.
7. Klicken Sie auf Hinzufügen.

Ihre Wissensdatenbank sendet nun Seitenansichtsdaten an Mixpanel.

Benutzerdefinierte Konfiguration

Verwenden Sie benutzerdefinierte Konfiguration, um eine erweiterte Mixpanel-Integration einzurichten. Mit dieser Option kannst du JavaScript-Code direkt im Konfigurationspanel hinzufügen und die Ereignisverfolgung an deine Bedürfnisse anpassen.

1. Im Document360-Portal navigieren Sie in der linken Navigationsleiste zu Verbindungen () > Integrationen.
2. Wählen Sie Mixpanel aus der Liste der Integrationen und klicken Sie auf Hinzufügen. Das Panel "Neue Integration hinzufügen " erscheint.
3. Wählen Sie die Option Benutzerdefinierte Konfiguration .
4. Geben Sie eine Beschreibung für diese Integration ein.
5. Füge deinen JavaScript-Ausschnitt in das Codefeld ein. Siehe die untenstehenden Beispiele.
6. Optional erweitern Sie Code-Einschluss-/Ausschlussbedingungen , um den Code basierend auf IP-Adresse, Arbeitsbereich oder Sprache anzuwenden.
7. Klicken Sie auf Hinzufügen.

Beispiel: Laden und initialisieren Sie Mixpanel

Ersetzen Sie YOUR_PROJECT_TOKEN sie durch Ihr tatsächliches Mixpanel Project Token aus den Projekteinstellungen von 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>

Beispiel: Seitenansichtsverfolgung

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

Beispiel: Button-Click-Tracking

Ersetze yourButtonId sie durch die tatsächliche ID des Buttons, den du verfolgen möchtest, und aktualisiere "Your Button Label" mit einem sinnvollen Label. Wenn Sie zum Beispiel einen Button mit der Aufschrift "Abonnieren" verfolgen, verwenden "subscribeButton" Sie und "Subscribe".

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

Überprüfen Sie die Konfiguration

Wenn nach der Einrichtung keine Daten in Mixpanel angezeigt werden, durchlaufen Sie folgende Prüfungen:

Bestätige deinen Token

Stelle sicher, dass du das Mixpanel Project Token eingegeben hast und nicht die Projekt-ID oder das API-Geheimnis.

Überprüfen Sie die Quelle der Seite

1. Öffnen Sie Ihre Wissensdatenbank in einem Browser.
2. Rechtsklicke irgendwo auf der Seite und wähle "Seite anzeigen" (Verknüpfung: Ctrl + U unter Windows/Linux, ⌘+ Option+ U auf Mac).
3. Drücke Ctrl + F / ⌘ + F und suche nach mixpanel. Wenn du es nicht findest, wurde das Mixpanel-Integrationsskript nicht eingeschleust.

Schau im Netzwerk-Tab nach

1. Öffnen Sie Ihre Wissensdatenbank in einem Browser.
2. Drücke F12 (Windows/Linux) oder ⌘ + Option + I (Mac), um Developer Tools zu öffnen.
3. Gehe zum Netzwerk-Reiter .
4. In der Filterbox tippen api.mixpanel.comSie .
5. Laden Sie die Seite neu oder führen Sie eine Aktion aus, wie zum Beispiel einen Artikel anzusehen. Wenn du Anfragen api.mixpanel.comsiehst, werden Ereignisse gesendet. Wenn keine Anfragen angezeigt werden, lädt die Mixpanel-Bibliothek nicht oder Ereignisse werden blockiert.

Blocker ausschließen

Suchen Sie nach Werbeblockern, Cookie-Consent-Bannern oder restriktiven Content Security Policies (CSP). Diese können verhindern, dass Mixpanel Daten lädt oder sendet.

Workaround mit benutzerdefiniertem HTML

Wenn das Mixpanel-Integrationsskript nicht korrekt über die native Integration geladen wird, kannst du es stattdessen als benutzerdefinierte HTML-Integration hinzufügen.

1. Im Document360-Portal navigieren Sie in der linken Navigationsleiste zu Verbindungen () > Integrationen ().
2. Wählen Sie benutzerdefiniertes HTML aus der Liste der Integrationen und klicken Sie auf Hinzufügen. Das Panel "Neue Integration hinzufügen " erscheint.
3. Füge den Mixpanel-Bibliothekssnippet ein (siehe oben "Mixpanel laden und initialisieren").
4. Füge deinen benutzerdefinierten Event-Tracking-Code unter den Initialisierungsausschnitt hinzu.
5. Klicken Sie auf Hinzufügen und testen Sie erneut in Mixpanel.

Best Practices

• Nutze die Grundkonfiguration, es sei denn, du brauchst eine benutzerdefinierte Event-Tracking. Für die meisten Wissensdatenbanken reicht es aus, das Projekttoken unter der Basiskonfiguration einzugeben, um Seitenaufrufe zu verfolgen.
• Initialisieren Sie immer die Mixpanel-Bibliothek, bevor Sie Tracking-Funktionen aufrufen. In der benutzerdefinierten Konfiguration fügen Sie zuerst den vollständigen Bibliotheksinitialisierungssnippet ein und fügen Sie dann Ihren Event-Tracking-Code darunter hinzu.
• Teste in einem inkognitoartigen Fenster nach dem Speichern. Browser-Caching kann dazu führen, dass veraltete Skripte ausgeführt werden, was den Eindruck erweckt, als hätten Änderungen keine Wirkung gezeigt.
• Verwenden Sie Code-Einschluss-/Ausschlussbedingungen, um internen Datenverkehr auszuschließen. Fügen Sie Ihre Büro-IP-Adresse als Ausschluss hinzu, um zu verhindern, dass Teambesuche Ihre Analysedaten verzerren.
• Umbenennt Ereignisse, um zu eurer Namenskonvention zu passen. Mixpanel-Ereignisnamen sind groß- und schreibungsabhängig und erscheinen in Ihrem Dashboard so, wie sie sind. Verwenden Sie konsistente, beschreibende Namen wie "Artikel angesehen" statt "Seitenansicht", um Ihre Daten lesbarer zu machen.

FAQ