SOP: Facebook/Meta Conversion API in Funnelspot einrichten

Ziel

Serverseitiges Tracking mit der Meta Conversion API (CAPI) aus Funnelspot heraus aufsetzen. Ereignisse (z. B. Lead) werden inkl. Match-Daten (E-Mail, Telefon, IP, User Agent etc.) an Meta gesendet, damit Kampagnen korrekt attribuiert werden – auch bei eingeschränkten Cookies.

Voraussetzungen

• Zugriff auf Funnelspot (Automationen & Facebook-Integration)

• Zugriff auf Meta Business Manager → Events Manager (Facebook-Pixel)

• Geschäfts-E-Mail-Domain verifiziert (empfohlen)

• DSGVO-konforme Einwilligungstexte (Cookie/Tracking-Hinweis)

Überblick

1. Funnelspot mit Meta verbinden

2. In Meta: Pixel-ID und CAPI Access Token holen

3. In Funnelspot Workflow erstellen (Trigger: Formular abgeschickt)

4. Facebook Conversion API-Aktion einfügen (Token, Pixel-ID, Event „Lead“, Felder-Mapping)

5. Im Events Manager testen (Test-Event-Code), dann Test-Code wieder entfernen

6. Veröffentlichen

Schritt-für-Schritt

1) Funnelspot ↔ Meta verbinden

1. In Funnelspot: Bereich Integrationen öffnen.

2. Facebook/Meta auswählen und verbinden (Zugriff gewähren).

3. Prüfen, dass deine Business-Seite/Pixel sichtbar sind.

Hinweis: Dieser Schritt ist Voraussetzung, damit spätere CAPI-Calls angenommen werden.

2) Pixel-ID & CAPI Access Token in Meta holen

1. Meta Events Manager öffnen → deinen Pixel wählen.

2. Einstellungen / Setup → Conversion API → Manuell einrichten.

3. Pixel-ID kopieren (für später).

4. Zugriffsschlüssel/Access Token generieren und kopieren (für später).

5. Optional: Entscheiden, welche Events du perspektivisch senden willst (z. B. Lead, CompleteRegistration, Contact, SubmitApplication, Schedule, ViewContent).

3) Funnelspot-Workflow anlegen (Trigger)

1. Funnelspot → Automatisierung → Neuer Workflow.

2. Name: z. B. CAPI | Lead | Formular XY.

3. Trigger: Formular abgeschickt.

4. Formular auswählen (dein Leadmagnet-/Opt-in-Formular).

5. Trigger speichern.

4) Facebook Conversion API Aktion hinzufügen

1. Im Workflow auf + Aktion → Facebook Conversion API.

2. Felder befüllen:

   • Access Token: aus Schritt 2

   • Pixel ID: aus Schritt 2

   • Event Name: Lead

   • Value: 0 (bei Leads i. d. R. 0 – für Käufe später Produktwert)

   • Currency: EUR (oder passende Währung)

3. User/Match-Daten mappen (so viel wie möglich, um Match-Qualität zu erhöhen):

   • Email (gehasht serverseitig)

   • First Name

   • Last Name

   • Phone

   • Client IP Address

   • Client User Agent

   • Click ID (fbclid, sofern vorhanden)

   • Browser ID / Cookie IDs (falls bereitgestellt)

   • Event ID (z. B. dynamisch aus Kontakt-ID + Timestamp; dient der Deduplizierung)

Tipp: Wenn Funnelspot Felder wie {{contact.email}}, {{contact.first_name}} etc. anbietet, diese direkt zuordnen. IP/User Agent über die bereitgestellten Variablen des Formular-Triggers mappen.

4. Speichern.

5) Testen mit Test-Event-Code

1. In Meta Events Manager → dein Pixel → Testen / Testevents.

2. Test-Event-Code kopieren.

3. Zurück zur CAPI-Aktion in Funnelspot → Feld Test Code einfügen → Speichern.

4. Testabsendung: Dein Formular einmal real ausfüllen und absenden.

5. Im Events Manager prüfen, ob Server-Event „Lead“ eingeht (Status „empfangen“ / „abgeglichen“).

6. Wichtig: Nach erfolgreichem Test den Test-Event-Code wieder entfernen, Aktion speichern.

6) Workflow veröffentlichen

1. Workflow oben speichern.

2. Veröffentlichen/aktivieren.

3. Zweiten Live-Test durchführen und in Meta prüfen, ob Server-Events ohne Testcode ankommen.

Erweiterungen (optional)

• Weitere Events abbilden: zusätzliche Workflows mit passenden Triggern (z. B. „Termin gebucht“, „Bewerbung eingereicht“, „CompleteRegistration“, „ViewContent“).

• Event Value pflegen: Bei Käufen Purchase mitsamt value und currency senden.

• Event ID-Strategie vereinheitlichen (z. B. {{contact.id}}-{{timestamp}}) zur sauberen Deduplizierung.

Best Practices

• Consent: Sende CAPI-Events nur bei vorliegender Einwilligung; dokumentiere sie.

• Felder-Vollständigkeit: Je mehr Match-Daten, desto bessere Zuordnung (EMail, Phone, IP, UA, fbclid).

• Einheitliches Benennen: Workflows/Events konsistent (CAPI | Event | Quelle).

• Nur relevante Events: Weniger, sauber definierte Events sind besser als viele unklare.

• Monitoring: Im Events Manager regelmäßig Event Match Quality und Diagnose prüfen.

Häufige Fehler & Lösungen

Ergebnis

• Serverseitiges Lead-Tracking aus Funnelspot in den Meta Events Manager

• Robust gegen Browserrestriktionen, bessere Attribution deiner Kampagnen

• Grundlage geschaffen, um später weitere Events (Registrierung, Termin, Bewerbung, Kauf) sauber zu senden