Hematek Solutions
Support Projekt anfragen

Tracking · Plugin für JTL-Shop 5

Meta Pixel & Conversion API

Browser- und Server-Tracking für Meta – dedupliziert, gehasht und an die Einwilligung gebunden.

  • Pixel und Conversion API in einem Plugin
  • Deduplizierung über eine gemeinsame event_id
  • Elf Standard-Events, einzeln aktivierbar
Im JTL Extension Store ansehen (öffnet in neuem Tab) Frage zum Plugin

01 Problem & Lösung

Wofür es dieses Plugin gibt.

Das Problem

Nur mit dem Pixel im Browser gehen Conversions verloren – durch Werbeblocker, Browser-Einschränkungen oder abgebrochene Skripte. Wer zusätzlich die Conversion API nutzt, hat das nächste Problem: Ohne saubere Deduplizierung zählt Meta Ereignisse doppelt.

Die Lösung

Das Plugin sendet Events über den Meta Pixel und serverseitig über die Conversion API. Beide Wege verwenden dieselbe event_id, damit Meta Duplikate erkennt. Nutzerdaten werden nach Meta-Spezifikation mit SHA256 gehasht. Ohne Einwilligung im JTL Consent Manager pausieren Pixel und CAPI.

02 Einblick

So sieht es aus.

Screenshots aus dem Plugin-Backend bzw. aus dem Shop-Frontend.

Plugin-Backend des Meta-Pixel-Plugins mit Feldern für Pixel-ID, Access Token und Test Event Code sowie Auswahl für Tracking-Modus und Debug-Modus
Abb. 01 Plugin-Backend: Zugangsdaten, Tracking-Modus und Debug-Ebene an einem Ort.

03 Unterstützte Events

11 Events entlang der Customer Journey.

  1. PageView Jeder Seitenaufruf
  2. ViewContent Produktansicht inklusive Kategoriepfad
  3. ViewCategory Kategorie- und Listenansichten
  4. Search Suche im Shop
  5. AddToCart Artikel in den Warenkorb gelegt
  6. AddToWishlist Artikel auf die Wunschliste gesetzt
  7. InitiateCheckout Start des Bestellvorgangs
  8. AddPaymentInfo Zahlungsart gewählt
  9. CompleteRegistration Kundenkonto angelegt
  10. Contact Kontaktformular abgesendet
  11. Purchase Bestellabschluss mit transaction_id

04 Funktionen

Was das Plugin im Detail kann.

Tracking

  • Meta Pixel (Browser) und Conversion API (Server)
  • Tracking-Modus wählbar: Pixel, CAPI oder beides
  • Jedes Standard-Event separat aktivierbar

Datenqualität

  • Einheitliche event_id für Pixel und Conversion API
  • client_ip_address und client_user_agent werden an die CAPI übergeben
  • fbp- und fbc-Cookies werden berücksichtigt; fbc im Meta-Format mit Millisekunden-Zeitstempel
  • Produkt-Events mit content_ids und contents (id, quantity, item_price)
  • Purchase mit transaction_id, Versand, Steuern und num_items

Einwilligung

  • Integration mit dem JTL Consent Manager inklusive automatischer Registrierung
  • Kein Tracking ohne aktive Einwilligung
  • SHA256-Hashing der Nutzerdaten nach Meta-Spezifikation

Test & Debugging

  • Unterstützung für Test Event Codes
  • Debug-Modus mit Logging im Shop-Backend
  • Prüfung der Events im Meta Events Manager

05 Anwendungsfälle

Wofür Händler es einsetzen.

  • Kampagnen auf vollständigeren Daten optimieren

    Meta optimiert Anzeigen auf Basis der Conversions, die ankommen. Serverseitige Events schließen Lücken, die im Browser entstehen.

  • Attribution ohne Doppelzählung

    Durch die gemeinsame event_id zählt Meta ein Ereignis einmal – auch wenn es über Pixel und Conversion API eintrifft.

  • Kontrollierter Rollout

    Mit Test Event Code und Debug-Modus prüfen Sie jedes Event im Events Manager, bevor Sie live gehen.

06 Technische Details

Voraussetzungen, Installation, Versionen.

Alles, was Sie vor dem Kauf und bei der Einrichtung wissen müssen.

