So testen und verifizieren Sie Ihr PixelFlow CAPI-Setup

Überblick

Nachdem Sie Ihr PixelFlow-Setup auf Squarespace, Framer oder einer anderen Plattform abgeschlossen haben, müssen Sie überprüfen, ob Ihre Conversions API (CAPI) Ereignisse korrekt verfolgt und Daten an Meta sendet. Diese Anleitung führt Sie durch den vollständigen Testprozess, um sicherzustellen, dass Ihr Setup ordnungsgemäß funktioniert, Ereignisse korrekt ausgelöst werden und die Deduplizierung wie erwartet arbeitet.

Voraussetzungen

• Abgeschlossenes PixelFlow-Setup mit auf Ihrer Website installiertem Skript

• Meta-Pixel-ID und Access Token in PixelFlow konfiguriert

• Website veröffentlicht mit dem PixelFlow-Skript im Header

• Zugriff auf den Meta Events Manager

• Zugriff auf Ihr PixelFlow-Dashboard

Bevor Sie beginnen

Schritt 1: Nutzen Sie den integrierten Setup-Test

PixelFlow enthält ein automatisches Setup-Verifizierungstool, das unmittelbar nach der Installation auf eingehende Ereignisse prüft.

1. Während des PixelFlow-Setup-Assistenten erreichen Sie Schritt 4: Testen Sie Ihr Setup

2. Das System zeigt "Warten auf Ereignisse" mit einer Ladeanzeige an

3. Öffnen Sie Ihre Website in einem neuen Browser-Tab

4. Navigieren Sie durch ein paar Seiten, um PageView-Ereignisse auszulösen

5. Klicken Sie auf Schaltflächen oder besuchen Sie URLs, die Sie für das Tracking konfiguriert haben

6. Kehren Sie zum PixelFlow-Dashboard zurück

Was während des Tests passiert:

• PixelFlow fragt bis zu 1 Stunde lang alle 10 Sekunden nach Ereignissen ab

• Das System prüft, ob Ereignisse den Status is_sent_successfully: true haben

• Falls ein Ereignis fehlschlägt, sehen Sie die vollständige Fehlermeldung mit Schritten zur Fehlerbehebung

Schritt 2: PixelFlow Ereignis-Logs prüfen

Das PixelFlow-Dashboard bietet detaillierte Ereignis-Logs, in denen Sie genau sehen können, wann und wie jedes Ereignis getrackt wurde.

1. Loggen Sie sich in Ihr PixelFlow-Dashboard ein

2. Klicken Sie in der linken Seitenleiste auf Events

3. Wählen Sie Ihre Website aus dem Dropdown-Menü aus (falls Sie mehrere Seiten haben)

4. Überprüfen Sie die Tabelle "Detailed Events"

Worauf Sie in den Ereignis-Logs achten sollten:

• Spalte Status: Sollte bei erfolgreichen Ereignissen "Sent" (grünes Häkchen) anzeigen

• Event Type: Überprüfen Sie die korrekten Ereignisnamen (PageView, Lead, Purchase, etc.)

• Tracking URL: Prüfen Sie, ob die URLs mit Ihren konfigurierten Ereignis-URLs übereinstimmen

• Processed at: Der Zeitstempel zeigt an, wann das Ereignis getrackt wurde

• Pixel ID: Bestätigt, dass Ereignisse an das richtige Meta-Pixel gesendet werden

Filtern und Analysieren Ihrer Ereignisse:

1. Nutzen Sie die Schaltfläche Filters, um Ereignisse einzugrenzen nach:

   • Status (Sent oder Error)

   • Ereignistyp (Lead, Purchase, PageView, etc.)

   • Tracking-URL

2. Passen Sie den Date Range Picker an, um Ereignisse aus verschiedenen Zeiträumen anzuzeigen (Standard sind die letzten 3 Monate)

3. Klicken Sie auf die Schaltfläche Refresh, um die neuesten Ereignisse zu sehen

4. Erweitern Sie eine Ereigniszeile, um das vollständige JSON-Payload zu sehen, das an Meta gesendet wurde

Schritt 3: Ereignisse im Meta Events Manager verifizieren

Nachdem Sie bestätigt haben, dass Ereignisse in PixelFlow erscheinen, prüfen Sie, ob diese korrekt im Meta Events Manager ankommen.

1. Gehen Sie zum Meta Events Manager

2. Wählen Sie Ihr Pixel aus der Liste der Datenquellen aus

3. Klicken Sie auf den Tab Übersicht

