Reddit Pixel Event Tracking ＆ Conversion API

Installation instructions, documentation and FAQs for the Shopware plugin

Installation instructions

Install the extension via the extension area.

Reddit Einrichtung

  1. Erstelle ein Reddit Konto auf der business.reddit.com Seite.
  2. Gehe auf den Events Manager von Reddit von deiner Reddit Account Seite aus.
  3. Die Pixel ID steht direkt unter der Event Übersicht.
  4. Die Conversion ID kann über den Punkt „Conversion API“ im Events Manager erstellt werden. Speichere die ID nach dem Erstellen zwischen, der Token kann nicht wieder aufgerufen werden
Pixel ID im Events Manager
Erstellen einer Conversion ID

Setting up the extension in Shopware

Reddit Pixel ID Konfiguration

  • Reddit Pixel ID (Account ID): Setze hier die ID ein, welche im Event Manager zu finden ist.
  • Reddit Conversions API Access Token: Setze hier den erstellen Conversion Token ein.
  • Reddit Conversions API deaktivieren: deaktiviert die Conversion API.
  • Senden von Benutzerdaten an Reddit Conversions API deaktivieren.
  • Asynchrone Conversions-API-Aufrufe aktivieren (Message Queue).
  • Reddit Conversions-API-Protokollierung aktivieren: Aktiviere die Option für die Fehlersuche oder Kontrolle.

Kundenverwaltung

  • Reddit Pixel-Tracking für bestimmte Kundengruppen deaktivieren: Deaktiviere das Tracking für bestimmte Kundengruppen.

Einwilligungsverwaltung

  • Cookie Consent Manager auswählen: Wähle einen der folgenden Cookie Consent Managern aus:
    • Shopware Cookie Consent Manager
    • CookieBot
    • CookieFirst
    • UserCentrics
    • CCM19
    • CMP
  • Benutzerdefiniertes Datenattribut für Consent Manager (Experten-Modus): Für benutzerdefinierten Consent Manager, hier kann das zu verwendete Datenattribute angegeben werden.
  • Cookie-Kategorie für Shopware Cookie Consent Manager: Gib die Kategorie an, in der das Reddit Pixel angezeigt werden soll, funktioniert nur für den Shopware Cookie Consent Manager

Verhaltenseinstellungen

  • ViewContent-Event auf Home-Kategorie nicht auslösen: Aktivieren, um das Trackin des ViewContent-Events zu verhindern, wenn die Home/Root Kategorie geladen wird.

FAQs

Ja, die Reddit Conversions API ist vollständig in der Erweiterung integriert. Sie ermöglicht server-seitiges Tracking und ist besonders wichtig für:

  • Umgehung von Ad-Blockern und Browser-Tracking-Beschränkungen
  • Verbesserte Datenqualität und Match-Rates
  • Compliance mit Datenschutzbestimmungen
  • Zuverlässiges Tracking auch ohne Cookies.

Die Conversion API arbeitet parallel zum Browser-Pixel und sorgt für maximale Tracking-Genauigkeit.

die Erweiterung trackt folgende Standard-Events automatisch:

  • PageVisit: Wird bei jedem Seitenaufruf ausgelöst
  • ViewContent: Produktdetailseiten und Kategorien
  • AddToCart: Produkt wird in den Warenkorb gelegt
  • SignUp: Registrierungsseite (Checkout)
  • Lead: Bestätigungsseite vor dem Kaufabschluss
  • Purchase: Erfolgreicher Kaufabschluss mit Bestelldetails

Alle Events werden sowohl über den Browser-Pixel als auch über die Conversion API gesendet (falls konfiguriert).

Reddit verarbeitet Conversion-Daten nicht in Echtzeit. Es gibt eine normale Verzögerung von:

  • Pixel Events: 15-30 Minuten
  • Conversion API Events: bis zu 48 Stunden

Dies ist ein normaler Prozess bei Reddit Ads. Die Daten werden gesammelt, dedupliziert und verarbeitet, bevor sie im Dashboard erscheinen.

Debug-Tipp: Nutzen Sie die Browser-Konsole, um zu überprüfen, ob das Pixel korrekt geladen wird. Bei fehlender Pixel-ID erscheint eine Fehlermeldung in der Konsole.

Für optimale Shop-Performance sollten Sie die Message Queue für Conversion API Calls nutzen:

Schritt 1: Aktivieren Sie „Asynchrone Conversions API Aufrufe“ in den Plugin-Einstellungen
Schritt 2: Stellen Sie sicher, dass Ihre Message Queue läuft (z.B. via Cronjob oder Supervisor)

Dies sorgt dafür, dass API-Calls im Hintergrund verarbeitet werden und Ihre Shop-Performance nicht beeinträchtigen.

Ja, die Erweiterung ist vollständig DSGVO-konform einsetzbar:

  • Kompatibel mit allen gängigen Cookie Consent Managern
  • Eingebaute Opt-out Funktion für Benutzer
  • Keine Datenübertragung ohne Einwilligung (bei aktiviertem Consent Manager)
  • Verschlüsselte Übertragung von Benutzerdaten (SHA-256 Hashing)
  • Option zum Deaktivieren der Benutzerdaten-Übertragung

Wichtig: Stellen Sie sicher, dass Sie Reddit Pixel in Ihrer Datenschutzerklärung erwähnen und Ihren Cookie Consent Manager korrekt konfiguriert haben.

Ja, in den Erweiterung-Einstellungen können Sie unter „Kundenverwaltung“ beliebige Kundengruppen auswählen, die vom Tracking ausgeschlossen werden sollen. Dies ist besonders nützlich für:

  • Interne Mitarbeiter und Testkäufe
  • B2B-Kunden mit Sonderkonditionen
  • Wiederverkäufer und Partner

Für ausgeschlossene Kundengruppen wird weder der Pixel noch die Conversion API geladen.