Pixelflow
Erste Schritte

So testen und verifizieren Sie Ihr PixelFlow CAPI-Setup

Übersicht

Nachdem Sie Ihr PixelFlow-Setup abgeschlossen haben, möchten Sie eventuell überprüfen, ob alles ordnungsgemäß eingerichtet ist. Im Folgenden finden Sie eine Reihe von Möglichkeiten, Ihr Setup zu verifizieren.

Entfernen Sie alle vorhandenen Meta-Pixel-Skripte von Ihrer Website, bevor Sie mit dem Testen beginnen. PixelFlow lädt sowohl das Meta-Pixel als auch die Conversions-API automatisch mit integrierter Deduplizierung. Ein separates Meta-Pixel-Skript führt zu doppelten Ereignissen und ungenauem Tracking. Überprüfen Sie die Code-Injektions-Einstellungen Ihrer Website, Header-Skripte und Plattform-Integrationen (wie die Facebook-Pixel-Integration von Squarespace) und entfernen Sie allen bestehenden Meta-Pixel-Code.

Es kann bis zu 40 Minuten dauern, bis Ereignisse nach ihrer Auslösung im Meta Events Manager erscheinen. Haben Sie bei den ersten Tests Geduld und geben Sie dem System genügend Zeit, damit die Daten fließen können.

1. Nutzen Sie den Realtime Event Monitor

Der Realtime Event Monitor ist ein kleines Widget, das auf Ihrer Website geladen wird und das nur Sie sehen können. Es ermöglicht Ihnen, auf ein beliebiges Element zu klicken und zu sehen, welches Ereignis ausgelöst und welche Daten gesammelt wurden. Lesen Sie hier mehr über den Realtime Event Monitor.

2. PixelFlow-Ereignisprotokolle prüfen

In Ihrem PixelFlow-Dashboard haben Sie Zugriff auf Ereignisprotokolle (Event Logs), in denen Sie genau sehen können, wann und wie jedes Ereignis getrackt wurde.

Worauf Sie in den Ereignisprotokollen achten sollten:

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

  • Ereignistyp: Überprüfen Sie die korrekten Ereignisnamen (PageView, Lead, Purchase usw.)

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

  • Verarbeitet am: 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. Verwenden Sie die Schaltfläche Filter, um Ereignisse einzugrenzen nach:

    • Status (Gesendet oder Fehler)

    • Ereignistyp (Lead, Purchase, PageView usw.)

    • Tracking-URL

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

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

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

Häufiges Problem: Wenn Sie die Meldung sehen „Es gibt keine Ereignisse für den ausgewählten Zeitraum für diese Seite“, ist entweder Ihr Skript nicht korrekt installiert oder es wurden noch keine Ereignisse ausgelöst. Überprüfen Sie Ihre Skript-Installation und besuchen Sie Ihre Website erneut, um Ereignisse auszulösen.

3. Ereignisse im Meta Events Manager verifizieren

Nachdem Sie bestätigt haben, dass Ereignisse in PixelFlow erscheinen, prüfen Sie, ob sie 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:

  • Aktuelle Ereignisse, die in der Aktivitäts-Timeline erscheinen

  • Ereigniszahlen, die mit denen in den PixelFlow-Protokollen übereinstimmen (oder ihnen nahekommen)

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

  • Ereignisse, die als „Dedupliziert“ markiert sind, wenn dieselbe Aktion sowohl über das Pixel als auch über CAPI getrackt wurde

Indikator für ein gesundes Setup: Sie sollten sowohl browserbasierte Ereignisse als auch serverseitige Ereignisse in Ihrem Meta Events Manager-Diagramm sehen. Die grüne Linie (Server-Ereignisse von PixelFlow CAPI) sollte eng der blauen Linie (Browser-Ereignisse vom Meta-Pixel) folgen. Dies zeigt, dass PixelFlow erfolgreich Ereignisse über beide Kanäle sendet.

4. Test-Ereignis-Modus (Optional, aber empfohlen)

Für Echtzeit-Debugging und Verifizierung nutzen Sie das Test Events Tool von Meta, um Ereignisse bei ihrem Eintreffen zu beobachten.

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

  2. Klicken Sie auf den Tab Ereignisse testen

  3. Scrollen Sie zu „Bestätigen, dass die Serverereignisse korrekt eingerichtet sind“

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

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

  6. Aktivieren Sie den Testmodus und fügen Sie den Test-Ereignis-Code in das Feld Test-Ereignis-Code ein

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

  8. Scrollen Sie im Meta Events Manager unter „Ereignisse testen“ zu „Bestätigen, dass deine Website-Ereignisse korrekt eingerichtet sind“

  9. Geben Sie Ihre Website-URL ein und klicken Sie auf Ereignisse testen

  10. Navigieren Sie in dem neuen Browserfenster, das sich öffnet, durch Ihre Website

  11. Kehren Sie zum Tab „Ereignisse testen“ im Meta Events Manager zurück

