Pixelflow
WordPress

WordPress-Einrichtung (per Plugin)

Dieser Artikel führt Sie durch den Prozess, wie Sie die Facebook Conversions-API auf WordPress einrichten.

Übersicht

Diese Anleitung führt Sie durch die Installation des PixelFlow WordPress-Plugins und die Einrichtung des Meta-Pixel-Trackings über das PixelFlow-Dashboard. Nach Abschluss dieser Schritte verfolgen Sie Page View-Events auf Ihrer Website und sind bereit für die Konfiguration des erweiterten Trackings.

Voraussetzungen

  • WordPress-Admin-Zugriff mit der Berechtigung, Plugins zu installieren

  • Ein Meta Business Manager-Konto mit Zugriff auf Ihre Meta-Pixel-Zugangsdaten

  • Entfernen Sie alle vorhandenen Facebook-Pixel-Skripte, um doppeltes Tracking zu vermeiden

Wenn Sie derzeit das Facebook-Pixel-Skript auf Ihrer WordPress-Seite installiert haben, müssen Sie es nach der Einrichtung von PixelFlow entfernen. Das gleichzeitige Ausführen beider Skripte führt zu doppeltem Event-Tracking. PixelFlow lädt sowohl das Facebook-Pixel als auch die Conversions-API automatisch.

1. Im PixelFlow-Dashboard anmelden oder registrieren

Bevor Sie mit dem Einrichtungsprozess beginnen, benötigen Sie ein PixelFlow-Konto.

  • Wenn Sie ein neuer Benutzer sind, erstellen Sie Ihr Konto während des Plugin-Authentifizierungsschritts (Schritt 4 unten).

  • Wenn Sie ein bestehender Benutzer sind, melden Sie sich während des Authentifizierungsschritts an.

  • Ein kostenloser 7-Tage-Testzeitraum startet automatisch, es ist keine Kreditkarte erforderlich.

Sie müssen das Dashboard nicht zuerst besuchen – die Authentifizierung erfolgt direkt über das WordPress-Plugin, wenn Sie es öffnen.

2. Das PixelFlow WordPress-Plugin installieren

  1. Laden Sie das PixelFlow-Plugin hier herunter

  2. Klicken Sie nach Abschluss der Installation auf Aktivieren

Installation abgeschlossen: Das PixelFlow-Plugin ist nun aktiviert und in Ihrem WordPress-Admin-Menü verfügbar.

3. PixelFlow-Plugin-Einstellungen öffnen

  1. Navigieren Sie in Ihrem WordPress-Admin-Menü zu Einstellungen → PixelFlow Settings

  2. Oder klicken Sie direkt unter dem Plugin-Namen in Ihrer Plugin-Liste auf den Link Settings

WordPress-Admin-Menü mit dem Ort der PixelFlow-Einstellungen
PixelFlow-Plugin mit hervorgehobenem Einstellungslink

Sie können die PixelFlow-Einstellungen jederzeit aufrufen unter: /wp-admin/options-general.php?page=pixelflow-settings

4. Im Plugin anmelden

Wenn Sie die PixelFlow-Einstellungen zum ersten Mal öffnen, sehen Sie einen Willkommensbildschirm mit Authentifizierungsoptionen.

Für bestehende PixelFlow-Benutzer:

  1. Klicken Sie auf Login

  2. Ein Popup-Fenster öffnet sich und leitet Sie zur PixelFlow-Anmeldeseite weiter.

  3. Geben Sie Ihre E-Mail und Ihr Passwort ein ODER nutzen Sie Sign in with Google

  4. Nach erfolgreicher Authentifizierung schließt sich das Popup automatisch.

  5. Kehren Sie zu Ihrem WordPress-Admin-Bereich zurück – das Plugin wird nun als authentifiziert angezeigt.

Für neue Benutzer:

  1. Klicken Sie auf Start Free Trial

  2. Ein Popup-Fenster öffnet sich und leitet Sie zur PixelFlow-Registrierungsseite weiter.

  3. Erstellen Sie Ihr Konto mit E-Mail und Passwort ODER nutzen Sie Sign in with Google

  4. Schließen Sie die Registrierung ab

  5. Das Popup schließt sich nach der Authentifizierung automatisch.

  6. Kehren Sie zu Ihrem WordPress-Admin-Bereich zurück – das Plugin wird nun als authentifiziert angezeigt.

Popups zulassen: Der Authentifizierungsprozess erfordert ein Popup-Fenster. Wenn Ihr Browser Popups blockiert, müssen Sie diese für Ihre WordPress-Seite zulassen, um die Anmeldung abzuschließen.

