8 Min. LesezeitIntegrationen

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

Mixpanel-Link-Tracking mit Elido: Jeder Short-Link-Klick wird zum serverseitigen link_click-Event. Einrichtung, Properties, Identitätsgrenzen und Prüfung.

Marius Voß
DevRel · edge infra

Mixpanel-Link-Tracking in Elido ist serverseitig und einseitig gerichtet: Jedes Mal, wenn jemand auf einen Ihrer Short Links klickt, postet Elido ein link_click-Event an Mixpanels Track-Endpunkt mit Ihrem 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 Sie in Mixpanel den ganzen Tag Klicks zählen und segmentieren können, aber allein aus diesem Event einer Klickerin nicht ins Produkt folgen können. Ich zeige Ihnen, wofür das gut ist, wie Sie es einrichten, wie Sie es in der Events-Ansicht prüfen, und wo ich zu etwas anderem greifen würde.

Wenn Sie noch entscheiden, was Sie überhaupt taggen sollen, 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.0"
    }
  }
]

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

PropertyWas sie enthältWas Sie in Mixpanel damit machen
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 Besuchers, gekürzt (IPv4 /24, IPv6 /48)Mixpanel leitet Stadt und Region ab und verwirft sie danach
distinct_idelido-link-<link_id>Lesen Sie den Identitätsabschnitt, bevor Sie Uniques nutzen

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 Ihre Website, sehen Sie beide URLs. Und UTM-Tags reisen nur innerhalb dieses Ziel-Strings mit; es gibt keine separaten Properties utm_source oder utm_campaign, wollen Sie sie also als Spalten, brauchen Sie 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 Elido-Integrationsseite für Mixpanel mit den Projekt-Verbindungswerten und den Einrichtungsschritten zum Senden von Link-Klicks als Ereignisse

Die Mixpanel-Integration einrichten

Die gesamte Einrichtung sind zwei Felder. Um Klickereignisse an Mixpanel zu senden, brauchen Sie 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ügen Sie nicht das API-Secret ein, das ist ein anderer String und wird vom Forwarder nicht genutzt.

  1. Öffnen Sie in Ihrem Elido-Workspace Integrations und wählen Sie die Mixpanel-Karte.
  2. Klicken Sie auf Connect Mixpanel, fügen Sie das Token in Project Token ein und wählen Sie bei Data residency: US (Standard), EU oder India, passend zum Data-Residency-Wert in Ihren Mixpanel-Projekteinstellungen. Speichern Sie. Elido verschlüsselt das Token at rest und zeigt es Ihnen nie wieder vollständig an.
  3. Warten Sie 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. Klicken Sie von einem Telefon aus auf einen Ihrer 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 Sie zutrifft, trennen Sie die Kunden zuerst in separate Workspaces auf.

Die Events-Ansicht prüfen, bevor Sie irgendetwas vertrauen

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. Öffnen Sie sie, filtern Sie auf link_click, dann tippen Sie auf Ihren 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.

Sie sollten das Event innerhalb von Sekunden sehen. Klappen Sie es auf und prüfen Sie 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 gekürzten ip befüllt, behandeln Sie sie also als ungefähr. Zeigt die Stadt ein Rechenzentrum an, lief Ihr 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 Ihrem Projekt ankommt. Das Event, das Sie von einem echten Klick ankommen sehen, ist der einzige Beweis, den ich akzeptieren würde.

Drei Mixpanel-Reports, die Sie zuerst bauen sollten

Sobald der erste echte Klick auftaucht, widerstehen Sie dem Drang, ein Dashboard für alles zu bauen. Diese drei Reports nutzen nur, was das Event mitbringt, und sie beantworten die Fragen, die Leute tatsächlich zu Short Links stellen.

  1. Klicks pro Link. Wählen Sie in Insights link_click, messen Sie Total Events und gliedern Sie nach slug. Das ist Ihre Rangliste, und sie funktioniert, weil slug eine einfache Property an jedem Event ist.
  2. Klicks nach Land und Gerät. Dasselbe Event, gegliedert nach country und dann device. Weil beides bei der Weiterleitung ermittelt wird, ist innerhalb eines Tages sichtbar, wenn eine deutschsprachige Kampagne überwiegend am Desktop in einem anderen Land landet.
  3. Welches Ziel ausgelöst wurde. Gliedern Sie bei einem Smart Link mit mehreren Zielen nach destination. Jede Variante erscheint als eigener Wert, sodass Sie die Aufteilung zwischen App Store, Play Store und Web-Fallback sehen.

Nehmen Sie in allen dreien Total Events, nicht Unique Users. Wie der nächste Abschnitt erklärt, zählen Uniques bei diesem Event Links, nicht Personen. Wenn Sie eine UTM-Spalte wollen, legen Sie in Mixpanel eine benutzerdefinierte Property an, die die Kampagne aus destination auslesen, und gliedern Sie danach. Mixpanels Hinweise zum Tracking-Plan lohnen einen kurzen Blick, bevor Sie mehr hinzufügen, denn ein sauberer Event-Name und wenige Properties halten Reports auch nach einem Jahr lesbar.

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 Ihrem 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. Lassen Sie Elidos serverseitiges Event die vollständige Klickzahl liefern, einschließlich Klicks von Leuten, die abspringen, bevor Ihre Seite lädt. Lassen Sie das Mixpanel-SDK auf Ihrer Landingpage die Identität übernehmen.

Setzen Sie 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 Sie identify aufrufen, 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 Sie verbinden 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.

Wollen Sie Klickzahlen und Landingpage-Sessions nebeneinander sehen? Erwarten Sie, 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 Ihnen gefehlt hat, verbinden Sie einen Workspace und schicken Sie Ihre nächste Kampagne über Branded Links.

Wo es heute an Grenzen stößt

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

Die gekürzte Besucher-IP reist in jedem Event mit (leer, wenn der Workspace den Modus ohne personenbezogene Daten einschaltet). 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üfen Sie das Klick-Analytics-Dashboard, wenn Sie diese Daten brauchen.

Conversions sind nicht Teil davon. Tracken Sie Umsatz dort, wo Ihre Nutzer-ID lebt.

Verwandtes im Blog

Häufig gestellte Fragen

Wie sende ich Klickereignisse von einem Short Link an Mixpanel?

Fügen Sie Ihr Mixpanel-Projekt-Token in die Mixpanel-Integration in Ihrem Elido-Workspace ein und speichern Sie. 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. Bauen Sie Ihre Reports auf diesem Namen auf. Wenn ältere Elido-Seiten einen anderen Event-Namen nennen, vertrauen Sie dem, was in Ihrer 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, setzen Sie UTM-Tags auf das Ziel und lassen Sie das Mixpanel-SDK auf Ihrer Landingpage sie aufnehmen, identifizieren Sie den Nutzer dort dann wie gewohnt.

Warum tauchen meine Elido-Klicks nicht in Mixpanel auf?

Prüfen Sie drei Dinge der Reihe nach. Das Token muss das Projekt-Token aus dem richtigen Projekt sein, nicht das API-Secret. Warten Sie nach dem Speichern ein paar Minuten, bevor der erste Klick weitergeleitet wird. Und schließlich: Wenn Ihr Mixpanel-Projekt EU- oder India-Data-Residency nutzt, stellen Sie 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 tracken Sie den Kauf aus Ihrem eigenen Backend oder dem Mixpanel-SDK mit Ihrer 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?

Elido sendet die IP bereits gekürzt (IPv4 auf /24, IPv6 auf /48). 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. Sie bekommen also eine ungefähre 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.

Keine Anmeldung nötig. Kostenlos registrieren für 50 Links im Monat.

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