Mixpanel mit Elido verbinden

Elido sendet bei jedem Klick auf einen Ihrer Kurzlinks ein link_click-Ereignis an die Ingestion-API von Mixpanel. Wenn Ihr Team bereits mit Mixpanel arbeitet, wird das Link-Engagement neben Ihren Produkt-Ereignissen angezeigt, ohne dass Sie irgendwo ein Tracking-Skript hinzufügen müssen.

Es werden nur Klicks weitergeleitet. Die Weiterleitung von Conversion-Ereignissen an Mixpanel ist geplant.

Was Sie benötigen

• Ein Mixpanel-Projekt.
• Das Project Token des Projekts. Nach dem Modell von Mixpanel ist es kein Geheimnis, Elido speichert es trotzdem verschlüsselt.
• Sie müssen die Datenresidenz Ihres Projekts kennen: US, EU oder Indien.
• Die Rolle Admin oder Owner in Ihrem Elido-Workspace (die Berechtigung conversions.manage).

Schritt 1: Project Token und Datenresidenz finden

1. Melden Sie sich bei Mixpanel an und öffnen Sie Settings → Project Settings.
2. Kopieren Sie unter Access Keys das Project Token. Verwenden Sie nicht das API Secret oder ein Dienstkonto, Elido benötigt beides nicht.
3. Prüfen Sie den Wert Data Residency des Projekts. Diesen wählen Sie auch in Elido aus.

Schritt 2: In Elido verbinden

1. Gehen Sie zu Dashboard → Integrations → Mixpanel.
2. Klicken Sie auf Connect Mixpanel.
3. Fügen Sie das Token in Project Token ein.
4. Setzen Sie Data residency passend zu Ihrem Projekt:
   • United States sendet an api.mixpanel.com (der Standard).
   • EU sendet an api-eu.mixpanel.com.
   • India sendet an api-in.mixpanel.com.
5. Klicken Sie auf Save. Das Panel zeigt nun Connected und das Token, maskiert bis auf die ersten und letzten vier Zeichen.

Die Weiterleitung gilt für jeden Link im Workspace, es gibt keine Einstellung pro Link. Sie beginnt etwa 5 Minuten nach dem Speichern. Ein geändertes Token oder eine geänderte Datenresidenz sowie das Trennen der Verbindung werden innerhalb desselben Zeitraums wirksam.

Schritt 3: Verbindung testen

Klicken Sie auf Test connection. Elido sendet ein link_click-Ereignis mit elido_test: true und dem Slug _test und zeigt Mixpanels Antwort unter der Schaltfläche an: den HTTP-Status, den Host, an den die Anfrage gesendet wurde, und den Antworttext.

Ein erfolgreicher Test ist kein Beweis. Mixpanels /track-Endpunkt prüft nicht, ob das Token gültig ist oder ob das Projekt in dieser Datenresidenz liegt. Deshalb können ein falsches Token oder die falsche Region den Test trotzdem bestehen. Ein Fehlschlag ist dagegen aussagekräftig: Mixpanel hat das Ereignis abgelehnt, und die Meldung erklärt den Grund.

Was Elido sendet

Aus jedem Klick wird ein Ereignis:

{
  "event": "link_click",
  "properties": {
    "token": "your-project-token",
    "distinct_id": "elido-link-4711",
    "time": 1789000000,
    "workspace_id": 42,
    "link_id": 4711,
    "slug": "spring-26",
    "destination": "https://example.com/spring",
    "country": "DE",
    "device": "mobile",
    "ip": "203.0.113.7"
  }
}

• distinct_id ist elido-link- plus die Link-ID. Dadurch gibt es einen Wert pro Link, nicht pro Besucher.
• time ist der Zeitpunkt des Klicks in Unix-Sekunden.
• destination ist die URL, an die der Besucher weitergeleitet wurde.
• country ist ein zweistelliger Ländercode und device der Gerätetyp.
• ip ist die IP-Adresse des Besuchers; Mixpanel verwendet sie für die eigene Geolokalisierung.
• Das Testereignis fügt elido_test: true hinzu.

Jeder aufgezeichnete Klick wird weitergeleitet, auch Klicks, die Elidos Analyse als verdächtig oder als Bot-Traffic kennzeichnet. Wenn Mixpanel nicht erreichbar ist, versucht Elido die Zustellung nach einer Sekunde noch einmal und verwirft das Ereignis anschließend. Es gibt keinen Rückstand und keinen Replay. Eine Beschreibung jedes Feldes und Ideen für Berichte finden Sie unter Mixpanel link_click events.

Wie distinct_id funktioniert und welche Grenzen es gibt

Da distinct_id pro Link vergeben wird, zählt jeder Klick auf denselben Link als derselbe Mixpanel-"Benutzer". Das bedeutet:

• Uniques bei link_click zählen Links, nicht Personen. Verwenden Sie stattdessen die Gesamtzahl der Ereignisse.
• Funnels von link_click zu Ihrem Registrierungs- oder Kaufereignis werden nicht zusammengeführt, weil diese Ereignisse zu einer anderen distinct_id gehören.
• Mixpanels Hot-Shard-Limit gilt pro distinct_id. Deshalb würde es zuerst bei einem einzigen sehr stark frequentierten Link greifen.

Um heute eine Person vom Klick bis zur Registrierung zu verfolgen, fügen Sie der Ziel-URL UTM-Tags hinzu und lassen Sie das Mixpanel-SDK auf Ihrer Landingpage diese erfassen. Identifizieren Sie den Benutzer anschließend wie gewohnt dort.

Fehlerbehebung

Test connection ist erfolgreich, aber in Mixpanel wird nichts angezeigt. Prüfen Sie zuerst das Token: Kopieren Sie es erneut unter Settings → Project Settings → Access Keys. Prüfen Sie anschließend Data residency anhand der Einstellung des Projekts. Beide Fehler lassen den Test wie oben beschrieben erfolgreich bestehen.

Test connection schlägt fehl. Lesen Sie den Fehler und den Antworttext unter der Schaltfläche, sie kommen direkt von Mixpanel. Korrigieren Sie Token oder Datenresidenz, klicken Sie auf Update key, speichern Sie und testen Sie erneut.

Ereignisse landen im falschen Projekt. Token gelten pro Projekt. Wenn Sie mehrere Projekte haben, vergewissern Sie sich, dass Sie das Token aus dem gewünschten Projekt kopiert haben.

Echte Klicks erscheinen direkt nach dem Verbinden nicht. Die Weiterleitung kann bis zu etwa 5 Minuten benötigen, bevor sie startet. Klicken Sie danach auf einen Kurzlink und prüfen Sie die Ansicht Events.

Mixpanel-Benutzer stimmen nicht mit Ihren identifizierten Benutzern überein. Das ist erwartetes Verhalten: Elidos distinct_id gilt pro Link. Eine UTM-Lösung finden Sie im Abschnitt oben.