HubSpot Facebook Conversion API
Praktische Anleitung zum Senden von Server-seitigen Events aus HubSpot-Formularen, Deals und Lifecycle-Stages an Meta für genaues Lead- und Umsatz-Tracking.
Warum HubSpot-Nutzer CAPI brauchen
HubSpot ist in den meisten B2B- und Service-Businesses die Single Source of Truth für Leads, Deals und Customer Lifecycle. Wenn Meta-Traffic diese Leads generiert, verliert reines Pixel-Tracking einen großen Teil der Form Submits und Folge-Conversions durch iOS-Einschränkungen, Cookie-Limits und Adblocker. Diese Lücke versteckt echtes Pipeline vor dem Meta-Algorithmus.
Die Facebook Conversion API schließt sie, indem sie Server-Events direkt aus HubSpot an Meta sendet. Form Submits gehen als Lead-Events raus, und Offline-Conversions wie SQL, Opportunity und Closed Won lassen sich mit echten Deal-Werten übertragen. Genau dort holen B2B-Advertiser den größten Uplift.
30-50%
Wiederhergestellte Lead-Events vs Pixel-only
13%
Durchschnittliche CPA-Reduktion laut Meta
8x
Höhere Signalqualität mit Deal-Stage-Events
Voraussetzungen
- HubSpot Marketing Hub oder Sales Hub mit Workflow-Zugriff
- Facebook Business Manager mit verifizierter Domain und Meta Pixel
- Zugriff auf Meta Events Manager für Access Token
- HubSpot Ads Add-on für die native Meta-Integration (optional)
- Optional: GTM Server Container oder Middleware für volle Kontrolle
Integrationsmethoden
Methode 1: Native HubSpot Ads Meta-Integration
HubSpots Ads-Tool kann Kontakt- und Deal-Events als Offline-Conversions und CAPI-Events an Meta zurückspielen. Meta-Werbekonto in HubSpot unter Marketing > Ads verbinden und Lifecycle- und Deal-Stages auf Meta-Events mappen.
Methode 2: HubSpot Workflows + Webhook zu einem CAPI-Service
Workflow bei Form Submit oder Lifecycle-Änderung triggern und per Webhook-Action Kontakt- und Deal-Daten an einen CAPI-Service oder eine eigene Funktion posten. Volle Kontrolle darüber, welche Stages Lead-, Purchase- oder Custom-Events feuern.
Methode 3: GTM Server-Side + HubSpot Forms
Frontend-HubSpot-Formulare über einen Server-GTM-Container leiten, der Pixel und CAPI mit gleicher event_id feuert. Sauber für Website-Leads, für Deal-Stage-Events wird zusätzlich ein Workflow gebraucht.
Methode 4: Custom-Middleware mit HubSpot- und Graph-API
Kleiner Service, der HubSpot-Webhooks konsumiert und Metas Graph API direkt aufruft, mit gehashten Identifiern, Deal-Werten und Event Source URLs. Ideal für fortgeschrittene RevOps-Setups.
Schritt für Schritt: HubSpot Workflow zu Meta CAPI
- In Meta Events Manager Pixel anlegen und CAPI Access Token generieren.
- Kleinen Endpoint deployen (Supabase Edge Function, Cloud Function), der HubSpot-Webhook-Payloads annimmt und an Metas Graph API weiterleitet.
- In HubSpot einen Contact-Workflow anlegen, getriggert durch Form Submit oder Lifecycle-Änderung.
- Webhook-Action mit Email, Telefon, IP, User Agent und Deal-Amount konfigurieren.
- Email und Telefon im Endpoint mit SHA-256 hashen, bevor sie an Meta gehen.
- Eindeutige event_id vergeben und action_source auf "website" oder "system_generated" setzen.
- Events im Test Events Tool prüfen und Event Match Quality über 6.0 bestätigen.
Für den Tag-Manager-Ansatz siehe unseren CAPI mit Google Tag Manager Guide.
HubSpot-Events und Meta CAPI
| HubSpot Trigger | Meta Event | Parameter |
|---|---|---|
| Form Submit (Newsletter, Gated Content) | Lead | em, ph, fn, ln, fbp, fbc |
| Meeting gebucht (HubSpot Meetings) | Schedule | em, ph, event_source_url |
| Lifecycle: MQL | Lead (Custom Event) | em, ph, lead_type |
| Lifecycle: SQL / Opportunity | Qualified Lead | em, ph, value |
| Deal Stage: Closed Won | Purchase | value, currency, order_id, em, ph |
| Trial oder Abo erstellt | Subscribe | value, currency, predicted_ltv |
Häufige HubSpot CAPI Fehler
Jede Lifecycle-Änderung als Purchase senden
Purchase gehört zu Closed Won oder echten Umsatz-Events. MQL und SQL besser als Lead oder Custom Qualified Lead abbilden, damit Bidding sich am tatsächlichen Business-Wert orientiert.
Keine Deduplication mit dem Pixel
Wenn der Pixel beim Form Submit ebenfalls feuert, gleiche event_id für Browser und Server verwenden. Sonst zählt Meta den Lead doppelt.
Fehlende user_data Felder
HubSpot hat Email, Telefon, Vor- und Nachname, Stadt und PLZ auf den meisten Kontakten. Alle hashen und mitsenden. Match Quality beeinflusst Attribution und CPA direkt.
Offline-Conversion-Latenz ignorieren
Deals schließen oft Wochen nach dem Klick. Ursprüngliches event_time vom Lead-Zeitpunkt mitsenden, damit Meta korrekt attribuiert.
HubSpot CAPI FAQs
Unterstützt HubSpot Facebook Conversion API nativ?
HubSpots Ads Add-on kann Offline-Conversions an Meta senden und mit dem Pixel integrieren. Für volle CAPI-Kontrolle nutzen die meisten Teams einen Workflow-Webhook, der Daten an eine Middleware oder CAPI-Service weiterleitet.
Kann ich Deal-Werte als Purchase-Events senden?
Ja. Workflow triggern, wenn ein Deal auf Closed Won geht, und den Deal-Amount als value mit korrekter currency mitgeben. Das ist das stärkste Signal, das man aus HubSpot an Meta schicken kann.
Wie matche ich HubSpot-Leads mit Meta-Klicks?
fbp- und fbc-Cookies auf der Landingpage lesen und als Hidden Fields im HubSpot-Formular mitspeichern. In das CAPI-Event zusammen mit gehashter Email und Telefon einfügen.
Brauche ich HubSpot Enterprise?
Nein. Workflows mit Webhook-Action sind in Professional-Tiers von Marketing Hub und Sales Hub verfügbar. Free und Starter unterstützen die Webhook-Action nicht.
Wie schnell verarbeitet Meta CAPI-Events aus HubSpot?
Test Events zeigt sie in Minuten. Aggregiertes Reporting braucht 24-48 Stunden, Kampagnenoptimierung meist eine Woche bei konstantem Event-Fluss.