Authentifizierungs-Timeout: Sie haben 5 Minuten Zeit, um den Anmeldevorgang abzuschließen. Wenn die Sitzung abläuft, klicken Sie einfach erneut auf Login oder Start Free Trial, um eine neue Sitzung zu generieren.

5. Wizard öffnet sich automatisch: Autosync oder manueller Site-Sync

Nach der Authentifizierung werden Sie zum PixelFlow-Dashboard weitergeleitet, wo sich der Setup-Wizard automatisch öffnet und Sie durch die verbleibenden Schritte führt.

Automatischer Sync (empfohlen):

  • PixelFlow versucht, Ihre WordPress-Seitendomain automatisch zu erkennen.

  • Bei Erfolg werden Ihre Domain und Währung bereits vorausgefüllt.

  • Das WordPress-Plugin synchronisiert sich automatisch mit dem Dashboard.

Manueller Sync (falls Autosync fehlschlägt):

  • Wenn die automatische Erkennung nicht funktioniert, sehen Sie eine Warnmeldung.

  • Suchen Sie in Ihren WordPress-Plugin-Einstellungen das Feld Site ID.

  • Klicken Sie auf "Click here to copy your site ID", um sie in Ihre Zwischenablage zu kopieren.

  • Kehren Sie zum Wizard im PixelFlow-Dashboard zurück und fügen Sie die Site ID in das entsprechende Feld ein.

  • Dies synchronisiert Ihre WordPress-Seite manuell mit dem Dashboard.

Der Wizard nutzt einen 4-stufigen Prozess mit visueller Navigation, um Sie durch die Einrichtung zu führen. Sie können bei Bedarf zwischen den Schritten springen.

6. Site-Domain und Währung hinzufügen

Konfigurieren Sie im ersten Schritt des Wizards Ihre Website-Details:

  1. Ihre WordPress-Domain wird automatisch erkannt und angezeigt.

  2. Wählen Sie Ihre Währung aus dem Dropdown-Menü (optional, wird für das eCommerce-Tracking verwendet).

  3. Klicken Sie auf Continue, um zum nächsten Schritt zu gelangen.

Ihre WordPress-Seite ist nun mit PixelFlow verbunden und erscheint in Ihrer Sites-Liste im Dashboard.

7. Fügen Sie Ihr Meta-Pixel hinzu

PixelFlow lädt gleichzeitig Ihr Facebook-Pixel und die Facebook Conversions-API mit automatischer Event-Deduplizierung. Dies gewährleistet präzises Tracking und umgeht gleichzeitig Werbeblocker und iOS-Einschränkungen.

Im zweiten Schritt des Wizards fügen Sie Ihre Meta-Pixel-Zugangsdaten hinzu:

  1. Geben Sie einen Pixel Name ein (ein beliebiger Name für Ihre Unterlagen, z. B. "Haupt-Pixel Website")

  2. Fügen Sie Ihre Meta Pixel ID hinzu (auch Dataset-ID genannt; diese finden Sie im Facebook Events Manager)

  3. Fügen Sie Ihr Meta Pixel Access Token hinzu (generieren Sie dieses im Facebook Events Manager unter Einstellungen)

  4. Aktivieren Sie das Häkchen, um zu bestätigen, dass Sie jedes vorhandene native Meta-Pixel entfernt haben.

  5. Klicken Sie auf Add Pixel, um zu speichern.

Hilfe beim Finden der Zugangsdaten benötigt? Schauen Sie in unseren Guide: How to Find Your Meta Pixel ID and Access Token

8. PixelFlow im WordPress-Plugin aktivieren

Nachdem Ihr Pixel im Dashboard konfiguriert ist, kehren Sie zu Ihrem WordPress-Admin-Bereich zurück, um das Tracking zu aktivieren. Sie werden sehen, dass die Informationen zwischen Ihrem Dashboard und dem Plugin synchronisiert sind.

  1. Gehen Sie zu Einstellungen → PixelFlow Settings in WordPress zurück.

  2. Schalten Sie den Schalter Activate PixelFlow auf EIN.

  1. Klicken Sie auf die Schaltfläche Save Changes & Insert Script.

Ihr PixelFlow-Tracking-Skript ist jetzt aktiv! PixelFlow beginnt innerhalb von 2-3 Minuten automatisch mit dem Tracking von Page View-Events auf Ihrer WordPress-Seite.

