Zum Hauptinhalt springen

Den Klar Pixel über ein Tag Management System einrichten (voller Funktionsumfang)

Tracke jeden Visit, Product View, Cart-Action und jede Bestellung mit dem Klar Pixel, komplett ueber den Google Tag Manager (GTM)

Verfasst von Michael Stenger

tl;dr

  • Lege eine Klar Pixel Datasource an, validiere deine Domain und füge das Tracking-Script als Custom-HTML-Tag auf All Pages hinzu.

  • Vier Events sind erforderlich: Product Viewed, Add to Cart, Update Checkout und Order.

  • Remove from Cart, Shipping Info und Payment Info sind empfohlen. Sie vervollständigen deine Funnel-Sicht pro Channel und Kampagne.

  • Sende die gleiche Product ID, die dein Shop-System an Klar sendet. Schritt 4 zeigt, welche das für dein Shop-System ist.

  • Teste alles in der GTM Preview, bevor du veröffentlichst. Beobachte danach, wie deine Pixel-Coverage im Action Centre aufgebaut wird.


Bevor du startest

Du brauchst:

  • Publish-Zugriff auf deinen Google Tag Manager Container.

  • Einen Data Layer, der bei deinen wichtigsten Shop-Aktionen feuert. Idealerweise die Standard-GA4-Ecommerce-Events (view_item, add_to_cart, begin_checkout, purchase …).

  • Eine Cart ID und Checkout ID aus deinem Shop-System. Keine IDs verfügbar? Nutze stattdessen eine Session-ID → Eine Session-ID im Google Tag Manager erstellen.

  • Zugriff auf deine DNS-Einstellungen (für Domain-Validated-Tracking).


Welche Events soll ich senden?

Event

Wann es feuert

GA4-Data-Layer-Event

Priorität

Base Script (Visit / Page View)

Bei jedem Seitenaufruf

All Pages (Page-View-Trigger)

Erforderlich

Klar:sendProductViewedEvent

Produktdetailseite

view_item

Erforderlich

Klar:sendAddToCartEvent

Produkt in den Warenkorb gelegt

add_to_cart

Erforderlich

Klar:sendUpdateCheckoutEvent

Kunde betritt den Checkout

begin_checkout

Erforderlich

Klar:sendOrderEvent

Bestellbestätigungsseite

purchase

Erforderlich

Klar:sendRemoveFromCartEvent

Produkt aus dem Warenkorb entfernt

remove_from_cart

Empfohlen

Klar:sendShippingInfoEvent

Versanddetails eingegeben

add_shipping_info

Empfohlen

Klar:sendPaymentInfoEvent

Zahlungsdetails eingegeben

add_payment_info

Empfohlen

Klar:customConversionEvent

Jedes eigene Ziel (z. B. Newsletter-Anmeldung)

dein eigenes Event

Optional

Klar:signupEvent

E-Mail in einem Signup-Formular erfasst

das Submit-Event deines Formulars

Optional

Warum auch die empfohlenen Events senden? Die erforderlichen Events decken Attribution und den Kern-Funnel ab. Remove from Cart, Shipping Info und Payment Info zeigen, wo Kunden innerhalb des Checkouts abspringen – pro Channel und Kampagne.


Schritt 1: Die Klar Pixel Datasource hinzufügen

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

  2. Wähle Klar Pixel.

  3. Benenne die Datasource, z. B. Klar Tracking Script.

  4. Wähle Domain Validated (empfohlen) oder Basic und klicke auf Configure.

Wir empfehlen dringend Domain Validated. Das Script läuft dann unter deiner eigenen Subdomain (z. B. 123456789.yourshop.com). Ad-Blocker und Browser-Privacy-Einstellungen blockieren es dann deutlich seltener.

Mehrere Top-Level-Domains? Wenn du mehr als eine Top-Level-Domain hast, lege für jede Top-Level-Domain eine eigene Pixel Datasource an.

Basic gewählt? Dein Tracking-Script erscheint sofort. Spring zu Schritt 3.


Schritt 2: Deine DNS-Records einrichten (nur Domain Validated)

  1. Gib deine Shop-Domain ein, ohne https:// und ohne www.

  2. Füge die zwei DNS-Records, die Klar dir zeigt (CNAME und CNAME IPv4), bei deinem DNS-Provider hinzu.

  3. Klicke auf Verify DNS Records. Die Propagation dauert in der Regel ein paar Stunden, in seltenen Fällen bis zu 48 Stunden.

  4. Sobald beide Records ein grünes Häkchen zeigen, kopiere das Tracking Script.

⚠️ 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 Base Script in GTM hinzufügen

  1. Klicke in GTM auf Tags → New und wähle Custom HTML.

  2. Füge das Klar-Tracking-Script ein.

  3. Stelle den Trigger auf All Pages (Page View).

  4. Benenne den Tag Klar – Base Script und speichere.

Consent: Feuere das Base Script entsprechend deinem Consent-Setup, genauso wie deine anderen Analytics-Tags.


Schritt 4: Deine Variablen anlegen

Lege diese als Data Layer Variables an (Variables → New → Data Layer Variable). Passe die Pfade an deinen Data Layer an.

GTM-Variable

Wert

Verwendet in

DLV – Cart ID

die Cart ID deines Shops oder die Session-ID-Variable

Add to Cart, Remove from Cart, Update Checkout, Order

DLV – Checkout ID

die Checkout ID deines Shops oder die Session-ID-Variable

Update Checkout, Shipping Info, Payment Info

DLV – Order ID

die Bestellnummer deines Shops

Order

DLV – Customer ID

