Zum Inhalt springen
Guides · Tracking

Conversion API einrichten: Meta, Google Ads, TikTok und LinkedIn für Lead-Gen

So richtest du Conversion APIs für Meta, Google Ads, TikTok und LinkedIn ein: welche Events und Daten du sendest, wie Deduplizierung klappt, wie du testest.

Daniel Kalcher14 Min. Lesezeit

Diese Anleitung ist für alle, die Leads über Meta, Google Ads, TikTok oder LinkedIn gewinnen und ihre Conversions serverseitig an die Plattformen senden wollen, ob selbst programmiert, per Tag-Manager-Server oder mit einem Tool. Du erfährst, welche Events und Daten du sendest, wie du doppelte Zählungen vermeidest und woran du erkennst, dass alles richtig ankommt.

Der Fokus liegt auf Lead-Gen: Ein Formular ist hier nur der Anfang. Spannend wird es, wenn du der Plattform auch meldest, welche Leads zu Terminen und Abschlüssen wurden.

Was eine Conversion API leistet

Ein Pixel meldet Conversions aus dem Browser. Das scheitert an Ad-Blockern, an abgelehnten Cookies, an Browsern mit Tracking-Schutz und an allem, was nach dem Seitenbesuch passiert. Ein Termin im Kalender oder ein gewonnener Deal im CRM sieht der Pixel nie.

Eine Conversion API ist der zweite Weg: Dein Server schickt das Event direkt an die Plattform. Meta empfiehlt in den Best Practices zur Conversions API ausdrücklich, beide Wege parallel zu nutzen und dieselben Events über beide zu senden. TikTok sagt in About Events API dasselbe, LinkedIn in seiner Doku zur Deduplizierung.

Für Lead-Gen hat der Server-Weg einen zweiten Nutzen, der oft wichtiger ist als die verlorenen Browser-Events: Er bringt die späteren Stufen deines Vertriebs zurück zur Plattform. Damit lernt der Algorithmus, welche Leads etwas wert sind. Mehr dazu im Guide Auf qualifizierte Leads optimieren.

Welche Events im Lead-Gen zählen

Lege vorab fest, welche Stufen du sendest. Jede Stufe ist ein eigenes Event (bei Google Ads und LinkedIn eine eigene Conversion-Aktion bzw. Conversion-Regel). Halte die Liste kurz: Wenige saubere Events helfen mehr als zwanzig halbe.

StufeWannMetaGoogle AdsLinkedIn
LeadFormular abgeschicktLeadAktion „Lead“Typ LEAD
Qualifizierter LeadVertrieb bestätigteigenes Event oder CRM-Stufeeigene AktionQUALIFIED_LEAD
TerminErstgespräch gebuchtScheduleeigene AktionBOOK_APPOINTMENT
AbschlussDeal gewonnenPurchase oder CRM-Stufeeigene Aktion mit WertPURCHASE

Drei Regeln dazu:

  1. Ein Name pro Stufe: Verwende überall denselben Event-Namen, im Pixel wie am Server. Die Deduplizierung hängt bei Meta und TikTok am Namen.
  2. Wert nur, wo er stimmt: Einen Wert mit Währung sendest du beim Abschluss. Für frühe Stufen kannst du einen geschätzten Lead-Wert verwenden, wenn du ihn begründen kannst. Der Lead-Wert-Rechner hilft dabei.
  3. Nicht doppelt optimieren: Wenn der Lead aus einem Lead-Formular der Plattform selbst stammt (Meta Instant Forms, LinkedIn Lead Gen Forms), zählt die Plattform ihn schon. Sende dann nur die späteren Stufen, mit der Lead-ID der Plattform.

Was du mitsenden solltest

Jedes Server-Event besteht aus vier Teilen: den Event-Daten, den Kundendaten, den Browser-Signalen und der Event-ID. Fehlt einer, wird das Event entweder abgelehnt, nicht zugeordnet oder doppelt gezählt.

Event-Daten

ParameterBedeutungBeispiel
Event-NameStufe aus deiner ListeLead
ZeitpunktWann es passiert ist, nicht wann du sendestUnix-Zeit in Sekunden (LinkedIn: Millisekunden)
QuelleWebsite, CRM, TelefonMeta: action_source: website
SeiteURL, auf der das Event passiertehttps://example.com/danke
Wert und WährungNur mit beidem1500, EUR