Cache leeren: Wenn Sie ein Caching-Plugin verwenden (wie WP Rocket, W3 Total Cache oder WP Super Cache), müssen Sie Ihren Cache leeren, um sicherzustellen, dass das PixelFlow-Skript auf Ihrer Live-Website geladen wird.

Automatische Skript-Updates: Nach der Aktivierung von PixelFlow wird Ihr Skript automatisch aktualisiert, um neue Änderungen zu übernehmen. Neue Website-Besucher erhalten das Update sofort, aktive Besucher innerhalb von bis zu 5 Minuten (sobald der Skript-Cache ungültig wird). Von Ihrer Seite aus ist keine weitere Aktion erforderlich. Falls Sie Ihr Skript jedoch vor dem 27. November 2024 hinzugefügt haben, müssen Sie es ein letztes Mal auf die neueste Version aktualisieren, die sich künftig selbst aktualisiert.

9. Interagieren Sie mit Ihrer Seite und sehen Sie Konfetti

Der letzte Schritt im Wizard hilft Ihnen zu verifizieren, dass Ihre Einrichtung korrekt funktioniert.

  1. Besuchen Sie Ihre Live-Website in einem neuen Browserfenster oder im Inkognito-/Privatmodus.

  2. Navigieren Sie auf ein paar Seiten Ihrer Website (z. B. Homepage, dann auf einige Links klicken).

  3. Kehren Sie zum PixelFlow-Wizard zurück – dieser sucht alle 10 Sekunden automatisch nach Events.

  4. Sobald das erste Page View-Event erkannt wird, sehen Sie:

    • Eine Konfetti-Animation (lila, pinke und blaue Partikel aus der Mitte des Bildschirms)

    • Ein grünes Glückwunsch-Modal: "Congratulations! Your WordPress site is now connected to PixelFlow"

    • Der Wizard schließt sich automatisch.

  5. Der Status Ihrer Website in der Pixels-Tabelle auf Ihrer Übersichtsseite ändert sich auf "Connected".

Einrichtung abgeschlossen! PixelFlow trackt jetzt Page View-Events auf Ihrer Website. Events sollten innerhalb von 2-3 Minuten in Ihrem PixelFlow-Dashboard erscheinen.

Erscheinen keine Events? Wenn Sie nach ein paar Minuten keine Events sehen, prüfen Sie Folgendes:

  • "Activate PixelFlow" ist im Plugin auf EIN geschaltet.

  • Sie haben auf "Save Settings & Insert Script" geklickt.

  • Sie haben Ihren Cache geleert (falls Sie ein Caching-Plugin nutzen).

  • Sie besuchen die Live-Seite (keine lokale Entwicklungsumgebung).

Zusätzliche Überprüfung:

Detaillierte Schritte zur Überprüfung finden Sie unter How to Test and Verify Your PixelFlow CAPI Setup.

10. Weiteres Tracking einstellen

Nachdem der Wizard geschlossen wurde, können Sie zusätzliches Event-Tracking über Page Views hinaus konfigurieren.

Verfügbare Tracking-Optionen:

  • Event-Klassen: Tracken Sie Formularübermittlungen, Button-Klicks und benutzerdefinierte Interaktionen mithilfe von CSS-Klassen – siehe Event Classes on WordPress

  • Tracking-URLs: Tracken Sie spezifische Seitenaufrufe, Button-Klicks oder Link-Interaktionen – siehe How to Track Events

  • Formularübermittlungen: Erfassen Sie Lead-Daten aus Kontaktformularen – siehe How to Track Events for Form Submissions

  • Calendly-Integration: Tracken Sie Lead- oder Termin-Events automatisch, wenn Nutzer Anrufe buchen – siehe How to Track Calendars & Call Bookings

  • WooCommerce Auto-Tracking: Tracken Sie Produktansichten, Warenkörbe, Checkouts und Käufe automatisch (siehe Erweiterte Konfiguration unten).

In jedem Tarif ist das Tracking unbegrenzt, ohne Limits für Events oder Pixel.

Greifen Sie auf diese Einstellungen über die Übersichtsseite oder die Events-Seite Ihres PixelFlow-Dashboards zu. Jede Website kann individuelle Tracking-Konfigurationen haben.

Erweiterte Konfiguration

Skript für Benutzerrollen ausschließen

Möglicherweise möchten Sie keine Events von sich selbst, Redakteuren oder anderen WordPress-Benutzerrollen tracken. Standardmäßig werden alle Aktionen von Website-Besuchern erfasst.