die Customer ID deines Shops (leer bei Gästen)

Update Checkout, Order

DLV – Item ID

die Product ID für dein Shop-System (siehe Tabelle unten). Im GA4-Format meist ecommerce.items.0.item_id

Product Viewed, Add to Cart, Remove from Cart

Keine Cart- oder Checkout-ID? Nutze eine Session-ID für beide → Eine Session-ID im Google Tag Manager erstellen.

Welche Product ID soll ich senden?

Die productId muss dieselbe ID sein, die dein Shop-System an Klar sendet. Sonst können Product Views und Cart-Aktionen nicht deinen Produkten und Bestellungen zugeordnet werden. Prüfe, was dein Data Layer in item_id schreibt: Oft ist es die SKU oder eine Variant ID, was vielleicht nicht die richtige ist.

Shop-System

Als productId senden

Shopware 6

Die Produkt-UUID des Artikels. Bei Varianten die UUID der Variante (in Shopware ist eine Variante ein Produkt mit einem Parent).

Shopware 5

Die Artikelnummer. Wenn sie leer ist, der Artikelname.

WooCommerce

Die Variation ID bei variablen Produkten, sonst die Product ID.

Oxid

Die Artikel-OXID. Bei Varianten die Varianten-OXID.

BigCommerce

Die Product Variant ID. Wenn es keine gibt, der Produktname.

Klar API

Die productVariantId, die du in deinem API-Payload sendest. Erforderlich: ohne sie können Pixel-Events nicht deinen API-Bestellungen zugeordnet werden.


Schritt 5: Die erforderlichen Events hinzufügen

Erstelle einen Custom-HTML-Tag pro Event. Nutze einen Custom-Event-Trigger mit dem passenden Data-Layer-Event-Namen.

Die Feuer-Reihenfolge zählt. Jeder Event-Tag muss nach dem Base Script feuern. Setze unter Advanced Settings → Tag Sequencing, dass Klar – Base Script vor dem Event-Tag feuert.

Product Viewed

Trigger: view_item

<script>
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendProductViewedEvent", {
productId: "{{DLV – Item ID}}"
}]);
</script>

Add to Cart

Trigger: add_to_cart

<script>
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendAddToCartEvent", {
cartId: "{{DLV – Cart ID}}",
productId: "{{DLV – Item ID}}"
}]);
</script>

Update Checkout

Trigger: begin_checkout

<script>
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendUpdateCheckoutEvent", {
checkoutId: "{{DLV – Checkout ID}}",
cartId: "{{DLV – Cart ID}}",
customerId: "{{DLV – Customer ID}}"
}]);
</script>

Order

Trigger: purchase (Bestellbestätigungsseite)

<script>
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendOrderEvent", {
orderId: "{{DLV – Order ID}}",
cartId: "{{DLV – Cart ID}}",
customerId: "{{DLV – Customer ID}}"
}]);
</script>

Gast-Checkouts: lass customerId leer. cartId oder checkoutId fehlt? Nutze deine Session-ID für beide.

Die orderId muss mit der Order ID übereinstimmen, die Klar von deinem Shop-System erhält. Sonst kann die Bestellung nicht ihrer Customer Journey zugeordnet werden.


Schritt 6: Die empfohlenen Events hinzufügen

Gleiches Setup wie Schritt 5: ein Custom-HTML-Tag pro Event, gefeuert nach dem Base Script.

Remove from Cart

Trigger: remove_from_cart

<script>
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendRemoveFromCartEvent", {
cartId: "{{DLV – Cart ID}}",
productId: "{{DLV – Item ID}}"
}]);
</script>

Shipping Info

Trigger: add_shipping_info

<script>
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendShippingInfoEvent", {
checkoutId: "{{DLV – Checkout ID}}"
}]);
</script>

Payment Info

Trigger: add_payment_info

<script>
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendPaymentInfoEvent", {
checkoutId: "{{DLV – Checkout ID}}"
}]);
</script>

Schritt 7: Optionale Events hinzufügen


Schritt 8: Testen, bevor du veröffentlichst

  1. Klicke in GTM auf Preview und öffne deinen Shop.

  2. Geh eine komplette Journey durch: Produktseite → in den Warenkorb → Artikel entfernen → Checkout → Versand → Zahlung → Testbestellung.

  3. Prüfe im Tag Assistant, dass Klar – Base Script auf jeder Seite feuert und jeder Event-Tag bei seinem Trigger feuert.

  4. Öffne die Developer-Tools deines Browsers. Fehlgeschlagene Events zeigen einen beschreibenden Fehler in der Console.

  5. Wenn alles feuert, klicke auf Submit und veröffentliche den Container.


Schritt 9: Das Datenschutz-Snippet hinzufügen

Füge das Datenschutz-Snippet von Klar zu deiner Datenschutzerklärung hinzu. Du findest es in den Einstellungen der Klar Pixel Datasource, unterhalb des Tracking-Scripts, unter Data Protection Snippet (Deutsch und Englisch).


Schritt 10: 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 deinen Ad-URLs hinzu. Anleitungen pro Channel:


Was passiert als Nächstes?

Klar beginnt sofort zu tracken. Attributionsdaten erscheinen ab dem nächsten Tag in deinen Reports – nur ab dem Moment, in dem der Pixel live ging, nicht rückwirkend. Wie deine Pixel-Coverage über die nächsten 30 Tage aufgebaut wird, kannst du im Action Centre → Overview verfolgen.

🎉 Das war's, dein Klar Pixel ist live.


Verwandte Artikel

Hat dies deine Frage beantwortet?