Meta lehnt laut den Server Event Parameters den ganzen Request ab, wenn ein Event darin älter als sieben Tage ist. Sende also zeitnah und filtere alte Events vorher heraus.

Kundendaten und Hashing

Kundendaten machen ein Event einer Person zuordenbar. Die Plattformen erwarten sie normalisiert und als SHA-256-Hash. Normalisieren heißt: Leerzeichen weg, Kleinbuchstaben, Telefonnummer mit Landesvorwahl. Ein falsch normalisierter Wert ergibt einen anderen Hash und passt zu niemandem.

FeldMetaGoogle AdsLinkedIn
E-Mailklein, getrimmt, gehashtklein; bei Gmail ohne Punkte und +-Zusatz, gehashtklein, ohne Leerzeichen, gehasht
Telefonnur Ziffern mit Landesvorwahl, gehashtE.164 mit +, gehashtab API-Version 202611, Ziffern ohne +, gehasht
NamegehashtVor- und Nachname gehashtals Paar, Klartext oder gehasht
IP und User-AgentKlartextKlartextIPv4 im Klartext oder gehasht

Quellen: Metas Customer Information Parameters, Googles Format user data und LinkedIns Conversions API Schema. TikTok verlangt laut How to set up matching events with Events API E-Mail, Telefon und externe ID gehasht.

Wichtig: Hashing ist keine Anonymisierung. Die Plattform gleicht den Hash mit ihren eigenen Nutzerdaten ab, genau dafür sendest du ihn. Welche Rechtsgrundlage du dafür brauchst, behandelt der Guide DSGVO-konformes Ad-Tracking.

Klick-IDs und Cookies

Klick-IDs verbinden das Event mit dem konkreten Anzeigenklick. Sie stehen in der URL der Landing-Page und müssen beim ersten Besuch gespeichert werden, am besten zusammen mit dem Lead im CRM. Wer sie erst beim Abschluss sucht, findet sie nicht mehr.

  • Meta: fbclid aus der URL, gespeichert als Cookie _fbc; dazu die Browser-ID _fbp.
  • Google Ads: gclid, auf iOS teils gbraid oder wbraid.
  • TikTok: ttclid aus der URL und das Cookie _ttp.
  • LinkedIn: li_fat_id, das LinkedIn nur anhängt, wenn du im Campaign Manager die erweiterte Conversion-Messung mit First-Party-Cookies aktiviert hast.

Event-ID für die Deduplizierung

Meldest du ein Event über Pixel und Server, braucht die Plattform ein Merkmal, um beides als dasselbe Event zu erkennen. Das ist die Event-ID: eine eindeutige Zeichenkette, die du im Browser erzeugst, an den Pixel gibst und an deinen Server weiterreichst.

  1. ID erzeugen: Beim Absenden des Formulars eine zufällige ID erzeugen, zum Beispiel eine UUID.
  2. An den Pixel: Meta eventID, TikTok event_id, LinkedIn Insight Tag event_id.
  3. An den Server: Dieselbe ID mit dem Formular übertragen und im Server-Event senden (Meta event_id, LinkedIn eventId).
  4. Gleichen Namen verwenden: Meta und TikTok vergleichen Event-ID und Event-Name zusammen.

Meta dedupliziert laut Handling Duplicate Pixel and Conversions API Events Events mit gleicher ID innerhalb von 48 Stunden. TikTok vergleicht laut About Event Deduplication Event und event_id in einem Fenster von fünf Minuten bis 48 Stunden und behält das zuerst empfangene Event. LinkedIn braucht für Insight Tag und Conversions API je eine eigene Conversion-Regel und zählt bei gleicher eventId nur das Event des Insight Tags.

Für spätere Stufen aus dem CRM gibt es kein Browser-Event. Hier vergibst du eine stabile ID pro Stufe und Person, damit ein erneuter Versand nicht doppelt zählt.

Die Plattformen im Vergleich

