Zum Hauptinhalt springen

Den Klar Pixel für WooCommerce einrichten

Den Klar-Tracking-Pixel mit deinem WooCommerce-Store verbinden, um das Attribution-Reporting zu nutzen

Verfasst von Frank Birzle

Du willst den Attribution-Report in Klar nutzen? Gute Wahl 🎉

Um das Attribution-Reporting zu aktivieren, musst du: eine Klar Pixel Datasource anlegen, das Tracking-Script auf deiner Seite implementieren und deine UTM-Parameter hinzufügen. Das dauert etwa 10–15 Minuten.

💡 Wenn du den Klar Pixel über den Google Tag Manager implementieren willst, nutze stattdessen diese Anleitung.


1️⃣ Die Klar Pixel Datasource hinzufügen

Wenn du mehrere WooCommerce-Instanzen mit separaten Domains mit Klar verbunden hast, solltest du für jeden Store eine eigene Pixel Datasource anlegen.

  1. Geh zu Store Configurator → Data Sources und klicke auf Add New Data Source

  2. Wähle Klar Pixel

  3. Gib einen Namen für die Datasource ein (z. B. Klar Tracking Script)
    ​

  4. Wähle deinen Tracking-Script-Typ und klicke auf Configure:

    • Domain Validated (First-Party) – empfohlen

    • Basic (Third-Party)
      ​

  5. Wähle Other als Shop System

✅ Wir empfehlen dringend das Domain-Validated-Script. Es liefert das Klar-JavaScript über eine Subdomain deiner eigenen Domain aus, was verhindert, dass es von Browsern blockiert wird, die Third-Party-Scripts einschränken. Das führt zu mehr getrackten Conversions.

Wenn du Basic Tracking gewählt hast: Du siehst dein Tracking-Script sofort. Spring weiter zu Abschnitt 3.

Wenn du Domain Validated gewählt hast: Gib deinen Domainnamen ein (ohne https:// und www.). Klar generiert zwei DNS-Records, die du bei deinem Hosting-Provider zu deinen DNS-Einstellungen hinzufügst.

6. Kopiere jeden DNS-Record über das Copy-Icon und füge ihn zu deinen DNS-Einstellungen hinzu

7. Klicke auf Validate DNS Records

⏱ Die DNS-Validierung kann ein paar Stunden dauern – in seltenen Fällen bis zu 2 Tage. Sobald verifiziert, erscheint ein grünes Häkchen-Icon neben dem Record. Nach der Validierung erscheint eine Tracking-Script-Box mit dem Script, das du auf deiner Seite implementierst.


2️⃣ Bei GoDaddy/WebGo/All Inkl/Strato gehostete Domain

Diese Hosting-Provider zeigen die DNS-Record-Namen bereits mit deiner vollständigen Domain angehängt an. Du musst sie vor dem Speichern entfernen.

Das Name-Feld zeigt etwas wie 123456789.your-shop.com – du musst aber nur das Subdomain-Präfix eintragen:

CNAME
❌ 123456789.your-shop.com
✅ 123456789

CNAME IPv4
❌ 123456789-4.your-shop.com
✅ 123456789-4

3️⃣ Das Klar-Script in deinem WooCommerce-Store implementieren

Lade das Klar WooCommerce Pixel Repository herunter

Du fügst deinem WooCommerce-Theme drei Custom Events hinzu, die Klar für die Attribution braucht.

Schritt 1 — Das Tracking-Script einbetten

Füge das generierte JavaScript aus deiner Klar Pixel Datasource in den <HEAD>-Bereich deines WooCommerce-Store-Templates ein. Das lässt sich je nach Setup auf mehrere Arten machen. Kontaktiere den Klar-Support über den In-App-Chat, wenn du Hilfe brauchst.

Schritt 2 — Custom Shortcodes zu deinem Theme hinzufügen

Finde dein aktives Theme unter Appearance → Themes.

Der Theme-Ordner liegt typischerweise unter:

wp-content/themes/[your-theme]/
  1. Lade custom-shortcodes.php in den Root-Ordner deines Themes hoch

  2. Passe die folgenden Dateien an, indem du den Inhalt aus den entsprechenden Dateien im Repository hinzufügst:

    • functions.php

    • checkout/thankyou.php

Falls checkout/thankyou.php in deinem Theme noch nicht existiert, kopiere das originale WooCommerce-Template aus:

wp-content/plugins/woocommerce/templates/checkout/thankyou.php

…in dein Theme unter:

wp-content/themes/[your-theme]/checkout/thankyou.php

Füge dann den Repository-Inhalt zu dieser Datei hinzu.

Schritt 3 — Shortcodes zu deinen Seiten hinzufügen

  1. Geh in WooCommerce zu Pages → Basket und füge einen neuen Shortcode-Block hinzu mit:

  2. Geh zu Pages → Checkout und füge einen neuen Shortcode-Block hinzu mit:

Debugging

Sobald alles installiert ist, öffne die Developer-Konsole deines Browsers und prüfe den Wert von:

q

Er sollte ein Array der Events enthalten, die ausgelöst wurden.


4️⃣ Datenschutz-Snippets hinzufügen

Stell sicher, dass du unser Datenschutz-Snippet in deine Datenschutzerklärung aufnimmst, um deine Kunden über die Nutzung des Klar-Tracking-Pixels zu informieren. Du findest ein deutsches und englisches Snippet in der Klar Pixel Datasource unter dem Tracking-Script in einem eingeklappten Abschnitt namens „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?

Klar beginnt sofort, Besucher- und Kaufaktivität zu tracken. Du siehst ab dem nächsten Tag Daten in deinen Reports – die Attribution ist ab dem Moment verfügbar, in dem das Script live ging. 🎉

Hat dies deine Frage beantwortet?