Zum Hauptinhalt springen

Klar Pixel für Shopware 6 einrichten

Schritt-für-Schritt-Anleitung zur Einrichtung des Klar Pixel für Shopware 6.

Verfasst von Franz May

tl;dr

Die Einrichtung des Klar Pixel für Shopware 6 umfasst vier Schritte:

  1. Füge die Klar-Pixel-Datenquelle hinzu in Klar und konfiguriere die Domain-Validierung

  2. Validiere deine Domain über zwei DNS-Einträge bei deinem Hosting-Anbieter

  3. Installiere die Klar-Extension in deinem Shopware-6-Store und verbinde sie mit dem Pixel

  4. Füge URL-Parameter hinzu in deinen Werbekonten, damit Conversions und Kosten zugeordnet werden können

⚠️ Wichtig: Diese Anleitung nutzt die Klar Shopware Extension zusammen mit Shopwares nativem Consent-Manager. Wenn du ein Consent-Tool eines Drittanbieters verwendest (CookieBot, UserCentrics etc.), nutze stattdessen den Klar Pixel über Google Tag Manager.

Wenn du mehrere Shopware-6-Stores hast, lege für jeden eine eigene Klar-Pixel-Datenquelle an.


Um unsere vollständig integrierte Attributionslösung zu betreiben, musst du die Klar-Pixel-Datenquelle in Klar konfigurieren und ein Tracking-Skript auf deiner Seite implementieren. Das dauert nur wenige Minuten.

1️⃣ Klar-Pixel-Datenquelle hinzufügen

  1. Gehe in der linken Seitenleiste zu Store-KonfiguratorDatenquellen und klicke auf Neue Datenquelle hinzufügen

  2. Wähle Klar Pixel

  3. Gib einen Namen ein (z.B. Klar Pixel DE)

  4. Wähle Other als Shop-System (Shopware 6 nutzt ein eigenes Frontend — wähle nicht Shopify)

  5. Wähle deine Tracking-Methode:

    1. Pixel mit domainvalidierter Zertifizierung (empfohlen) — wir empfehlen dringend ein domainvalidiertes Tracking-Skript, da dieses vom Browser nicht blockiert werden kann

    2. Grundlegendes Tracking — ein Drittanbieter-Skript, einfacher einzurichten, aber weniger genau

  6. Wenn du Pixel mit domainvalidierter Zertifizierung gewählt hast, gib deine Domain ein (ohne https:// und www.) und klicke auf Konfigurieren

  7. Wenn du Grundlegendes Tracking gewählt hast, springe zu Schritt 3


2️⃣ Domain validieren (nur bei domainvalidiertem Pixel)

Klar stellt zwei DNS-Einträge bereit, die du in die DNS-Einstellungen deines Hosting-Anbieters kopierst.

⚠️ WebGo-, All-Inkl-, Strato-Nutzer: Wenn du die Einträge hinzufügst, entferne deine Domain aus dem Name-Feld. Trage nur den numerischen Präfix ein.

Korrektes Format:

Eintragstyp

Falsch ❌

Richtig ✅

CNAME

3450072213.yourshop.com

3450072213

CNAME IPv4

3450072213-4.yourshop.com

3450072213-4

  1. Kopiere beide DNS-Einträge über das Kopier-Symbol neben jedem Feld

  2. Klicke auf DNS-Einträge validieren

⚠️ Hinweis: Die DNS-Propagierung kann von wenigen Stunden bis zu 2 Tagen dauern. Sobald verifiziert, erscheint ein grünes Häkchen neben jedem Eintrag. Wenn du Hilfe brauchst, melde dich über den Support-Chat — wir helfen dir gerne.

Sobald beide Einträge validiert sind, erscheinen das Tracking-Skript und deine Pixel-Domain in der Datenquelle. Lass diesen Tab offen — du brauchst die Pixel-Domain in Schritt 3.


3️⃣ Die Klar-Extension in Shopware 6 installieren

Das gilt nur für dich, wenn du den Shopware-6-Consent-Manager nutzt. Wenn du einen anderen Consent-Management-Anbieter wie CookieBot, UserCentrics etc. verwendest, musst du den Klar Pixel über Google Tag Manager einrichten.

  1. Lade die Klar-Shopware-6-Extension herunter: Klar Pixel Attribution Extension herunterladen (.zip)

  2. Gehe in deinem Shopware-6-Admin zu ErweiterungenMeine Erweiterungen (Shopware-Anleitung: Meine Erweiterungen)

  3. Klicke auf Erweiterung hochladen und lade die heruntergeladene .zip-Datei hoch

  4. Aktiviere die Klar Pixel Extension

  5. Gehe zurück zu KlarStore-KonfiguratorDatenquellen → öffne deine Klar-Pixel-Datenquelle → kopiere die Pixel-Domain (der hervorgehobene Teil der Tracking-Skript-URL)

  6. Öffne in deinem Shopware-6-Admin die Einstellungen der Klar Pixel Extension und füge die Pixel-Domain in das Feld Klar Pixel Domain ein

  7. 🚨 Baue dein Shopware-6-Storefront neu auf. Dieser Schritt ist erforderlich — ohne ihn ist die Extension nicht aktiv. Melde dich per SSH auf deinem Server an und führe aus:

bin/build-storefront.sh

4️⃣ Das Datenschutz-Snippet hinzufügen

Füge das Klar-Datenschutz-Snippet zu deiner Datenschutzerklärung hinzu. Eine deutsche und englische Version findest du in der Klar-Pixel-Datenquelle im Abschnitt Data Protection Snippet.


5️⃣ Klar-URL-Parameter implementieren

Damit Conversions und Kosten so genau wie möglich zugeordnet werden können, musst du die vordefinierten Klar-Tracking-Codes in deinen Werbekonten implementieren.

Hier findest du Anleitungen für jeden Marketing-Kanal:


Was passiert als Nächstes?

Ab jetzt trackt Klar Besucher und Kaufaktivitäten in deinem Shopware-6-Store. Die Daten erscheinen ab dem nächsten Tag in deinen Attributionsberichten — historische Daten von vor der Skript-Einbindung sind nicht verfügbar.

🎉 Dein Klar Pixel ist live — du kannst jetzt die Attributionsberichte nutzen!

Hat dies deine Frage beantwortet?