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.
Auf dieser Seite
- Was eine Conversion API leistet
- Welche Events im Lead-Gen zählen
- Was du mitsenden solltest
- Event-Daten
- Kundendaten und Hashing
- Klick-IDs und Cookies
- Event-ID für die Deduplizierung
- Die Plattformen im Vergleich
- Meta Conversions API einrichten
- Google Ads mit der Data Manager API
- TikTok Events API einrichten
- LinkedIn Conversions API einrichten
- Match-Qualität verbessern
- Häufige Probleme und Lösungen
- So geht es mit TSO
- Quellen
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.
| Stufe | Wann | Meta | Google Ads | |
|---|---|---|---|---|
| Lead | Formular abgeschickt | Lead | Aktion „Lead“ | Typ LEAD |
| Qualifizierter Lead | Vertrieb bestätigt | eigenes Event oder CRM-Stufe | eigene Aktion | QUALIFIED_LEAD |
| Termin | Erstgespräch gebucht | Schedule | eigene Aktion | BOOK_APPOINTMENT |
| Abschluss | Deal gewonnen | Purchase oder CRM-Stufe | eigene Aktion mit Wert | PURCHASE |
Drei Regeln dazu:
- Ein Name pro Stufe: Verwende überall denselben Event-Namen, im Pixel wie am Server. Die Deduplizierung hängt bei Meta und TikTok am Namen.
- 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.
- 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
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| Event-Name | Stufe aus deiner Liste | Lead |
| Zeitpunkt | Wann es passiert ist, nicht wann du sendest | Unix-Zeit in Sekunden (LinkedIn: Millisekunden) |
| Quelle | Website, CRM, Telefon | Meta: action_source: website |
| Seite | URL, auf der das Event passierte | https://example.com/danke |
| Wert und Währung | Nur mit beidem | 1500, 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.
| Feld | Meta | Google Ads | |
|---|---|---|---|
| klein, getrimmt, gehasht | klein; bei Gmail ohne Punkte und +-Zusatz, gehasht | klein, ohne Leerzeichen, gehasht | |
| Telefon | nur Ziffern mit Landesvorwahl, gehasht | E.164 mit +, gehasht | ab API-Version 202611, Ziffern ohne +, gehasht |
| Name | gehasht | Vor- und Nachname gehasht | als Paar, Klartext oder gehasht |
| IP und User-Agent | Klartext | Klartext | IPv4 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.
- ID erzeugen: Beim Absenden des Formulars eine zufällige ID erzeugen, zum Beispiel eine UUID.
- An den Pixel: Meta
eventID, TikTokevent_id, LinkedIn Insight Tagevent_id. - An den Server: Dieselbe ID mit dem Formular übertragen und im Server-Event senden (Meta
event_id, LinkedIneventId). - 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
| Meta | Google Ads | TikTok | ||
|---|---|---|---|---|
| Schnittstelle | Conversions API | Data Manager API | Events API | Conversions API |
| Ziel | Dataset (Pixel) | Conversion-Aktion | Pixel | Conversion-Regel |
| Doppelte vermeiden | Event-Name + event_id | Transaktions-ID | Event + event_id | eigene Regel + eventId |
| Klick-ID | fbc / fbp | gclid, gbraid, wbraid | ttclid, _ttp | li_fat_id |
| Max. Alter | 7 Tage | 90 Tage (gclid), 63 Tage (nur Kundendaten) | zeitnah senden | 90 Tage |
| Testen | Test Events mit test_event_code | validateOnly | Test Events | Payload Builder, kein Testmodus |
| Lead-Formular-ID | lead_id | nicht relevant | nicht relevant | lead (URN) |
Meta Conversions API einrichten
- 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.
- Events festlegen: Die Stufen aus deiner Liste, mit denselben Namen wie im Pixel.
- Server-Event bauen:
event_name,event_time,action_source,event_source_url,event_idunduser_datamit gehashten Kontaktdaten sowieclient_ip_address,client_user_agent,fbcundfbp. Bis zu 1.000 Events passen in einen Request. - Testen: Mit dem
test_event_codeaus dem Tool „Test Events“. Laut Using the API siehst du echte Events nach etwa 20 Minuten im Events Manager. - 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 Ads mit der Data Manager API
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.
- 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.
- 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.
- gclid speichern: Beim ersten Besuch gclid, gbraid oder wbraid mit dem Lead speichern.
- Senden: Pro Conversion Ziel-Aktion, Zeitpunkt, Klick-ID, gehashte Kundendaten, Wert, Währung, Transaktions-ID und die Einwilligungen
adUserDataundadPersonalization(das Consent-Objekt bildet die Vorgaben des Digital Markets Act ab). - Testen: Laut Google Ads offline conversions prüft
validateOnly: truedie 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
- Pixel und Token: Im TikTok Events Manager den Pixel wählen und in seinen Einstellungen einen Zugriffstoken für die Events API erzeugen.
- Events zuordnen: Für jede Stufe ein Standard-Event von TikTok, im Pixel und am Server mit gleichem Namen.
- Daten senden: Event, Zeitpunkt,
event_id, Seite, gehashte E-Mail, Telefon und externe ID, ttclid,_ttp, IP und User-Agent. - Testen: Mit einem Testcode aus den Test Events des Events Managers.
- Deduplizierung prüfen: Pixel und Server müssen beide die
event_idsenden, 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
- Conversion-Regel anlegen: Im Campaign Manager eine Regel mit der Methode Conversions API und passendem Typ anlegen, etwa
LEADoderQUALIFIED_LEAD. - Kampagnen verknüpfen: Laut Conversions API zählen Conversions nur für Kampagnen, die mit der Regel verknüpft sind.
- Daten senden: Zeitpunkt in Millisekunden, Wert,
eventIdund 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. - Mit dem Insight Tag deduplizieren: Eigene Regel für den Insight Tag, gleiche
eventIdauf beiden Wegen. - 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:
- Mehr Kennungen: E-Mail und Telefon, dazu Name, wenn du ihn hast. Bei CRM-Stufen tragen sie die Zuordnung allein.
- 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.
- Sauber normalisieren: Die häufigste Ursache für schlechte Werte ist ein falsches Format, nicht fehlende Daten.
- 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
| Problem | Ursache | Lösung |
|---|---|---|
| Conversions doppelt gezählt | Pixel und Server senden keine oder verschiedene Event-IDs oder Namen | Eine ID im Browser erzeugen, an Pixel und Server geben, gleiche Namen verwenden |
| Meta lehnt ganzen Request ab | Ein Event ist älter als sieben Tage | Zeitnah senden, alte Events vor dem Versand aussortieren |
| Niedrige Event Match Quality | Nur IP und User-Agent, oder Daten falsch normalisiert | E-Mail, Telefon, fbc und fbp ergänzen, Normalisierung prüfen |
| Google: Klick zu alt | gclid älter als 90 Tage | Häufiger hochladen oder eine frühere Stufe senden |
| Google zählt Leads doppelt | Google-Tag und Import zählen dieselbe Stufe in zwei primären Aktionen | Pro Stufe eine primäre Aktion, gleiche Transaktions-ID |
| LinkedIn zeigt keine Conversions | Regel nicht mit Kampagnen verknüpft oder kein gültiges Merkmal | Kampagnen verknüpfen, E-Mail oder li_fat_id mitsenden |
| Abschlüsse ohne Treffer | Klick-ID und Kontaktdaten vom ersten Besuch fehlen beim Deal | Klick-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
- Best Practices - Conversions API, Meta for Developers
- Handling Duplicate Pixel and Conversions API Events, Meta for Developers
- Customer Information Parameters, Meta for Developers
- Server Event Parameters, Meta for Developers
- Using the API - Conversions API, Meta for Developers
- Conversions API for CRM integration, Meta for Developers
- Erweiterte Conversions für Leads, Google Ads-Hilfe
- Häufig gestellte Fragen zu Offline-Conversion-Importen, Google Ads-Hilfe
- Google Ads offline conversions, Google for Developers
- Format user data, Google for Developers
- Consent, Google for Developers
- About Events API, TikTok Business Help Center
- How to set up matching events with Events API, TikTok Business Help Center
- About Event Deduplication, TikTok Business Help Center
- Conversions API, LinkedIn / Microsoft Learn
- Conversions API Schema, LinkedIn / Microsoft Learn
- Deduplication, LinkedIn / Microsoft Learn
So hilft TSO dabei
- Conversion APILeads, Termine und Abschlüsse gehen server-side an sieben Werbeplattformen, dedupliziert mit dem Pixel. Damit die Algorithmen auf echte Kunden optimieren.
- Datenschutz & ConsentDrei Datenschutz-Modi, automatische Erkennung deines Cookie-Banners und pro Plattform festlegen, welche Daten rausgehen. Gehostet in Deutschland.
- Lead-FormulareLeads aus Meta Instant Forms und LinkedIn Lead Gen Forms landen automatisch in TSO. Ihre Lead-ID geht bei jeder späteren Conversion mit an die Plattform.
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
Daniel ist CTO und verantwortet die Technik hinter Tracking, Attribution und Conversion APIs bei TSO.