7 Min. LesezeitIntegrationen

Mixpanel-Link-Tracking: Short-Link-Klicks als Events

Mixpanel-Link-Tracking mit Elido: Jeder Short-Link-Klick wird zu einem serverseitigen link_click-Event. Setup, Properties, Identitätsgrenzen und wie man es verifiziert.

Marius Voß
DevRel · edge infra
Mixpanel-Link-Tracking-Diagramm: Ein Short-Link-Klick verlässt den Elido-Redirect als serverseitiges link_click-Event und landet in der Mixpanel-Events-Ansicht

Mixpanel-Link-Tracking in Elido ist serverseitig und einseitig gerichtet: Jedes Mal, wenn jemand auf einen deiner Short Links klickt, postet Elido ein link_click-Event an Mixpanels Track-Endpunkt mit deinem Projekt-Token. Das Event trägt den Link-Slug, die Link-ID, das Land und Gerät des Besuchers, das Ziel, zu dem er geschickt wurde, und einen Zeitstempel. Im Browser des Besuchers läuft nichts, also berühren Ad-Blocker und Consent-Banner es nicht.

Der Haken ist die Identität. Jedes Event ist an den Link gebunden, nicht an die Person, was bedeutet, dass du in Mixpanel den ganzen Tag Klicks zählen und segmentieren kannst, aber allein aus diesem Event einer Klickerin nicht ins Produkt folgen kannst. Ich zeige dir, wofür das gut ist, wie du es einrichtest, wie du es in der Events-Ansicht prüfst, und wo ich zu etwas anderem greifen würde.

Wenn du noch entscheidest, was du überhaupt taggen sollst, bevor irgendetwas davon relevant wird, ist der Cornerstone-Leitfaden zum durchgängigen Tracking von UTMs der bessere Startpunkt. Mixpanel sieht immer nur das, was der Link trägt.

Was Elido bei jedem Klick an Mixpanel sendet

Ein Klick, ein Event. Der Forwarder baut einen Ein-Event-Batch und postet ihn an /track auf dem Ingestion-Host, der zur Data-Residency-Einstellung der Integration passt (api.mixpanel.com für US, api-eu.mixpanel.com für EU, api-in.mixpanel.com für India), authentifiziert über das Token innerhalb der Properties - so erwartet Mixpanels Ingestion-API serverseitige Events.

Hier ist das vollständige Payload, nur um den Token-Wert gekürzt:

[
  {
    "event": "link_click",
    "properties": {
      "token": "<your project token>",
      "distinct_id": "elido-link-4711",
      "workspace_id": 12,
      "link_id": 4711,
      "slug": "spring-26",
      "country": "DE",
      "device": "mobile",
      "destination": "https://shop.example/spring?utm_source=newsletter",
      "time": 1790000000,
      "ip": "203.0.113.24"
    }
  }
]

Das ist alles. Kurze Liste, und das mit Absicht.

PropertyWas sie enthältWas du in Mixpanel damit machst
slug / link_idWelcher Short Link angeklickt wurdeBreakdown-Dimension für jeden Report
destinationDie URL, an die dieser Besucher geschickt wurde, nach etwaigen Routing-RegelnErkennen, welche Geo- oder Gerätevariante gefeuert hat
country, deviceBeim Redirect aufgelöstSegmentieren, ohne auf Mixpanels eigene Schätzung zu vertrauen
ipAdresse des BesuchersMixpanel leitet Stadt und Region ab und verwirft sie danach
distinct_idelido-link-<link_id>Lies den Identitätsabschnitt, bevor du Uniques nutzt

Zwei Details lohnen sich zu kennen. destination ist die aufgelöste URL - sendet also ein Smart Link iPhones zum App Store und alle anderen auf deine Website, siehst du beide URLs. Und UTM-Tags reisen nur innerhalb dieses Ziel-Strings mit; es gibt keine separaten Properties utm_source oder utm_campaign, willst du sie also als Spalten, brauchst du eine abgeleitete Property in Mixpanel. Das ist die eine Einrichtungsaufgabe, die ich schon am ersten Tag erledigen würde.

