Schritt 1: Klar Pixel Datasource hinzufügen
Mehrere WooCommerce-Stores? Wenn du mehr als eine Store-Instanz mit separaten Domains mit Klar verbunden hast, lege für jeden Store eine eigene Pixel Datasource an.
Geh zu Store Configurator → Data Sources und klicke auf Add New Data Source
Wähle Klar Pixel
Gib einen Namen für die Datasource ein – z. B. „Klar Tracking Script"
Wähle zwischen Domain Validated (First-Party) oder Basic (Third-Party) Tracking und klicke auf Configure
⚠️ Wir empfehlen dringend Domain Validated. Das Script feuert unter deiner eigenen Subdomain (z. B. 123456789.yourshop.com) statt unter einer Klar-eigenen Domain. Das verhindert, dass Ad-Blocker und Browser-Privacy-Einstellungen es blockieren, und gibt dir eine deutlich höhere Tracking-Genauigkeit. Basic Tracking ist schneller eingerichtet, aber weniger zuverlässig.
Wenn du Basic gewählt hast: Du siehst dein Tracking-Script sofort. Spring weiter zu Schritt 3.
Wenn du Domain Validated gewählt hast: Mach mit Schritt 2 weiter.
Schritt 2: Deine DNS-Records einrichten (nur Domain Validated)
Gib die Domain deines Shops ein – ohne
https://und ohnewww.Klar zeigt dir zwei DNS-Records (einen CNAME und einen CNAME IPv4), die du in den Einstellungen deines DNS-Providers hinzufügst. Kopiere jeden Wert über das Copy-Icon.
Sobald die Records gespeichert sind, klicke in Klar auf Verify Integration. Die DNS-Propagation dauert in der Regel ein paar Stunden, in seltenen Fällen aber bis zu 48 Stunden. Sobald verifiziert, erscheint ein grünes Häkchen neben jedem Record.
Sobald alle Records verifiziert sind, erscheint dein Tracking Script – kopiere es für den nächsten Schritt.
⚠️ GoDaddy, WebGo, All Inkl, Strato – typische Stolperfalle: Diese Provider wollen, dass du im „Name"-Feld nur den Subdomain-Teil einträgst, nicht den vollständigen Hostname. Entferne deine Domain aus dem Wert, den Klar dir gibt:
CNAME Name – Falsch: 123456789.yourshop.com → Richtig: 123456789 CNAME IPv4 Name – Falsch: 123456789-4.yourshop.com → Richtig: 123456789-4
Schritt 3: Das Script zu deinem Tag Management System hinzufügen
Erstelle in deinem TMS (z. B. Google Tag Manager) einen neuen Custom-HTML-Tag und füge das Klar-Tracking-Script hinein. Stelle den Trigger so ein, dass er auf All Pages feuert.
Schritt 4: Die drei Custom Events implementieren
Zusätzlich zum Basis-Script musst du drei Custom Events feuern, damit Klar Warenkorb- und Checkout-Aktivität tracken kann. Alle drei Events funktionieren über ein Push an window._k_q.
Klar:sendUpdateCartEvent
Feuere dieses Event, wann immer der Kunde ein Produkt zum Warenkorb hinzufügt oder daraus entfernt.
Erforderlich: cartId
Gut zu wissen: Wenn dein Shop-System keine cartId bereitstellt, kannst du stattdessen die sessionId (Context-ID) verwenden. Nicht sicher, wie du eine erstellst? So richtest du eine Session-ID im GTM ein.
<script>
(function() {
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendUpdateCartEvent", { cartId: 12345 }]);
})();
</script>
Klar:sendUpdateCheckoutEvent
Feuere dieses Event, wenn der Kunde den Checkout betritt.
Erforderlich: checkoutId Optional: cartId, customerId
Gut zu wissen: Wenn dein Shop keine checkoutId oder cartId bereitstellt, verwende stattdessen die sessionId. Lass customerId bei Gast-Checkouts leer. So erstellst du eine Session-ID im GTM →
<script>
(function() {
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendUpdateCheckoutEvent", {
cartId: 12345,
checkoutId: 12345,
customerId: 34567
}]);
})();
</script>
Klar:sendOrderEvent
Feuere dieses Event auf der Bestellbestätigungsseite, nachdem der Kauf abgeschlossen ist.
Erforderlich: orderId, transactionId Optional: cartId, customerId
Gut zu wissen: Gleiche Regeln wie oben – verwende sessionId als Fallback für fehlende IDs und lass customerId bei Gästen leer. So erstellst du eine Session-ID im GTM →
<script>
(function() {
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendOrderEvent", {
orderId: 12345,
transactionId: 12345,
cartId: 12345,
customerId: 12345
}]);
})();
</script>
Troubleshooting: Wenn ein Event feuert, aber fehlschlägt, erscheint eine beschreibende Fehlermeldung in der Browser-Konsole. Bei allen anderen Problemen melde dich über den In-App-Chat.
Schritt 5: Das Datenschutz-Snippet zu deiner Datenschutzerklärung hinzufügen
Klar stellt ein fertiges Datenschutz-Snippet (auf Deutsch und Englisch) bereit, das du zur Datenschutzerklärung deines Shops hinzufügen musst. Du findest es in den Einstellungen der Klar Pixel Datasource, unterhalb des Tracking-Scripts, im eingeklappten Abschnitt „Data Protection Snippet".
Schritt 6: URL-Parameter in deinen Ad-Accounts einrichten
Um Conversions und Kosten über die Channels hinweg genau zu matchen, füge die Tracking-Parameter von Klar zu den URLs deiner Ad-Accounts hinzu:
Hier sind Anleitungen, wie du das für jeden Marketing-Channel machst:
Was passiert als Nächstes?
Klar beginnt sofort, Besucher und Kaufaktivität auf deiner Seite zu tracken. Du siehst ab dem nächsten Tag Daten in deinen Attribution-Reports – beachte, dass Attributionsdaten erst ab dem Moment verfügbar sind, in dem das Script live ging, nicht rückwirkend.