MetaGoogle AdsTikTokLinkedIn
SchnittstelleConversions APIData Manager APIEvents APIConversions API
ZielDataset (Pixel)Conversion-AktionPixelConversion-Regel
Doppelte vermeidenEvent-Name + event_idTransaktions-IDEvent + event_ideigene Regel + eventId
Klick-IDfbc / fbpgclid, gbraid, wbraidttclid, _ttpli_fat_id
Max. Alter7 Tage90 Tage (gclid), 63 Tage (nur Kundendaten)zeitnah senden90 Tage
TestenTest Events mit test_event_codevalidateOnlyTest EventsPayload Builder, kein Testmodus
Lead-Formular-IDlead_idnicht relevantnicht relevantlead (URN)

Meta Conversions API einrichten

  1. Dataset wählen: Im Events Manager nutzt du das Dataset deines Pixels. Dort erzeugst du in den Einstellungen einen Zugriffstoken für die Conversions API.
  2. Events festlegen: Die Stufen aus deiner Liste, mit denselben Namen wie im Pixel.
  3. Server-Event bauen: event_name, event_time, action_source, event_source_url, event_id und user_data mit gehashten Kontaktdaten sowie client_ip_address, client_user_agent, fbc und fbp. Bis zu 1.000 Events passen in einen Request.
  4. Testen: Mit dem test_event_code aus dem Tool „Test Events“. Laut Using the API siehst du echte Events nach etwa 20 Minuten im Events Manager.
  5. Prüfen: Im Events Manager Deduplizierung und Event Match Quality je Event ansehen.

Für Leads aus Instant Forms gibt es einen eigenen Weg: die Conversions API for CRM integration. Du speicherst die Lead-ID von Meta und sendest damit jede spätere Stufe. Darauf baut das Leistungsziel Conversion Leads auf. Meta nennt als Voraussetzung mindestens 200 Leads pro Monat, mindestens einen Upload pro Tag und eine Zielstufe, die innerhalb von 28 Tagen nach dem Lead erreicht wird, mit einer Rate zwischen 1 und 40 Prozent.

Google trennt zwei Wege, die zusammenwirken. Mit gclid gibst du einen Klick zurück, mit Enhanced Conversions for Leads gehashte Kundendaten. Laut der Hilfeseite Erweiterte Conversions für Leads solltest du die gclid mitsenden, wann immer du sie hast. Seit dem 15. Juni 2026 laufen Offline-Conversion-Importe und Uploads für Enhanced Conversions for Leads über die Data Manager API, in der Google Ads API sind sie gesperrt.

  1. Conversion-Aktion anlegen: Unter „Zielvorhaben“ → „Conversions“ eine Aktion vom Typ Import aus Klicks pro Stufe anlegen. Enhanced Conversions für Leads aktivieren und die Bedingungen für Kundendaten akzeptieren.
  2. Kundendaten auf der Website erfassen: Der Google-Tag erfasst die Kontaktdaten aus dem Formular gehasht, damit Google den späteren Import zuordnen kann. Ohne diesen Tag ist die gclid Pflicht.
  3. gclid speichern: Beim ersten Besuch gclid, gbraid oder wbraid mit dem Lead speichern.
  4. Senden: Pro Conversion Ziel-Aktion, Zeitpunkt, Klick-ID, gehashte Kundendaten, Wert, Währung, Transaktions-ID und die Einwilligungen adUserData und adPersonalization (das Consent-Objekt bildet die Vorgaben des Digital Markets Act ab).
  5. Testen: Laut Google Ads offline conversions prüft validateOnly: true die Daten, ohne sie zu übernehmen. Ob Google eine Conversion verarbeitet hat, zeigt danach die Diagnose.

Zeitgrenzen beachten: Google hält die gclid laut den häufig gestellten Fragen zu Offline-Conversion-Importen nur 90 Tage. Conversions mit gehashten Kundendaten nimmt Google bis 63 Tage an. Dauert dein Vertrieb länger, sende eine frühere Stufe, die in dieses Fenster fällt, etwa den qualifizierten Lead. Wie das im Alltag aussieht, zeigt der Use Case Offline-Conversions an Google Ads.

Zählt schon der Google-Tag den Lead auf der Website, darf dieselbe Stufe nicht zusätzlich in einer zweiten Aktion für die Gebote zählen. Entscheide dich pro Stufe für eine primäre Aktion.

