Zum Hauptinhalt springen

Den Klar Pixel für Shopware 6 einrichten

Klar Pixel einrichten: Datasource anlegen, Domain validieren, Klar-Extension in Shopware installieren und URL-Parameter ergaenzen

Verfasst von Franz May

tl;dr

Das Einrichten des Klar Pixel für Shopware 6 besteht aus vier Schritten:

  1. Klar Pixel Datasource hinzufügen in Klar und Domain-Validierung konfigurieren

  2. Deine Domain validieren über zwei DNS-Records bei deinem Hosting-Provider

  3. Die Klar-Extension installieren in deinem Shopware-6-Store und mit dem Pixel verbinden

  4. URL-Parameter hinzufügen in deinen Ad-Accounts, damit Conversions und Kosten gematcht werden können

⚠️ Wichtig: Diese Anleitung nutzt die Klar Shopware Extension zusammen mit dem nativen Consent-Manager von Shopware. Wenn du ein Third-Party-Consent-Tool 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 Datasource an.


Damit unsere vollständig integrierte Attribution-Lösung funktioniert, musst du die Klar Pixel Datasource in Klar konfigurieren und ein Tracking-Script auf deiner Seite implementieren. Das dauert nur ein paar Minuten.

1️⃣ Klar Pixel Datasource hinzufügen

  1. Geh in der linken Sidebar zu Store Configurator → Data Sources und klicke auf Add New Data Source

  2. Wähle Klar Pixel

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

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

  5. Wähle deinen Tracking-Typ:

    1. Domain Validated Pixel (empfohlen) – Wir empfehlen dringend ein domain-validiertes Tracking-Script, da diese nicht vom Browser blockiert werden können

    2. Basic Tracking Script – ein Third-Party-Script, einfacher einzurichten, aber ungenauer

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

  7. Wenn du Basic Tracking Script gewählt hast, spring weiter zu Schritt 3


2️⃣ Deine Domain validieren (nur Domain Validated)

Klar stellt zwei DNS-Records bereit, die du in die DNS-Einstellungen deines Hosting-Providers kopierst.

⚠️ WebGo-, All-Inkl-, Strato-Nutzer: Wenn du die Records hinzufügst, entferne deine Domain aus dem Name-Feld. Gib nur das numerische Präfix ein.

Korrektes Format:

Record-Typ

Falsch ❌

Richtig ✅

CNAME

3450072213.yourshop.com

3450072213

CNAME IPv4

3450072213-4.yourshop.com

3450072213-4

  1. Kopiere beide DNS-Records über das Copy-Icon neben jedem Feld und füge sie ein

  2. Klicke auf Validate DNS Records

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

Sobald beide Records validiert sind, erscheinen das Tracking Script und deine Pixel Domain in der Datasource. 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 Consent-Manager von Shopware 6 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: Download Klar Pixel Attribution extension (.zip)

  2. Geh in deinem Shopware 6 Admin zu Extensions → My Extensions (Shopware-Anleitung: Meine Erweiterungen)

  3. Klicke auf Upload Extension und lade die heruntergeladene .zip-Datei hoch

  4. Aktiviere die Klar Pixel Extension

  5. Geh zurück zu Klar → Store Configurator → Data Sources → öffne deine Klar Pixel Datasource → kopiere die Pixel Domain (den hervorgehobenen Teil der Tracking-Script-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. Dieser Schritt ist erforderlich – ohne ihn ist die Extension nicht aktiv. Logge dich per SSH auf deinem Server ein 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. Du findest eine deutsche und englische Version in der Klar Pixel Datasource im Abschnitt Data Protection Snippet.


5️⃣ Klar-URL-Parameter implementieren

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

Hier sind Anleitungen, wie du das für jeden Marketing-Channel machst:


Was passiert als Nächstes?

Ab jetzt trackt Klar Besucher und Kaufaktivität in deinem Shopware-6-Store. Daten erscheinen ab dem nächsten Tag in deinen Attribution-Reports – historische Daten von vor dem Einbau des Scripts sind nicht verfügbar.

🎉 Dein Klar Pixel ist live – du kannst jetzt die Attribution-Reports nutzen!

Hat dies deine Frage beantwortet?