Möchtest du den Attributions-Report in Klar nutzen? Gute Wahl 🎉
Damit unsere voll integrierte Attributionslösung funktioniert, musst du in Klar die Klar-Pixel-Datenquelle konfigurieren und ein Tracking-Skript auf deiner Seite einbauen. Das dauert nur ein paar Minuten.
Wenn du den Klar-Pixel über WooCommerce (nicht GTM) einbauen möchtest, schau dir bitte diesen Artikel an
1. Die Klar-Pixel-Datenquelle hinzufügen
Wenn du mehrere WooCommerce-Instanzen mit separaten Domains mit Klar verbunden hast, solltest du für jeden dieser Stores eine eigene Pixel-Datenquelle erstellen.
Gehe in Klar zu deinem Store-Konfigurator -> Datenquellen und klicke auf Neue Datenquelle hinzufügen
Wähle die Datenquelle Klar Pixel
Gib der Datenquelle einen Namen – z. B. Klar Tracking Script
Entscheide, ob du das Tracking-Skript über ein domain-validiertes Tracking-Skript (First-Party-Skript) oder ein Basis-Tracking-Skript (Third-Party-Skript) einbauen möchtest, und klicke auf Konfigurieren.
Wir empfehlen dringend, unser domain-validiertes Tracking-Skript zu nutzen. Du musst bei deinem DNS-Anbieter eine Subdomain für die Domain deines Shops einrichten, und wir liefern das Klar-Attribution-JavaScript-Snippet über diese Subdomain aus. Das führt zu mehr getrackten Conversions, weil manche Browser Third-Party-
JavaScripts standardmäßig blockieren.
Wenn du Basis-Tracking gewählt hast, siehst du jetzt das Tracking-Skript, das du auf deiner Seite einbauen musst. Springe dafür weiter zum nächsten Abschnitt.
Wenn du den domain-validierten Pixel gewählt hast, gib bitte den Domainnamen der Seite ein, auf der du den Pixel einbauen möchtest. Lass dabei https:// und www. weg.
Du siehst jetzt zwei Felder mit DNS-Einträgen, die du in deinen DNS-Einstellungen bei deinem Hosting-Anbieter hinzufügen musst.
Kopiere den Inhalt der Felder einfach über das Kopier-Symbol daneben und füge ihn in den DNS-Einstellungen ein.
Wenn du nicht weißt, wie das geht, wende dich über den Chat unten rechts an den Klar-Support. Wir helfen dir gerne.
2. Domain gehostet bei GoDaddy/WebGo/All-Inkl/Strato
Wie oben beschrieben, stellt Klar dir Werte bereit, die du per Copy & Paste in deine DNS-Einstellungen übernehmen kannst.
Das Feld „name" der beiden Einträge sieht normalerweise etwa so aus:
123456789.your-shop.com
Die Domain-Validierung funktioniert allerdings nur, wenn du im Feld „name" deine Domain weglässt. Achte also darauf, das Feld „name" so anzupassen:
CNAME:
FALSCH: 123456789.your-shop.com
RICHTIG: 123456789
CNAME IPV4:
FALSCH: 123456789-4.your-shop.com
RICHTIG: 123456789-4
Nachdem die Einträge hinzugefügt wurden, klicke bitte auf den Button „Verify Integration". In der Regel dauert es einige Stunden, in Extremfällen bis zu 2 Tage, bis die Einträge validiert sind. Sobald sie verifiziert sind, erscheint neben dem Eintrag ein grünes Häkchen.
Sobald alle Einträge validiert sind, erscheint ein Feld namens Tracking Script mit deinem Tracking-Skript, das du auf deiner Seite einbauen musst.
3. Das Klar-Skript in deinem Tag-Management-System einbauen
Füge das Skript aus dem Klar Pixel in deinem Tag-Management-System als Tag hinzu, der auf allen Seiten ausgelöst wird.
Zusätzlich zum JavaScript-Snippet, das dir in der Klar-App beim Anlegen der Datenquelle bereitgestellt wird, musst du außerdem die folgenden drei Custom Events implementieren:
Zu implementierende Events
Klar:sendUpdateCartEvent
Klar:sendUpdateCheckoutEvent
Klar:sendOrderEvent
Alle diese Events werden ausgelöst, indem ein CustomEvent auf dem document veröffentlicht wird. Sobald das Event erfolgreich veröffentlicht wurde, wird ein Fetch-Event mit dem Payload ausgelöst.
1. Klar:sendUpdateCartEvent
Löse dieses Event aus, wenn der Kunde den Inhalt des Warenkorbs ändert, z. B. Produkte hinzufügt/entfernt.
Erforderliche Daten:
cartId
Gut zu wissen: Falls dein Shop-System keine cartId bereitstellt, kannst du für den Payload dieses Events auch die sessionId (context Id) verwenden.
2. Klar:sendUpdateCheckoutEvent
Löse dieses Event aus, wenn der Kunde den Checkout-Bereich deines Shops betritt.
Erforderliche Daten:
checkoutId
Optionale Daten:
cartId
customerId
Gut zu wissen: Falls dein Shop-System keine checkoutId und/oder cartId bereitstellt, kannst du für den Payload dieses Events auch die sessionId (context Id) verwenden. Bei Gästen lass die customerId einfach leer.
3. Klar:sendOrderEvent
Löse dieses Event auf der „Checkout Finish"-Seite aus, wenn die Bestellung vom Kunden abgeschickt wurde.
Erforderliche Daten:
orderId
Optionale Daten:
cartId
customerId
Gut zu wissen: Falls dein Shop-System keine checkoutIdund/oder cartId bereitstellt, kannst du für den Payload dieses Events auch die sessionId (context Id) verwenden. Bei Gästen lass die customerId einfach leer.
Beispiele
Klar:sendUpdateCartEvent
<script>
(function() {
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendUpdateCartEvent",
{ cartId: 12345, }]); })();
</script>
Klar:sendUpdateCheckoutEvent
<script>
(function() {
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendUpdateCheckoutEvent",
{ cartId: 12345, checkoutId: 12345, customerId: 34567 }]); })();
</script>
Klar:sendOrderEvent
<script>
(function() {
window._k_q = window._k_q || [];
window._k_q.push(["Klar:sendOrderEvent",
{ orderId: 12345, cartId: 12345, customerId: 12345 }]); })();
</script>
Troubleshooting
Wenn die Events ausgelöst werden und ein Fehler auftritt, wird in der Konsole eine aussagekräftige Meldung mit dem Grund für den fehlgeschlagenen Aufruf angezeigt. Falls dir unbekannte Fehler oder Bugs begegnen, kontaktiere bitte unseren Kundensupport.
4. Datenschutz-Snippets hinzufügen
Achte darauf, unser Datenschutz-Snippet in deine Datenschutzerklärung aufzunehmen, um deine Kunden über die Nutzung des Klar-Tracking-Pixels zu informieren. Ein deutsches und ein englisches Snippet findest du in der Klar-Pixel-Datenquelle unterhalb des Tracking-Skripts in einem eingeklappten Abschnitt namens „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 einbauen.
Hier findest du Anleitungen dazu für jeden Marketing-Kanal:
Was passiert als Nächstes?
Ab jetzt können wir Besucher auf deiner Seite und ihre Kaufaktivität tracken, um unser Attributions-Reporting zu speisen.
Ab morgen siehst du Daten in deinen Reports – allerdings erst ab dem Zeitpunkt, zu dem du das Skript hinzugefügt hast.