4. Prüfen Sie das Aktivitätsdiagramm auf eingehende Ereignisse

Was Sie sehen sollten:

• Kürzliche Ereignisse erscheinen in der Aktivitäts-Timeline

• Ereigniszahlen stimmen mit denen in den PixelFlow-Logs überein (oder liegen nah beieinander)

• Sowohl Browser-Ereignisse (blau) als auch Server-Ereignisse (grün) im Diagramm

• Ereignisse, die als "Dedupliziert" markiert sind, wenn dieselbe Aktion sowohl vom Pixel als auch von der CAPI getrackt wurde

Schritt 4: Testereignisse-Modus (Optional, aber empfohlen)

Für Echtzeit-Debugging und Verifizierung nutzen Sie das Testereignisse-Tool von Meta, um Ereignisse beim Eintreffen zu beobachten.

1. Wählen Sie im Meta Events Manager Ihr Pixel aus

2. Klicken Sie auf den Tab Testereignisse

3. Scrollen Sie zu "Prüfen, ob deine Server-Events korrekt eingerichtet sind"

4. Klicken Sie auf Kopieren, um den Testereignis-Code zu kopieren

5. Gehen Sie zu Ihrem PixelFlow-Dashboard und bearbeiten Sie Ihre Pixel-Einstellungen

6. Aktivieren Sie den Test Mode und fügen Sie den Code in das Feld Test Event Code ein

7. Aktualisieren Sie Ihr Skript auf Ihrer Website und veröffentlichen Sie es neu

8. Scrollen Sie im Meta Events Manager unter Testereignisse zu "Prüfen, ob deine Website-Events korrekt eingerichtet sind"

9. Geben Sie Ihre Website-URL ein und klicken Sie auf Website öffnen

10. Navigieren Sie im neuen Browserfenster durch Ihre Website

11. Kehren Sie zum Tab Testereignisse im Meta Events Manager zurück

Was Testereignisse Ihnen zeigt:

• Ereignisse erscheinen in Echtzeit (innerhalb von Sekunden), während Sie diese auslösen

• Browser- und Server-Ereignisse werden separat aufgelistet

• Der Deduplizierungsstatus zeigt, welche Ereignisse erfolgreich zusammengeführt wurden

• Ereignisparameter und Datenqualität sind für jedes Ereignis sichtbar

Detaillierte Anweisungen zur Einrichtung finden Sie in unserem Guide zum Aktivieren des Meta-Testereignisse-Modus.

Schritt 5: Auf doppelte Ereignisse prüfen

Sicherzustellen, dass Ereignisse nicht dupliziert werden, ist genauso wichtig wie die Bestätigung, dass sie ausgelöst werden.

So identifizieren Sie Dubletten:

1. Schauen Sie sich im Meta Events Manager Ihr Ereignis-Aktivitätsdiagramm an

2. Prüfen Sie, ob die Ereigniszahlen signifikant höher sind als Ihr tatsächlicher Website-Traffic

3. Erweitern Sie in den PixelFlow-Ereignis-Logs ein Ereignis und prüfen Sie das JSON-Payload auf das Feld event_id

4. Prüfen Sie, ob dieselbe Aktion (z. B. Seitenbesuch, Formularübermittlung) mehrfach mit unterschiedlichen Event-IDs erscheint

Häufige Ursachen für doppelte Ereignisse:

• Mehrere Meta-Pixel-Skripte installiert: Auf Ihrer Website laufen gleichzeitig PixelFlow und ein manuell hinzugefügtes Meta-Pixel-Skript

• Native Plattform-Integrationen: Squarespace, Webflow oder andere Plattformen haben ihre eigene Facebook-Pixel-Integration neben PixelFlow aktiviert

• Tracking bei Neuladen der Seite: Nutzer, die Dankesseiten oder Bestellbestätigungen aktualisieren, lösen dieselbe Conversion mehrfach aus

• Mehrfache Tracking-Regeln: Dasselbe Ereignis ist sowohl über eine Tracking-URL als auch über einen klassenbasierten Trigger konfiguriert

So verhindern Sie Dubletten:

• Nutzen Sie nur PixelFlow für das Meta-Tracking – fügen Sie das Pixel nicht separat hinzu

• Prüfen Sie regelmäßig Ihre Ereignis-Logs, um ein sauberes Tracking zu verifizieren

• Vermeiden Sie es, denselben Ereignistyp auf mehrere Arten einzurichten (nutzen Sie nicht gleichzeitig URLs und Klassen für denselben Trigger)

