Klaviyo-Link-Tracking: Kurzlink-Klicks als benutzerdefinierte Metrik

Das Klaviyo-Link-Tracking über Elido läuft serverseitig und nur in eine Richtung: Jeder Klick auf einen Ihrer Kurzlinks wird als Event einer benutzerdefinierten Metrik namens Elido Link Click an Klaviyos Events API gesendet. Das Event enthält den Link-Slug und die Link-ID, Land und Gerät, das Ziel, zu dem der Besucher weitergeleitet wurde, sowie den Zeitpunkt des Klicks. Die Metrik wird bei der ersten Verwendung erstellt, und Sie können sie wie jede andere Metrik als Diagramm darstellen, filtern und für Berichte verwenden.

Was dabei nicht passiert: Der Klick wird nicht auf dem Profil eines Abonnenten abgelegt. Jedes Event ist über eine anonyme ID dem Link zugeordnet. Daher erscheint ein von 4.000 Personen geklickter Link in Klaviyo als ein anonymes Profil mit 4.000 Events in seiner Chronik. Diese eine Tatsache bestimmt, wofür die Integration geeignet ist. Ich gehe das Payload, die Einrichtung, die Möglichkeiten für Flows und Segmente sowie den Vergleich mit Klaviyos nativem Klick-Tracking durch.

Wenn Ihre Links noch nicht einheitlich gekennzeichnet sind, korrigieren Sie das zuerst. Der Cornerstone-Artikel zum durchgängigen Tracking mit UTMs beschreibt die Konvention, und Klaviyo sieht immer nur das, was der Link mitführt.

Was Elido bei jedem Klick an Klaviyo sendet

Ein Klick, ein POST. Die Weiterleitung ruft https://a.klaviyo.com/api/events/ mit Ihrem privaten Schlüssel im Header Authorization: Klaviyo-API-Key und einem Header revision: 2023-02-22 auf. Das ist der in Klaviyos Create-Event-Referenz dokumentierte Endpunkt.

Hier ist der vollständige Body mit Beispielwerten:

{
  "data": {
    "type": "event",
    "attributes": {
      "time": "2026-09-21T09:14:22Z",
      "properties": {
        "workspace_id": 12,
        "link_id": 4711,
        "slug": "autumn-drop",
        "country": "DE",
        "device": "mobile",
        "destination": "https://shop.example/autumn?utm_source=instagram",
        "ip": "203.0.113.24"
      },
      "metric": {
        "data": {
          "type": "metric",
          "attributes": { "name": "Elido Link Click" }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": { "anonymous_id": "elido-link-4711" }
        }
      }
    }
  }
}

Das ist alles. Keine E-Mail-Adresse, keine Telefonnummer, keine UTM-Felder als separate Eigenschaften, kein Referrer und kein Browser.

Einige Details werden wichtig, sobald Sie filtern. destination ist die URL, die dieser Besucher nach allen Routing-Regeln eines Smart Links tatsächlich erhalten hat. Ein Link, der iPhones in den App Store und alle anderen Besucher in Ihren Shop sendet, erzeugt daher zwei Zielwerte. device ist entweder mobile, tablet oder desktop. UTM-Tags existieren nur innerhalb des Strings destination, daher ist eine direkte Filterung nach utm_campaign nicht möglich. Filtern Sie stattdessen nach slug, was meist ohnehin der sauberere Schlüssel ist.

Crawler, die sich in ihrem User-Agent zu erkennen geben, werden an der Weiterleitung verworfen und nie weitergeleitet. Klicks, die Elidos eigene Heuristiken als verdächtig markieren, werden trotzdem gesendet, und das Event enthält keine Eigenschaft, die darauf hinweist.

Ein anonymes Profil pro Link und warum

Jedes Klaviyo-Event muss ein Profil benennen, das über eine E-Mail-Adresse, eine Telefonnummer, eine externe ID, eine Klaviyo-ID oder eine anonymous_id identifiziert wird. Elido sendet immer die letzte Variante, gebildet aus elido-link- und der Link-ID.

Damit geht jeder Klick auf autumn-drop an dasselbe Profil. Der erste Klick erstellt es, und jeder weitere wird an seine Chronik angehängt.

Das hat drei Folgen, und die dritte hat mich überrascht.

Erstens funktionieren Zählungen, aber die Personen bleiben unbekannt. Gesamtklicks sowie Klicks pro Link, Land und Gerät funktionieren. Alles, was als "unique" bezeichnet wird, zählt Links und keine Menschen.

Zweitens hat das anonyme Profil weder E-Mail-Adresse noch Telefonnummer. Es kann in einem Segment enthalten sein, aber keine Nachricht empfangen.