Offensichtliche Bots, die Crawler, die sich in ihrem User-Agent selbst verraten, werden beim Redirect gefiltert und erreichen Mixpanel nie.

Die Mixpanel-Integration einrichten

Die gesamte Einrichtung sind zwei Felder. Um Klickereignisse an Mixpanel zu senden, brauchst du ein Mixpanel-Projekt und dessen Project Token, das unter Project Settings in Mixpanel liegt; das Token ist ein Write-Key, der zum Einbetten gedacht ist, ihn bei einem Anbieter einzufügen ist also normal. Füge nicht das API-Secret ein, das ist ein anderer String und wird vom Forwarder nicht genutzt.

  1. Öffne in deinem Elido-Workspace Integrations und wähle die Mixpanel-Karte.
  2. Klicke auf Connect Mixpanel, füge das Token in Project Token ein und wähle bei Data residency: US (Standard), EU oder India, passend zum Data-Residency-Wert in deinen Mixpanel-Projekteinstellungen. Speichere. Elido verschlüsselt das Token at rest und zeigt es dir nie wieder vollständig an.
  3. Warte ein paar Minuten. Die Workspace-Integrationseinstellungen werden auf der Forwarding-Seite kurz zwischengespeichert, die ersten Klicks nach dem Speichern werden also möglicherweise noch nicht gesendet.
  4. Klicke von einem Telefon aus auf einen deiner eigenen Links.

Es gibt keinen Schalter pro Link. Einmal verbunden, wird jeder Klick im Workspace weitergeleitet, was zu einem Team passt, das in Mixpanel lebt, aber nicht zu einem Workspace, der Short Links für zwanzig unabhängige Kunden hostet. Wenn das auf dich zutrifft, trenne die Kunden zuerst in separate Workspaces auf.

Die Events-Ansicht prüfen, bevor du irgendetwas vertraust

Was Mixpanel früher Live View nannte, heißt jetzt Events-Ansicht, unter Data in der linken Navigation, und Mixpanels Debugging-Leitfaden empfiehlt sie genau für diese Aufgabe als ersten Anlaufpunkt. Öffne sie, filtere auf link_click, dann tippe auf deinen Short Link von einem Telefon, das nicht im Büro-WLAN ist.

Ablauf eines Short-Link-Klicks in Mixpanel: Der Besucher tippt auf den Link, der Elido-Redirect antwortet zuerst und erfasst den Klick, der Forwarder postet ein link_click-Event an den Mixpanel-Track-Endpunkt für die in Elido eingestellte Data-Residency-Region (US, EU oder India) mit einem Retry, und das Event erscheint in der Mixpanel-Events-Ansicht

Du solltest das Event innerhalb von Sekunden sehen. Klappe es auf und prüfe drei Dinge: slug stimmt mit dem angetippten Link überein, country entspricht dem tatsächlichen Standort des Telefons, und Mixpanels eigene Stadt- und Regionsangaben sind aus der ip befüllt. Zeigt die Stadt ein Rechenzentrum an, lief dein Test über ein VPN.

Der Test-Connection-Button im Integrationspanel sendet ein link_click-Event, markiert mit elido_test: true, und zeigt Mixpanels Antwort unter dem Button an. Nützlich, aber kein Beweis: Mixpanels Track-Endpunkt akzeptiert jedes Token und prüft die Residency nie, sodass ein grünes Ergebnis mit dem falschen Token oder der falschen Region trotzdem bedeutet, dass nichts in deinem Projekt ankommt. Das Event, das du von einem echten Klick ankommen siehst, ist der einzige Beweis, den ich akzeptieren würde.

