Meta Conversions API für Kurzlinks: Was heute funktioniert

Elido leitet heute keine Conversions an die Conversions API von Meta weiter. Wenn Sie aus der Integrationsliste hierher gekommen sind und einen Schalter erwartet haben, gibt es keinen, und ich sage das lieber gleich, als Sie auf einen Einrichtungsweg zu schicken, der ins Leere führt. Im Folgenden steht, was Elido erfasst, was die Dokumentation von Meta (abgerufen am 2026-10-25) verlangt und wie Sie den serverseitigen Aufruf selbst bauen, mit oder ohne Kurzlink im Pfad.

Kurzfassung: Elido liefert Klicks pro Link und, bei Shopify und Stripe, Umsatz pro Link. Meta will ein Event mit einer event_id, gehashten Kundendaten und idealerweise der Klick-ID fbc. Das setzen Sie selbst zusammen.

Was Elido für Meta heute tut und was nicht

So ist der Stand des Codes, geprüft im Repository am 2026-10-25:

• Meta-Pixel-ID: Ein Workspace kann eine speichern. Sie wird für das Browser-Pixel auf den Splash- und Interstitial-Seiten von Elido verwendet. Das ist ein Tag im Browser, nicht CAPI.
• Serverseitiger Meta-Aufruf: Die Klick-Pipeline enthält einen Meta-Codepfad, der ein PageView mit IP und User Agent senden würde. Er läuft nur, wenn sowohl eine Pixel-ID als auch ein Access Token existieren, und die Einstellungen speichern nie ein Token, sodass er nie feuert.
• Conversions: Bestellungen kommen nur über Shopify- und Stripe-Webhooks an und werden über einen von Ihnen übergebenen Wert elido_link_id einem Link zugeordnet. Es gibt keinen öffentlichen Conversions-Endpunkt und weder einen Klick-ID-Header noch ein Cookie.
• fbclid: Elido erfasst oder leitet sie nicht weiter.

Die Feature-Seite zum Conversion-Tracking beschreibt dasselbe Webhook-Modell. Behandeln Sie ältere Texte, die eine Weiterleitung an Meta mit einem Aufruf versprechen, als Beschreibung eines Plans, nicht eines Produkts.

Demo-Workspace mit synthetischen Beispieldaten, keine Kundenergebnisse.

Dieser Bildschirm hilft neben Meta trotzdem. Der Umsatz pro Kampagne aus Ihren eigenen Bestellungen prüft, was der Ads Manager behauptet. Beide stimmen selten auf den Cent überein.

Wie die Conversions API von Meta funktioniert

Laut der Conversions-API-Dokumentation von Meta (abgerufen am 2026-10-25) senden Sie einen POST an https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events mit einem Access Token. Das aktuelle Beispiel der Doku verwendet v26.0. Einige Grenzen, die Sie vor dem Programmieren kennen sollten:

• Eine Anfrage kann bis zu 1.000 Events enthalten.
• event_time darf bis zu 7 Tage alt sein. Ist ein Event im Batch älter, lehnt Meta die gesamte Anfrage ab.
• Senden Sie mit jedem Event eine event_id. Sieht Meta dieselbe event_id mit demselben event_name zweimal, behält es die erste Kopie, was Wiederholungen (Retries) unbedenklich macht.

Für das Token empfiehlt der Einstiegsleitfaden von Meta (abgerufen am 2026-10-25), es im Events Manager zu erzeugen: Pixel auswählen, Einstellungen öffnen und im Bereich Conversions API "Generate access token" nutzen. Dieser Link ist nur für Nutzer mit Entwicklerrechten für das Unternehmen sichtbar. Bewahren Sie das Token als Server-Secret auf.

Selbst bauen, Schritt für Schritt

Die Schritte sind dieselben, ob der Klick von einem Kurzlink, einem QR-Code oder einer direkten Anzeige kam.

1. Klick-ID aufbewahren. Der fbp-und-fbc-Leitfaden von Meta (abgerufen am 2026-10-25) sagt, fbclid sei serverseitig aus der Landing-URL zu lesen, wenn sie vorhanden ist, und als fb.1.<creation time in ms>.<fbclid> zu formatieren. Speichern Sie das als fbc-Wert bei der Session des Besuchers und kopieren Sie es dann in die Bestellung. Speichern Sie auch den Wert des Cookies _fbp, falls der Pixel eines gesetzt hat.
2. Event-ID wählen. Nehmen Sie die Bestell-ID und verwenden Sie denselben String im Aufruf des Browser-Pixels (eventID) und im Server-Event (event_id). Zwei verschiedene Formate für dieselbe Bestellung, etwa ord_98231 und 98231, werden nicht dedupliziert.
3. Normalisieren und hashen. Laut den Kundeninformations-Parametern von Meta (abgerufen am 2026-10-25) wird die E-Mail getrimmt und kleingeschrieben und dann mit SHA-256 gehasht. Telefonnummern verlieren Symbole, Buchstaben und führende Nullen und müssen vor dem Hashen die Ländervorwahl enthalten. fbc, fbp und client_ip_address werden nie gehasht.
4. Event senden, wenn die Bestellung bezahlt ist, aus Ihrem Backend oder Ihrem Order-Webhook-Handler.
5. In Test Events prüfen, dann den Testcode entfernen.