Drittens werden Klicks in derselben Sekunde zusammengefasst. Die Weiterleitung sendet keine unique_id, und Klaviyos Referenz besagt, dass ohne eine solche ID für dasselbe Profil und dieselbe Metrik nach dem Event-Zeitpunkt bis auf die Sekunde dedupliziert wird. Da das Profil pro Link gilt, werden zwei Personen, die innerhalb derselben Sekunde auf denselben Link klicken, zu einem Event. Bei einem Newsletter-Link, bei dem die Klicks langsam eintreffen, werden Sie das nie bemerken. Bei einem Link in einer großen Instagram-Story, bei dem zu Spitzenzeiten mehrere Klicks pro Sekunde eintreffen, liegt die Klaviyo-Zahl unter der Zahl in Ihren Elido-Klickanalysen. Der Vorteil: Der eine erneute Zustellversuch der Weiterleitung kann nicht doppelt zählen, weil ein erneut gesendetes Event denselben Zeitpunkt hat.

Warum keine ID pro Besucher? Die Weiterleitung weiß nicht, wer der Besucher ist, und ich möchte lieber kein Cookie auf einer Domain ablegen, die der Besucher nie bewusst aufgerufen hat. Das ist derselbe Kompromiss wie beim Mixpanel-Link-Tracking, bei dem distinct_id aus demselben Grund pro Link gilt.

Klaviyo-Link-Tracking in Elido einrichten

Die Einrichtung besteht aus einem Feld.

1. Gehen Sie in Klaviyo zu Settings und dann zu API keys und erstellen Sie einen privaten API-Schlüssel. Die Create Event-Referenz führt events:write als benötigten Bereich auf. Elidos Hinweise zur Einrichtung in der App nennen außerdem profiles:write; ich würde mit events allein beginnen und den zweiten Bereich hinzufügen, falls Klaviyo 403 zurückgibt.
2. Öffnen Sie in Ihrem Elido-Workspace Integrations, wählen Sie die Klaviyo-Karte aus und klicken Sie auf Connect Klaviyo.
3. Fügen Sie den Schlüssel in Private API Key ein und speichern Sie. Elido verschlüsselt ihn im Ruhezustand und zeigt ihn danach nur noch maskiert an.
4. Warten Sie etwa fünf Minuten. Integrationseinstellungen werden auf der Seite der Weiterleitung zwischengespeichert, daher werden die ersten Klicks nach dem Speichern möglicherweise nicht gesendet.
5. Klicken Sie auf einem Telefon auf einen Ihrer eigenen Links. Öffnen Sie dann in Klaviyo Analytics > Metrics und suchen Sie nach Elido Link Click.

Die Schaltfläche Test connection sendet ein Test-Event (gekennzeichnet mit elido_test: true) an Klaviyo und zeigt Klaviyos Antwort an. Daher schlägt ein widerrufener oder schreibgeschützter Schlüssel direkt dort fehl. Damit wird bewiesen, dass der Schlüssel funktioniert, nicht dass die Metrik auf dem erwarteten Profil landet. Dass die Metrik nach einem echten Klick in Klaviyo erscheint, ist der Beleg.

Es gibt keinen Schalter pro Link. Jeder Klick im Workspace wird weitergeleitet, auch bei Links, die Sie nie für Marketing vorgesehen hatten. Agenturen mit vielen Kunden sollten jedem Kunden einen eigenen Workspace geben, bevor sie etwas verbinden.

Klaviyos natives Klick-Tracking im Vergleich zur Elido-Metrik

Klaviyo erfasst bereits Klicks in seinen eigenen E-Mails und Textnachrichten, und für Aufgaben auf Abonnentenebene ist dieses native Tracking überlegen. Es schreibt jeden Link über seine Tracking-Domain um, erfasst Clicked Email oder Clicked SMS auf dem Empfängerprofil und markiert wahrscheinliche Scanner mit einer Bot Click-Eigenschaft, die Sie aus Berichten ausschließen können.

Die Elido-Metrik ist überall sonst sinnvoll: beim Link in Ihrer Instagram-Bio, bei einem QR-Code auf der Verpackung, bei einem Link, den ein Partner aus seinem eigenen Newsletter sendet, oder bei einem Link in den Shownotes eines Podcasts. Keiner dieser Klicks läuft durch Klaviyos Tracker. Mit aktivierter Weiterleitung erscheinen sie im selben Konto wie Ihre E-Mail-Metriken. So kann ein Klaviyo-Dashboard "auf den Herbst-Link von überall geklickt" neben "auf die Herbst-E-Mail geklickt" stellen.

Achten Sie auf eine Wechselwirkung. In Live-E-Mails hängt Klaviyo an jeden Link einen _kx-Parameter an, damit sein Onsite-Skript den Klickenden auf Ihrer Website identifizieren kann. Wenn der Link in Ihrer E-Mail ein Elido-Kurzlink ist, landet _kx auf der Kurz-URL, und Elidos Weiterleitung überträgt eingehende Query-Parameter nicht an das Ziel. Die Onsite-Identifizierung geht verloren. Meine Regel: Verlinken Sie innerhalb von Klaviyo-E-Mails direkt auf Ihre eigene Website und lassen Sie Klaviyo den Klick erfassen. Verwenden Sie Kurzlinks für die Kanäle, die Klaviyo nicht erreicht.

