Meta, Pixel und Conversions API

Server-Side-Dispatch an Meta. Pixel-ID kombiniert mit langlebigem CAPI-Token. Optional Hybrid-Modus für First-Party-fbp/fbc-Cookies.

Voraussetzungen

• Meta-Business-Account mit Pixel an deiner Domain.
• Admin- oder "Pixel verwalten"-Berechtigung auf dem Pixel.
• Etwa 5 Minuten.

1. Pixel-ID finden

• Meta Events Manager öffnen (business.facebook.com/events_manager).
• Pixel auswählen, der Beaconry-Events empfangen soll.
• Pixel-ID (16 Ziffern) steht oben. Kopieren.

2. CAPI-Access-Token generieren

• In derselben Pixel-Ansicht: Einstellungen → Conversions API → Direkte Integration einrichten → Mit Dataset Quality API.
• Klick Access Token generieren.
• Wichtig: im Scope-Picker NUR den Pixel für diese Beaconry-Installation auswählen. Den Token nicht für andere Pixel freigeben.
• Verifizieren, dass die Antwort Läuft ab: Nie zeigt. Beaconry braucht einen langlebigen System-User-Token, keinen 60-Minuten-Graph-Token.
• Token sofort kopieren. Meta zeigt ihn nur einmal an.

3. Credentials in Beaconry eintragen

WordPress-Admin → Beaconry → Tracking → Meta. Pixel-ID und Token einfügen, speichern.

Der Token wird verschlüsselt gespeichert (AES-256-CBC, gekoppelt an deine WordPress-Auth-Salts). Konstanten-Variante: BCNR_META_PIXEL_ID und BCNR_META_CAPI_TOKEN in wp-config.php, dann die Felder leer lassen.

4. (Optional) Test-Event-Code setzen

Während des Stagings: in Meta Events Manager → Test Events-Tab den TEST*-Code kopieren. Im Beaconry-Feld "Test Event Code" einfügen. Jedes Event, das Beaconry sendet, wird mit dem Code getaggt und in Test Events geroutet statt live zu gehen.

Den Test-Code vor dem Kampagnen-Start entfernen, sonst landen echte Conversions nie im Reporting.

5. Test-Event versenden

Klick Meta-Test-Event senden. Beaconry feuert ein synchrones ViewContent via CAPI und meldet die Antwort inline.

HTTP 200 ohne Fehler heißt: Credentials passen. Mit Test-Event-Code landet das Event innerhalb von Sekunden in Events Manager → Test Events. Ohne Code erscheint es in Reports → Realtime innerhalb von ~30 Sekunden.

6. Empfohlene Meta-Dataset-Einstellungen

Diese liegen in Meta, nicht in Beaconry. Sie erschließen Match-Rate und vermeiden gängige Fallen.

Pflicht:

• Domain-Verifizierung: Business-Einstellungen → Brand Safety → Domains. iOS 14.5+ verlangt das für jegliche Conversion-Attribution.
• Trusted-Domains-Liste: Pixel → Einstellungen → Traffic-Berechtigungen. Jede Produktiv-Domain eintragen, von der du Werbung schaltest.
• Aggregated Event Measurement: bis zu 8 Priority-Events pro verifizierter Domain, geordnet nach Wichtigkeit (Purchase > SubmitApplication > Lead > ViewContent).

Ausschalten:

• Automatic Advanced Matching: DSGVO-Risiko. Beaconry hashed dieselben Felder server-side mit kontrollierten Code-Pfaden.
• Automatisches Event-Tracking ohne Code: Heuristik kollidiert mit den expliziten Beaconry-Events.
• Conversions API Gateway / Signals Gateway / Partner Integration: Beaconry IST die direkte CAPI-Integration.

7. (Optional) Hybrid-Modus, Browser-Pixel

Server-Side-CAPI allein deckt 100 Prozent der zustimmenden Besucher. Hybrid-Modus lädt fbevents.js parallel, damit Meta die First-Party-fbp- und fbc-Cookies sieht. Beaconry dedupliziert Browser- und Server-Events über dieselbe stabile event_id.

Aktivieren in Beaconry → Tracking → Meta → Hybrid-Modus. Bessere Match-Rate, etwas mehr Bytes für den Besucher. Standardmäßig aus.

Was automatisch versendet wird

• PageView bei jedem zustimmenden Page-Load.
• ViewContent bei 50 % Scroll plus 10 Sekunden Engagement.
• Lead bei jeder Kadence-Blocks-Form- oder Fluent-Forms-Submission.
• WooCommerce-Funnel: AddToCart, InitiateCheckout, Purchase. Stabile per-Order-event_id für Browser-Pixel-Dedup.

Troubleshooting

• "Invalid OAuth access token": Token ist kurzlebig. Mit "Läuft ab: Nie" neu generieren.
• Events nicht in Test Events: Test-Event-Code fehlt oder ist abgelaufen. Frischen erzeugen.
• Match-Quality "Schlecht": Domain-Verifizierung oder AEM-Setup fehlt in Meta. Beaconry sendet die richtigen Felder, Meta braucht Domain-Trust, um sie zu nutzen.