Ein minimales Node-Beispiel:

import { createHash } from "node:crypto";

const sha256 = (v) => createHash("sha256").update(v).digest("hex");

const event = {
  event_name: "Purchase",
  event_time: Math.floor(Date.now() / 1000),
  event_id: order.id, // same string the browser pixel uses as eventID
  action_source: "website",
  event_source_url: order.thankYouUrl,
  user_data: {
    em: [sha256(order.email.trim().toLowerCase())],
    fbc: order.fbc,
    fbp: order.fbp,
    client_ip_address: order.ip,
    client_user_agent: order.userAgent,
  },
  custom_data: { currency: "EUR", value: 89.5 },
};

await fetch(
  `https://graph.facebook.com/v26.0/${PIXEL_ID}/events?access_token=${TOKEN}`,
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ data: [event] }),
  },
);

Fügen Sie dem Body beim Testen test_event_code hinzu. Loggen Sie in Produktion nicht die vollständige URL, denn sie enthält das Token.

Deduplizierung und Test Events, die zwei Fallen

Der Deduplizierungs-Leitfaden von Meta (abgerufen am 2026-10-25) beschreibt den Abgleich über event_id plus event_name, wobei die eventID des Pixels mit der event_id des Servers innerhalb eines 48-Stunden-Fensters verglichen wird. Er sagt, das funktioniere vor allem dann, wenn das Browser-Event zuerst eintrifft und das Server-Event folgt. Außerdem findet gar keine Deduplizierung statt, wenn Sie nur eine Quelle nutzen.

Das Test-Events-Tool hat eine Falle. Der test_event_code ist nur zum Testen gedacht, und die Seite zur Nutzung der API von Meta stellt klar, dass damit gesendete Events nicht verworfen werden: Sie fließen in den Events Manager und werden für Targeting und Messung genutzt. Ein "harmloser" Testkauf über 500 EUR zählt also trotzdem. Senden Sie ein paar kleine Test-Events und entfernen Sie den Code aus dem Produktions-Payload.

Nachdem Sie mit dem Senden begonnen haben, sollten sich Events laut Meta innerhalb von etwa 20 Minuten in der Übersicht des Events Managers verifizieren lassen. Prüfen Sie, dass der Event-Name zu dem passt, was Ihr Pixel sendet, und dass das Event zugeordnete Nutzerdaten zeigt.

Wo ein Kurzlink ins Spiel kommt

Ein Kurzlink ändert nichts an der Funktionsweise von CAPI. Er ist an zwei Stellen relevant, und nur an zwei.

Erstens die Klick-ID. Meta hängt fbclid an die Ziel-URL, die Sie in der Anzeige setzen. Ist dieses Ziel ein Kurzlink, kommt der Parameter beim Kurzlink an. Ich habe im Redirect-Pfad von Elido keinen Code gefunden, der den eingehenden Query-String ans Ziel kopiert. Für Meta-Anzeigen würde ich die Anzeige daher auf die finale Landing-URL mit UTMs richten und Kurzlinks für E-Mail, SMS, QR-Codes und organische Posts behalten. Wollen Sie dennoch einen Kurzlink in einer Anzeige, testen Sie ihn zuerst mit einem Dummy-?fbclid=test und prüfen Sie, was Ihre Landing Page empfängt.

Zweitens das Reporting. Taggen Sie den Shopify- oder Stripe-Checkout mit elido_link_id. Der Conversions-Report von Elido zeigt dann Umsatz pro Link und Kampagne, aus Ihren eigenen Bestellungen. Die Shopify-Anleitung behandelt die Webhook-Seite. Warum reines Zählen im Browser Events verliert, erklären serverseitiges Conversion-Tracking und Cookieless Attribution erklärt.

Einwilligung und Datenschutz

Hashing ist keine Anonymisierung. Ein SHA-256-Hash einer E-Mail-Adresse ist unter der DSGVO weiterhin ein personenbezogenes Datum, weil Meta ihn mit den eigenen Datensätzen abgleichen kann. In der EU brauchen Sie eine Rechtsgrundlage, die bei Werbemessung normalerweise eine Einwilligung ist, und der Server-Aufruf sollte dieselbe Entscheidung respektieren, die der Besucher in Ihrem Banner getroffen hat. Consent Mode v2 für Tracking und Schrems II und Tracking-Pixel behandeln die Fragen zu Einwilligung und Datenübermittlung. Hat ein Besucher abgelehnt, senden Sie nichts.

Was in Elido fehlt

Die Weiterleitung von Käufen an Meta mit einem einzigen Aufruf, das Erfassen von fbclid beim Redirect und ein Feld für das Access Token in den Meta-Einstellungen sind alle nicht gebaut. Sie stehen im Produkt-Backlog, und dieser Beitrag ändert sich, sobald sie erscheinen. Bis dahin ist das ehrliche Setup das oben beschriebene: Ihr Server sendet das Event, und Elido liefert die Klick- und Umsatzdaten auf Link-Ebene drumherum.

Weitere Beiträge im Blog

• Serverseitiges Conversion-Tracking
• Klick-IDs: gclid und fbclid
• UTMs Ende-zu-Ende tracken
• Link-Retargeting erklärt
• Shopify-URL-Shortener