Um bestimmte Benutzerrollen vom Tracking auszuschließen:

  1. Navigieren Sie in Einstellungen → PixelFlow Settings zum Abschnitt Advanced.

  2. Wählen Sie die Benutzerrollen aus, die Sie ausschließen möchten (Administrator, Editor, Shop Manager usw.).

  3. Klicken Sie auf Save Settings.

Einstellungen zum Ausschluss von Nutzerrollen im PixelFlow-Plugin

Das Ausschließen von Admin- und Editor-Rollen verhindert, dass Testaktionen Ihre Event-Zahlen verfälschen, und sorgt dafür, dass Ihre Meta-Ads-Daten präzise bleiben.

WooCommerce-Integration

Wenn Sie WooCommerce auf Ihrer Website installiert und aktiviert haben, kann PixelFlow automatisch alle erforderlichen Tracking-Klassen zu Ihren Produktseiten, dem Warenkorb und dem Checkout hinzufügen.

Schalter zum Aktivieren der WooCommerce-Integration
  1. Suchen Sie in Einstellungen → PixelFlow Settings den Abschnitt Enable WooCommerce Integration.

  2. Schalten Sie Enable WooCommerce Integration auf EIN.

  3. Klicken Sie auf Save Settings.

Die WooCommerce-Integration basiert auf Hooks und Filtern. Ihr Theme könnte diese modifizieren. Daher wird dringend empfohlen, nach der Aktivierung alle wichtigen Seiten zu testen: Produktseite, Warenkorb und Checkout.

Nach der Aktivierung der WooCommerce-Integration sehen Sie zusätzliche Konfigurationsoptionen:

WooCommerce-Integrations-Einstellungen mit Optionen zur Klassenzuweisung

Falls Probleme mit dem Seitenlayout oder Ladefehler auftreten, können Sie spezifische Klassen in den WooCommerce-Integrations-Einstellungen deaktivieren. Vergessen Sie nicht, die Einstellungen nach Änderungen zu speichern!

WooCommerce-Integration Debugging

Sie können das visuelle Debugging aktivieren, um zu prüfen, welche Elemente getrackt werden.

  1. Schalten Sie in den WooCommerce-Integrations-Einstellungen Debug WooCommerce Integration auf EIN.

  2. Dies fügt den getrackten Elementen visuelle Stile (Rahmen oder Hintergründe) hinzu, um sie leichter zu identifizieren.

  3. Besuchen Sie Ihre Produktseiten, den Warenkorb und den Checkout, um die hervorgehobenen Elemente zu sehen.

  4. Deaktivieren Sie den Debug-Modus, wenn Sie die Überprüfung abgeschlossen haben.

Debug-Modus für die WooCommerce CAPI-Integration

WooCommerce-Kauf-Tracking

Das Purchase-Event wird automatisch auf der „Bestellung erhalten“-Seite ausgelöst, wenn Track WooCommerce Purchase aktiviert ist.

Schalter für WooCommerce Kauf-Tracking

So funktioniert es:

  • Das Event wird nur einmal gesendet, wenn ein Kunde nach dem Checkout auf der „Bestellung erhalten“-Seite landet.

  • Events von ausgeschlossenen Benutzerrollen (Admin, Shop-Manager) werden nicht getrackt.

  • Wenn Debug WooCommerce Integration aktiviert ist, sehen Sie die Event-Bestätigung jedes Mal, wenn Sie die „Bestellung erhalten“-Seite zu Testzwecken besuchen.

Bestätigung eines WooCommerce Kauf-Events im Debug-Modus

Automatische Skript-Updates: Ihr PixelFlow-Skript wird automatisch aktualisiert, um neue Änderungen zu übernehmen. Neue Website-Besucher erhalten das Update sofort, aktive Besucher innerhalb von bis zu 1 Minute (sobald der Skript-Cache ungültig wird). Von Ihrer Seite aus ist keine weitere Aktion erforderlich. Falls Sie Ihr Skript jedoch vor dem 27. November 2025 hinzugefügt haben, müssen Sie es ein letztes Mal auf die neueste Version aktualisieren, die sich künftig selbst aktualisiert.

Fehlerbehebung

Symptom

Wahrscheinliche Ursache

Lösung

Anmeldefenster erscheint nicht

Popup-Blocker ist aktiviert

Erlauben Sie Popups für Ihre WordPress-Seite in den Browsereinstellungen und klicken Sie erneut auf Login.

Fehler "Authentication timeout"

Anmeldung hat länger als 5 Minuten gedauert