Was Ihnen das Test-Tool anzeigt:

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

  • Sowohl Browser- als auch Server-Ereignisse werden separat aufgelistet

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

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

Hinweis: Der Testmodus deaktiviert sich automatisch nach 30 Minuten, Sie können ihn jedoch jederzeit manuell deaktivieren. Sobald er deaktiviert ist, kehren die Ereignisse zum normalen Tracking zurück und erscheinen im Tab „Übersicht“ statt im Tab „Ereignisse testen“.

Detaillierte Anweisungen zur Einrichtung finden Sie in unserem Leitfaden zum Aktivieren des Meta-Testmodus.

5. Auf doppelte Ereignisse prüfen

PixelFlow lädt Pixel & Conversions-API automatisch zusammen, sodass Ereignisse über beide Wege mit der gleichen eventID gesendet werden. Dies stellt sicher, dass Ereignisse auf Metas Seite korrekt dedupliziert werden.

Wenn Sie jedoch andere Facebook-Skripte ausführen oder Ihr Pixel separat laden, kann dies zu doppelten Ereignissen führen.

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 Seiten-Reload: Benutzer aktualisieren Dankesseiten oder Bestellbestätigungsseiten, was dieselbe Conversion mehrfach auslöst

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

Duplikate sofort beheben: Entfernen Sie alle eigenständigen Meta-Pixel-Skripte von Ihrer Website. PixelFlow übernimmt sowohl Pixel als auch CAPI mit automatischer Deduplizierung, sodass kein zusätzlicher Pixel-Code erforderlich ist. Überprüfen Sie die Code-Injektions-Einstellungen Ihrer Plattform, native Facebook-Integrationen und seitenspezifische Skripte.

So verhindern Sie Duplikate:

  • Verwenden Sie ausschließlich PixelFlow für das Meta-Tracking – fügen Sie das Pixel nicht separat hinzu

  • Überprüfen Sie regelmäßig Ihre Ereignisprotokolle, um ein sauberes Tracking zu gewährleisten

  • Vermeiden Sie es, denselben Ereignistyp auf mehreren Wegen einzurichten (nutzen Sie nicht gleichzeitig Ereignis-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.

6. Verifizieren, ob die Deduplizierung funktioniert

PixelFlow dedupliziert Ereignisse automatisch, indem es dieselbe event_id sowohl über den Browser (Pixel) als auch über den Server (CAPI) sendet. Meta verwendet 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. Betrachten Sie das Ereignis-Aktivitätsdiagramm – Sie sollten sowohl Browser-Ereignisse (blau) als auch Server-Ereignisse (grün) sehen

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

  4. Wenn Sie den Testmodus verwenden, werden Ereignisse explizit als „Dedupliziert“ markiert

Indikator für erfolgreiche Deduplizierung: Im Test-Tool zeigt Meta den Status „Dedupliziert“ neben Ereignissen an, die sowohl vom Browser als auch vom Server mit übereinstimmenden Ereignis-IDs empfangen wurden. Dies ist die klarste Bestätigung, dass die Deduplizierung von PixelFlow korrekt funktioniert.

PixelFlow verwaltet diesen Prozess automatisch – keine manuelle Konfiguration erforderlich. Weitere Hintergründe finden Sie unter Werden Ereignisse durch PixelFlow dedupliziert?

7. Alte Meta-Pixel-Skripte entfernen

Wenn 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 Eigener Code in der Seitenleiste unten links

  3. Klicken Sie auf Code-Injektion

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

  5. Prüfen Sie auch den Bereich Footer sowie Code-Injektionen auf einzelnen Seiten

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

  7. Falls dort 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 den Einstellungen (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:

  • Überprüfen Sie die Code-Injektions-Einstellungen Ihrer Plattform, Header/Footer-Skripte oder Einstellungen für Drittanbieter-Integrationen

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

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

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

So verifizieren Sie die Entfernung: Nachdem Sie den alten Pixel-Code gelöscht haben, verwenden Sie die Facebook Pixel Helper Chrome Extension, um Ihre Website zu prüfen. Sie sollten nur noch ein Pixel sehen (das von PixelFlow) und keine mehrfachen Instanzen.

War das hilfreich?