Klicks auf echte Abonnentenprofile bringen

Manchmal soll der Klick tatsächlich einer Person zugeordnet werden. Dafür gibt es heute zwei funktionierende Wege, und keiner davon ist die Weiterleitung.

Der einfache Weg besteht darin, Klaviyos Onsite-Tracking die Identität übernehmen zu lassen. Senden Sie den gemeinsamen Kurzlink an ein Ziel mit UTM-Tags und stellen Sie sicher, dass Klaviyos JavaScript auf dieser Seite ausgeführt wird. Besucher, die bereits durch einen früheren E-Mail-Klick ein Cookie haben oder sich über ein Formular anmelden, bekommen ihre Onsite-Aktivität ihrem Profil zugeordnet. Der Kurzlink-Klick bleibt anonym, der anschließende Besuch nicht. Vergleichen Sie beides anschließend auf Kampagnenebene. Das ist gröber als eine Zuordnung pro Person, aber ehrlich in Bezug darauf, was jede Seite weiß.

Der aufwendigere Weg sind Links pro Empfänger. Erstellen Sie für eine kleine, wertvolle Liste, etwa für eine B2B-Sequenz oder VIP-Einladungen, über die API unter /v1/workspaces/{workspace_id}/links einen Kurzlink pro Person und führen Sie Ihre eigene Tabelle aus Link-ID und E-Mail-Adresse. Abonnieren Sie Link-Events über Webhooks, ermitteln Sie bei einem eingehenden Klick die E-Mail-Adresse und senden Sie Ihr eigenes Event an Klaviyo, wobei diese E-Mail-Adresse als Profilidentifikator dient. Das sind vielleicht vierzig Codezeilen, und es ist der einzige Weg, einen Elido-Klick auf einem benannten Abonnenten abzulegen. Für einen Newsletter mit 200.000 Personen würde ich das nicht tun.

Wenn Ihnen gemischte Klickzahlen aus mehreren Kanälen in Klaviyo gefehlt haben, wählen Sie einen Plan und verbinden Sie einen Workspace und leiten Sie Ihre nächste Social-Kampagne über Branded Links.

Grenzen der Weiterleitung heute

Fünf Dinge, die Sie wissen sollten, bevor ein Bericht davon abhängt.

Die Zustellung erfolgt nach bestem Bemühen. Ein fehlgeschlagenes POST wird nach einer Sekunde einmal erneut gesendet und danach verworfen. Für später wird nichts in die Warteschlange gestellt.

Die Events API ist pro Konto begrenzt: 350 Anfragen pro Sekunde in Spitzen und konstant 3.500 pro Minute. Dieses Kontingent wird mit jeder anderen App geteilt, die Events in Ihr Konto schreibt. Eine Kampagnenspitze von mehr als etwa 58 Klicks pro Sekunde über eine ganze Minute führt zu 429-Fehlern. Nach dem einen erneuten Zustellversuch sind diese Klicks in Klaviyo verloren.

Der Revisions-Header ist alt. Klaviyo lässt jede API-Revision zwei Jahre bestehen, bevor sie außer Betrieb genommen wird, und Anfragen an eine ausgemusterte Revision werden von der nächstältesten verfügbaren Revision bedient. Die Revision 2023-02-22 liegt hinter dieser Grenze, daher funktioniert die Weiterleitung heute über den Fallback auf die nächste Version. Sie funktioniert. Ich würde den Header trotzdem gern aktualisieren.

Die Besucher-IP wird als Event-Eigenschaft gesendet. Rechnen Sie damit, dass sie wie jede andere Eigenschaft gespeichert wird, und behandeln Sie sie daher in Ihrem Verzeichnis der Verarbeitungstätigkeiten als personenbezogene Daten. Der Leitfaden zur EU-Datenresidenz für Marketingteams erläutert, wie Sie das bewerten.

Nur Klicks. Conversions sind nicht Teil des Payloads. Erfassen Sie den Umsatz daher dort, wo die Kundenidentität liegt, bei den meisten Shops in Klaviyos eigener E-Commerce-Integration.

Verwandte Beiträge im Blog

• UTMs durchgängig tracken - die Kennzeichnungskonvention, von der die Zusammenführung auf Kampagnenebene abhängt.
• Mixpanel-Link-Tracking - dasselbe Muster der Weiterleitung mit derselben Identität pro Link.
• Webhooks für Link-Events - der Baustein für Klick-Events pro Empfänger.
• E-Mail-Klick-Attribution für Mailchimp, Brevo und Klaviyo - der umfassendere Blick über E-Mail-Plattformen hinweg.
• Kurzlink-Klicks im Vergleich zu GA4-Sitzungen - warum Klickzahlen und Analysesitzungen nie übereinstimmen.
• Datadog-URL-Monitoring - dieselbe Klickweiterleitung, die ein Datadog-Dashboard speist.