Hier ist die Identitätsgrenze, klar ausgesprochen. distinct_id ist elido-link- plus die Link-ID, sodass jeder Klick auf spring-26 zu einem synthetischen Mixpanel-"Nutzer" gehört.

Mixpanel distinct_id pro Link: Drei verschiedene Besucher klicken auf denselben Short Link, und alle drei link_click-Events teilen sich distinct_id elido-link-4711, sodass Mixpanel einen Nutzer zählt, während das Mixpanel-SDK auf der Landingpage drei separate Geräte mit den UTM-Tags sieht

Summen funktionieren. Breakdowns nach Slug, Land, Gerät und Ziel funktionieren, ebenso Trends über die Zeit. Drei Dinge brechen:

  • Uniques auf link_click zählen Links, nicht Personen. Eine Kampagne mit 40.000 Klicks auf zwei Links zeigt zwei eindeutige Nutzer.
  • Funnels, die bei link_click beginnen und bei deinem Signup-Event enden, verbinden sich nicht, weil das Signup zu einer anderen distinct_id gehört.

Es gibt einen dritten Punkt, auf den die meisten Teams nie stoßen. Mixpanel erzwingt Hot-Shard-Limits von 200.000 Events pro distinct_id und Tag, und darüber hinaus werden die Events zu $hotshard_events umbenannt. Ein einzelner Link, der richtig viral geht, kann diese Grenze überschreiten, und weil die ID pro Link gilt, trifft es genau diesen einen Link.

Warum keine ID pro Besucher? Weil der Redirect nicht weiß, wer der Besucher ist, und ich würde lieber vermeiden, dass er ein Cookie auf einer Domain setzt, die der Besucher nie bewusst besucht hat. Ein ehrlicher Kompromiss.

Das Muster, das funktioniert, nutzt die beiden Hälften für das, wofür jede gut ist. Lass Elidos serverseitiges Event dir die vollständige Klickzahl liefern, einschließlich Klicks von Leuten, die abspringen, bevor deine Seite lädt. Lass das Mixpanel-SDK auf deiner Landingpage die Identität übernehmen.

Setze UTM-Tags auf die Ziel-URL. Mixpanels JavaScript-Bibliothek trackt UTM-Parameter standardmäßig und speichert First-Touch-Werte am Profil, sodass, wenn sich dieser Besucher später anmeldet und du identify aufrufst, die Kampagne an einer echten Person kleben bleibt. Der Short-Link-Klick und der Landingpage-View teilen sich dann einen Kampagnenwert, keine Nutzer-ID, und du verbindest sie in einem Report über utm_campaign. Das ist ein Join auf Kampagnenebene, gröber als einer auf Nutzerebene, und ich halte das für diese Daten für die richtige Ebene.

Willst du Klickzahlen und Landingpage-Sessions nebeneinander sehen? Erwarte, dass sie nicht übereinstimmen; Short-Link-Klicks versus GA4-Sessions erklärt, warum dieselbe Lücke in jedem Analytics-Tool auftaucht, Mixpanel eingeschlossen.

Wenn das die Einrichtung ist, die dir gefehlt hat, verbinde einen Workspace und schicke deine nächste Kampagne über Branded Links.

Wo es heute an Grenzen stößt

Drei Lücken, sortiert danach, wie wahrscheinlich sie dich treffen.

Die Besucher-IP reist in jedem Event mit. Mit EU-Residency geht sie an den EU-Ingestion-Host; beim US-Standard geht sie an einen US-Endpunkt, und der Leitfaden zur EU-Data-Residency behandelt, wie man das abwägt. Für die Mixpanel-Seite selbst, einschließlich der Prüfung der Residency Ihres Projekts, siehe Mixpanel-EU-Data-Residency.

Die Zustellung ist Best Effort. Ein fehlgeschlagener POST bekommt einen Retry nach einer Sekunde, dann wird er verworfen, und Events tragen keine $insert_id, sodass ein Retry nach einem langsamen Erfolg doppelt zählen kann.