Nutzungs- und Systemvoraussetzungen

Nutzung

  • Meta Business Manager mit Pixel-ID; für die Conversion API ein Access Token
  • Optional: Test Event Code für die Einrichtung
  • Aktiver JTL Consent Manager oder kompatibles Consent-System
  • Grundkenntnisse im JTL-Shop-Backend

System

  • JTL-Shop 5.2.0 – 5.7.1 (Version 1.0.1)
  • PHP 8.1 – 8.3
  • HTTPS im Shop – erforderlich für Conversion API und Cookies
  • Ausgehende HTTPS-Verbindungen zur Meta Graph API
Installation und Einrichtung

  1. Im Extension Store erwerben

    Plugin im JTL Extension Store buchen und die Lizenz dem Shop zuordnen.

  2. Installieren und aktivieren

    Installation im Shop-Backend; das Plugin registriert sich dabei im JTL Consent Manager.

  3. Zugangsdaten und Events

    Pixel-ID und Access Token hinterlegen, Tracking-Modus wählen und die gewünschten Events aktivieren.

  4. Testen

    Debug-Modus und Test Event Code nutzen und die Events im Meta Events Manager sowie im Shop-Log prüfen.

Changelog

  1. v1.0.1

    • fbc-Parameter wird im Meta-Format mit Millisekunden-Zeitstempel gesendet
    • Zeitstempel-Erzeugung in JavaScript und PHP korrigiert
    • Bestehende _fbc-Cookies behalten ihre ursprüngliche Erstellungszeit
    • Kompatibilität mit Meta Pixel und Conversions API verbessert

  2. v1.0.0

    • Erstveröffentlichung

Quelle: Changelog im JTL Extension Store.

Optionale Services im Extension Store

Installationsservice 49,00 € zzgl. USt.

Enthalten

  • Installation und Aktivierung des Plugins
  • Grundkonfiguration: Pixel-ID, Access Token, Test Event Code, Tracking-Modus, Event-Auswahl
  • Consent-Prüfung
  • Basistest von PageView, AddToCart und Purchase
  • Zusammenfassung der Einstellungen

Einrichtungsservice 79,00 € zzgl. USt.

Enthalten

  • Prüfung der Installation
  • Validierung von Pixel-ID und Conversion API
  • Prüfung von Event-Zuordnung und Deduplizierung
  • Test von ViewContent, AddToCart, InitiateCheckout und Purchase
  • Test im Meta Events Manager und Best-Practice-Empfehlungen

Nicht enthalten

  • Einrichtung von Business Manager oder Werbekonto
  • Kampagnen- oder Tracking-Strategie
  • Individueller Code, Template-Änderungen, eigene Events
  • Rechtsberatung und laufendes Monitoring

07 Häufige Fragen

Fragen zu Meta Pixel & Conversion API

Ihre Frage ist nicht dabei? Fragen Sie uns direkt.

Muss ich Pixel und Conversion API gleichzeitig nutzen?

Nein. Sie wählen zwischen Pixel, Conversion API oder beidem. Die Kombination ist empfohlen, weil sich die Wege ergänzen; die gemeinsame event_id verhindert Doppelzählungen.

Was passiert ohne Einwilligung?

Dann werden weder Pixel- noch CAPI-Events gesendet. Das Plugin richtet sich nach der Einwilligung im JTL Consent Manager.

Was passiert, wenn die Lizenz ausläuft?

Laut JTL Extension Store läuft das Plugin weiter. Updates erhalten Sie nach einer Verlängerung wieder.

Richten Sie das Plugin für mich ein?

Ja – über den Installations- oder Einrichtungsservice, den Sie im Extension Store mitbuchen. Kampagnenstrategie, Business-Manager-Einrichtung und individuelle Events sind dort nicht enthalten; dafür setzen wir bei Bedarf ein Tracking-Projekt auf.

Mehr als ein Plugin nötig?

Wenn der Standardumfang nicht reicht, entwickeln wir weiter.

Zusätzliche Events, besondere Templates, mehrere Systeme: Im Bereich Tracking & Marketing-Technologie setzen wir individuelle Lösungen um – auf Wunsch aufbauend auf diesem Plugin.

Tracking & Marketing-Technologie Projekt anfragen

Weitere Plugins

Auch von Hematek.