TikTok Events API einrichten

  1. Pixel und Token: Im TikTok Events Manager den Pixel wählen und in seinen Einstellungen einen Zugriffstoken für die Events API erzeugen.
  2. Events zuordnen: Für jede Stufe ein Standard-Event von TikTok, im Pixel und am Server mit gleichem Namen.
  3. Daten senden: Event, Zeitpunkt, event_id, Seite, gehashte E-Mail, Telefon und externe ID, ttclid, _ttp, IP und User-Agent.
  4. Testen: Mit einem Testcode aus den Test Events des Events Managers.
  5. Deduplizierung prüfen: Pixel und Server müssen beide die event_id senden, sonst zählt TikTok doppelt.

TikTok schreibt keine Pflichtfelder vor, empfiehlt aber, alle verfügbaren Match-Keys mitzuschicken. Bei den Browser-Signalen gilt: _ttp ist nur verfügbar, wenn auch der Pixel auf der Seite läuft.

LinkedIn Conversions API einrichten

  1. Conversion-Regel anlegen: Im Campaign Manager eine Regel mit der Methode Conversions API und passendem Typ anlegen, etwa LEAD oder QUALIFIED_LEAD.
  2. Kampagnen verknüpfen: Laut Conversions API zählen Conversions nur für Kampagnen, die mit der Regel verknüpft sind.
  3. Daten senden: Zeitpunkt in Millisekunden, Wert, eventId und mindestens ein Merkmal: gehashte E-Mail, li_fat_id, IP-Adresse, Vor- und Nachname als Paar, die externe ID nur zusätzlich zu einem dieser Merkmale, oder die Lead-ID eines Lead Gen Forms.
  4. Mit dem Insight Tag deduplizieren: Eigene Regel für den Insight Tag, gleiche eventId auf beiden Wegen.
  5. Kontrollieren: In der Aufschlüsselung der Conversions erscheinen beide Regeln. Funktioniert die Deduplizierung, hat die Insight-Tag-Regel meist die höhere Zahl.

LinkedIn nimmt Events bis 90 Tage nach der Conversion an und bietet keinen eigenen Testmodus. Starte deshalb mit wenigen Events und prüfe die Antworten der API: 201 heißt angenommen, 400 nennt das fehlerhafte Feld.

Match-Qualität verbessern

Nur zugeordnete Events zählen für Attribution und Optimierung, das schreiben Meta und LinkedIn ausdrücklich. Meta zeigt dafür die Event Match Quality auf einer Skala bis 10. So hebst du sie:

  1. Mehr Kennungen: E-Mail und Telefon, dazu Name, wenn du ihn hast. Bei CRM-Stufen tragen sie die Zuordnung allein.
  2. Browser-Signale mitgeben: IP, User-Agent und Cookies aus dem Besuch, in dem die Person konvertiert hat. Dafür musst du sie beim Formular serverseitig speichern.
  3. Sauber normalisieren: Die häufigste Ursache für schlechte Werte ist ein falsches Format, nicht fehlende Daten.
  4. Personen zusammenführen: Gib einem Abschluss die Kontaktdaten und Klick-IDs mit, die beim ersten Formular vorhanden waren. Dafür muss dein System wissen, dass Lead und Kunde dieselbe Person sind.

Angenommen, du meldest einen gewonnenen Deal nur mit der E-Mail-Adresse aus dem CRM, die Person hat aber mit ihrer privaten Adresse geklickt. Dann findet die Plattform keinen Treffer. Mit der Telefonnummer und der fbclid vom ersten Besuch klappt die Zuordnung trotzdem.

Häufige Probleme und Lösungen