Kehren Sie zum WordPress-Admin zurück und klicken Sie auf Login oder Start Free Trial, um eine neue Sitzung zu generieren.

"An account with this email already exists"

E-Mail ist bereits mit einem E-Mail/Passwort-Konto verknüpft

Melden Sie sich stattdessen mit E-Mail und Passwort anstelle von Google OAuth an.

Autosync im Dashboard-Wizard schlägt fehl

WordPress-Seiteninformationen konnten nicht erkannt werden

Kopieren Sie die Site ID aus den WordPress-Plugin-Einstellungen und fügen Sie sie manuell im Dashboard-Wizard ein.

Keine Events im PixelFlow-Dashboard sichtbar

Cache nicht geleert oder Skript nicht aktiviert

Prüfen Sie, ob "Activate PixelFlow" auf EIN steht, klicken Sie auf "Save Settings & Insert Script" und leeren Sie Ihren Cache.

Events erscheinen nicht im Facebook Events Manager

Falsche Pixel-ID oder Access Token

Gehen Sie zum PixelFlow-Dashboard, prüfen Sie die Pixel-Zugangsdaten und klicken Sie in WordPress auf "Save Settings & Insert Script".

Kein Konfetti nach Interaktion mit der Seite

Events erreichen PixelFlow nicht oder Wizard-Timeout

Warten Sie 2-3 Minuten und prüfen Sie die Events-Seite manuell. Der Wizard sucht maximal für 1 Stunde.

WooCommerce-Integration nicht sichtbar

WooCommerce-Plugin ist nicht installiert oder aktiviert

Installieren und aktivieren Sie zuerst WooCommerce, dann laden Sie die PixelFlow-Einstellungen neu.

Doppelte Events im Meta Events Manager

Facebook-Pixel-Skript ist parallel zu PixelFlow installiert

Entfernen Sie das native Facebook-Pixel-Skript von Ihrer WordPress-Seite (in Theme-Dateien, Header/Footer-Skripten oder anderen Plugins).

Einschränkungen

  • Popup-Erfordernis: Die Authentifizierung erfordert ein Popup-Fenster. Falls Ihr Browser Popups blockiert, müssen Sie diese zulassen, um die Anmeldung abzuschließen.

  • Sitzungs-Timeout: Authentifizierungssitzungen laufen nach 5 Minuten ab. Wenn Sie die Anmeldung nicht in diesem Zeitraum abschließen, müssen Sie den Vorgang neu starten.

  • Manuelle Rückkehr zu WordPress: Nach der Authentifizierung im Popup-Fenster müssen Sie manuell zu Ihrem WordPress-Admin-Bereich zurückkehren – es erfolgt keine automatische Weiterleitung.

  • Wizard-Abfragezeitraum: Der Verifizierungsschritt sucht bis zu 1 Stunde nach Events. Danach müssen Sie die Events-Seite manuell prüfen.

  • WooCommerce-Theme-Kompatibilität: Einige Themes nutzen angepasste WooCommerce-Templates. Wenn die automatische Klassenzuweisung nicht korrekt funktioniert, müssen Sie Klassen eventuell manuell in Ihren Theme-Dateien hinzufügen.

  • Cache muss geleert werden: Änderungen erscheinen erst auf Ihrer Live-Seite, wenn Sie Ihr Caching-Plugin leeren.

Hilfe erhalten

Wenn Sie Probleme mit Ihrer WordPress-Einrichtung haben:

  • Prüfen Sie, ob Sie alle 10 Einrichtungsschritte abgeschlossen und Ihren Cache geleert haben.

  • Stellen Sie sicher, dass Ihre Meta-Pixel-ID und das Access Token im PixelFlow-Dashboard korrekt sind.

  • Nutzen Sie die Browser-Entwicklertools (F12), um Ihre Seite auf JavaScript-Fehler zu prüfen.

  • Besuchen Sie die PixelFlow Events Seite, um zu bestätigen, dass Events empfangen werden.

  • Kontaktieren Sie den PixelFlow-Support unter [email protected] oder buchen Sie einen kostenlosen Setup-Call

Wenn Sie den Support kontaktieren, geben Sie bitte Folgendes an:

  • Ihre WordPress-Seiten-URL

  • Screenshots etwaiger Fehlermeldungen

  • Ob Sie Events in Ihrem PixelFlow-Dashboard sehen

  • Ob Sie Events im Facebook Events Manager sehen

  • Ihre WooCommerce-Version (falls Sie die WooCommerce-Integration nutzen)

War das hilfreich?