• Nutzen Sie Ereignis-Blockierungsregeln, um doppelte Trigger durch Seitenaktualisierungen zu verhindern

Weitere Details finden Sie in unserem Artikel Warum manche Ereignisse dupliziert werden.

Schritt 6: Deduplizierung verifizieren

PixelFlow dedupliziert Ereignisse automatisch, indem es dieselbe event_id sowohl über den Browser (Pixel) als auch über den Server (CAPI) sendet. Meta nutzt diese ID, um doppelte Ereignisse zu einem einzigen Datensatz zusammenzuführen.

So bestätigen Sie die Deduplizierung:

1. Gehen Sie im Meta Events Manager zum Tab Übersicht

2. Schauen Sie auf das Aktivitätsdiagramm – Sie sollten Browser-Ereignisse (blau) und Server-Ereignisse (grün) sehen

3. Prüfen Sie, ob die Gesamtzahl der Ereignisse plausibel ist (nicht doppelt so hoch wie erwartet)

4. Im Testereignisse-Modus werden Ereignisse explizit als "Dedupliziert" markiert

PixelFlow verwaltet diesen Prozess automatisch – keine manuelle Konfiguration erforderlich. Für weitere Hintergrundinformationen lesen Sie Werden Ereignisse von PixelFlow dedupliziert?

Schritt 7: Alte Meta-Pixel-Skripte entfernen

Falls Sie das Meta-Pixel zuvor manuell oder über Plattform-Integrationen installiert hatten, müssen Sie es entfernen, um doppeltes Tracking zu verhindern.

Für Squarespace:

1. Loggen Sie sich bei Squarespace ein und gehen Sie zu Seiten

2. Erweitern Sie Individualisierter Code in der unteren linken Seitenleiste

3. Klicken Sie auf Code-Injektion

4. Suchen und löschen Sie im Abschnitt Header jeglichen Code, der mit <!-- Meta Pixel Code --> oder <script>!function(f,b,e,v,n,t,s) beginnt

5. Prüfen Sie auch den Abschnitt Footer und die Code-Injektionen einzelner Seiten

6. Gehen Sie zusätzlich zu Einstellungen > Erweitert > Externe Dienste

7. Falls eine Facebook-Pixel-ID eingetragen ist, entfernen Sie diese

8. Klicken Sie auf Speichern und veröffentlichen Sie Ihre Seite neu

Für Framer:

1. Öffnen Sie Ihr Framer-Projekt

2. Gehen Sie zu Settings (Zahnrad-Symbol oben rechts)

3. Wählen Sie General > Custom Code

4. Suchen Sie in den Abschnitten Start of <head> tag und End of <body> tag

5. Löschen Sie jeglichen Meta-Pixel-Code (beginnt mit !function(f,b,e,v,n,t,s))

6. Speichern Sie die Änderungen und veröffentlichen Sie Ihre Website neu

Für andere Plattformen:

• Prüfen Sie die Code-Injektion-Einstellungen, Header/Footer-Skripte oder Drittanbieter-Integrations-Einstellungen Ihrer Plattform

• Entfernen Sie alle Facebook/Meta-Pixel-Code-Snippets

• Deaktivieren Sie native Facebook-Pixel-Integrationen, falls Ihre Plattform diese anbietet

• Veröffentlichen Sie Ihre Website nach den Änderungen neu

Fehlerbehebung

Nächste Schritte

Sobald Ihr Setup verifiziert ist und die Ereignisse korrekt getrackt werden:

• Konfigurieren Sie zusätzliche Tracking-URLs für Ereignisse für spezifische Conversions (Formularübermittlungen, Käufe, etc.)

• Richten Sie klassenbasiertes Tracking für Schaltflächen und interaktive Elemente ein (plattformspezifische Anleitungen verfügbar)

• Überprüfen Sie Ihre Ereignis-Blockierungsregeln, um Bot-Traffic zu filtern oder doppelte Conversions durch Seitenaktualisierungen zu verhindern

• Überwachen Sie den Score für die Event-Match-Qualität im Meta Events Manager und verbessern Sie diesen durch korrekte Ereignisparameter

• Nutzen Sie die Daten in Ihren Meta-Werbekampagnen, um Targeting und Attribution zu optimieren

Plattformspezifische Setup-Guides

Möchten Sie Ihr ursprüngliches Setup noch einmal überprüfen? Schauen Sie in unsere Plattform-Guides:

• Squarespace Setup

• Framer Setup

• Webflow Setup

• WordPress Setup