ProblemUrsacheLösung
Conversions doppelt gezähltPixel und Server senden keine oder verschiedene Event-IDs oder NamenEine ID im Browser erzeugen, an Pixel und Server geben, gleiche Namen verwenden
Meta lehnt ganzen Request abEin Event ist älter als sieben TageZeitnah senden, alte Events vor dem Versand aussortieren
Niedrige Event Match QualityNur IP und User-Agent, oder Daten falsch normalisiertE-Mail, Telefon, fbc und fbp ergänzen, Normalisierung prüfen
Google: Klick zu altgclid älter als 90 TageHäufiger hochladen oder eine frühere Stufe senden
Google zählt Leads doppeltGoogle-Tag und Import zählen dieselbe Stufe in zwei primären AktionenPro Stufe eine primäre Aktion, gleiche Transaktions-ID
LinkedIn zeigt keine ConversionsRegel nicht mit Kampagnen verknüpft oder kein gültiges MerkmalKampagnen verknüpfen, E-Mail oder li_fat_id mitsenden
Abschlüsse ohne TrefferKlick-ID und Kontaktdaten vom ersten Besuch fehlen beim DealKlick-IDs mit dem Lead im CRM speichern und beim Deal mitsenden

So geht es mit TSO

Wenn du das nicht selbst bauen willst: TSO sendet Leads und spätere Stufen per Conversion API an Meta, Google Ads (Data Manager API, Enhanced Conversions for Leads), TikTok und LinkedIn. Microsoft Ads, Snapchat und ChatGPT Ads werden ebenfalls unterstützt, dort stehen aber noch manuelle Tests gegen die Live-Plattformen aus.

  • Eine Event-ID: Pixel und Server senden dieselbe ID, auf Wunsch lädt das TSO-Script die Pixel selbst.
  • CRM-Stufen: Deals und Zahlungen aus Webhooks, der API oder Stripe gehen als eigene Events hinaus, an Meta auch als CRM-Stufen.
  • Lead-Formulare: Die Lead-ID aus Meta Instant Forms und LinkedIn Lead Gen Forms geht bei jeder späteren Conversion der Person mit (Lead-Formulare).
  • Kontrolle: Versand über eine Warteschlange mit Wiederholungen, ein Zustell-Log pro Ziel mit Gründen, Testmodus für Meta, Google und TikTok.

Zum Datenschutz, ehrlich: TSO speichert Kontaktdaten im Klartext und hasht sie erst beim Versand. IP-Adresse und User-Agent gehen standardmäßig auch ohne Consent an die Conversion APIs. Das kannst du pro Ziel abschalten, genau wie andere Feldgruppen (Datenschutz). Attribuiert werden nur Klicks, keine Views.

Quellen

So hilft TSO dabei

Häufige Fragen

Brauche ich den Pixel noch, wenn ich eine Conversion API nutze?

Meta, TikTok und LinkedIn empfehlen beides zusammen. Der Pixel liefert Browser-Signale wie Cookies, der Server liefert Events, die der Browser verliert, und Stufen aus dem CRM. Mit gleicher Event-ID zählt die Plattform jedes Event einmal.

Welche Events sollte ich bei Lead-Gen über die Conversion API senden?

Mindestens den Lead. Dazu die Stufen, die für dich Geld bedeuten, etwa qualifizierter Lead, Termin und Abschluss mit Wert. Ein Event pro Stufe, mit klaren Namen.

Muss ich E-Mail-Adressen vor dem Senden hashen?

Ja. Meta, Google, TikTok und LinkedIn erwarten E-Mail und Telefon als SHA-256-Hash, nachdem du sie nach ihren Regeln normalisiert hast. IP-Adresse, User-Agent und Klick-IDs gehen dagegen im Klartext.

Wie alt darf eine Conversion sein, die ich nachmelde?

Bei Meta höchstens sieben Tage, bei LinkedIn 90 Tage. Google Ads nimmt Conversions mit gclid bis 90 Tage nach dem Klick an, mit nur gehashten Kundendaten bis 63 Tage.

Was ist eine gute Event Match Quality?

Meta bewertet auf einer Skala bis 10, höher ist besser. Feste Grenzwerte veröffentlicht Meta nicht. Der Events Manager zeigt dir, welche Parameter fehlen.

Begriffe in diesem Guide

Passende Artikel

Geschrieben von
Daniel KalcherCTO

Daniel ist CTO und verantwortet die Technik hinter Tracking, Attribution und Conversion APIs bei TSO.

Weitere Guides

Alle Guides →

Vom Guide zur sauberen Messung.

Richte TSO in einer Demo mit uns ein oder frag den Beta-Zugang an.