Es gibt keinen Referrer und keinen Browser im Event, und Klicks, die der Redirect als verdächtig markiert, werden trotzdem weitergeleitet. Prüfe das Klick-Analytics-Dashboard, wenn du diese Daten brauchst.

Conversions sind nicht Teil davon. Tracke Umsatz dort, wo deine Nutzer-ID lebt.

Verwandtes im Blog

Häufig gestellte Fragen

Wie sende ich Klickereignisse von einem Short Link an Mixpanel?

Füge dein Mixpanel-Projekt-Token in die Mixpanel-Integration in deinem Elido-Workspace ein und speichere. Ab dann wird jeder Klick auf einen Link in diesem Workspace serverseitig als link_click-Event an Mixpanel gepostet, mit Slug, Link-ID, Land, Gerät und Ziel als Properties. Auf dem Redirect läuft kein JavaScript.

Welchen Event-Namen verwendet Elido in Mixpanel?

Das Event heißt link_click, und der Name ist fest. Baue deine Reports auf diesem Namen auf. Wenn ältere Elido-Seiten einen anderen Event-Namen nennen, vertraue dem, was in deiner Events-Ansicht ankommt, denn das ist der Payload, den der Forwarder tatsächlich sendet.

Kann Mixpanel einen Short-Link-Klick einer bekannten Person zuordnen?

Nicht allein aus dem weitergeleiteten Event. Elido setzt distinct_id auf einen Wert pro Link, sodass jeder Klick auf denselben Link wie derselbe Mixpanel-Nutzer aussieht. Um eine echte Person zu erreichen, setze UTM-Tags auf das Ziel und lass das Mixpanel-SDK auf deiner Landingpage sie aufnehmen, identifiziere den Nutzer dort dann wie gewohnt.

Warum tauchen meine Elido-Klicks nicht in Mixpanel auf?

Prüfe drei Dinge der Reihe nach. Das Token muss das Projekt-Token aus dem richtigen Projekt sein, nicht das API-Secret. Warte nach dem Speichern ein paar Minuten, bevor der erste Klick weitergeleitet wird. Und schließlich: Wenn dein Mixpanel-Projekt EU- oder India-Data-Residency nutzt, stelle in der Elido-Integration dieselbe Residency ein: Events, die an den falschen Ingestion-Host gesendet werden, werden gar nicht aufgenommen.

Leitet Elido auch Conversions an Mixpanel weiter?

Die Mixpanel-Integration deckt nur Klicks ab; es gibt heute kein separates Conversion-Event im Payload. Für Umsatz tracke den Kauf aus deinem eigenen Backend oder dem Mixpanel-SDK mit deiner echten Nutzer-ID. Dort lebt die Identität, sodass die Conversion auf dem richtigen Profil landet statt auf einem Platzhalter pro Link.

Speichert Mixpanel die IP-Adresse des Besuchers, die Elido sendet?

Laut Mixpanels Geolocation-Dokumentation wird die ip-Property eines Events genutzt, um Land, Region und Stadt abzuleiten, und danach verworfen, bevor das Event gespeichert wird. Du bekommst also eine Standortangabe auf Stadtebene für jeden Klick in Mixpanel, aber die IP selbst sollte nicht als abfragbare Property auftauchen.

Elido testen

URL einfügen, kurzer Link in Sekunden

Kein Konto nötig. Link bleibt 30 Tage aktiv. Konto erstellen, um ihn dauerhaft zu behalten.

Kostenlos, keine Anmeldung erforderlich · 2 pro Tag

Elido testen

URL-Shortener mit EU-Hosting: eigene Domains, tiefe Analytik und eine offene API. Kostenloser Tarif - keine Kreditkarte nötig.

Tags
mixpanel link tracking
send click events to mixpanel
mixpanel short link clicks
mixpanel server-side tracking
mixpanel distinct_id
link click analytics

Weiterlesen