Zum Hauptinhalt springen

Einrichtung des Klar Pixels für Shopify (Kundenereignisse)

So richtest du den Klar Pixel ein: Domain validieren, Tracking-Skript implementieren und UTM-Parameter anpassen.

Verfasst von Maximilian Rast

tl;dr

Du möchtest den Attributionsbericht in Klar nutzen? Gute Wahl 🎉

Die Einrichtung des Klar Pixel dauert ein paar Minuten und umfasst fünf Schritte:

  1. Füge die Klar-Pixel-Datenquelle hinzu in Klar und wähle „Pixel mit domainvalidierter Zertifizierung" (empfohlen) oder „Grundlegendes Tracking"

  2. Validiere deine Domain über zwei DNS-Einträge bei deinem Hosting-Anbieter

  3. Implementiere das Tracking-Skript in den Shopify Customer Events

  4. Füge URL-Parameter hinzu in deinen Werbekonten, damit Conversions und Kosten zugeordnet werden können

  5. Füge bei Bedarf das Datenschutz-Snippet zu deiner Datenschutzerklärung hinzu.

Wenn du mehrere Shopify-Stores mit getrennten Domains hast, lege für jeden eine eigene Klar-Pixel-Datenquelle an.


1️⃣ Klar-Pixel-Datenquelle hinzufügen

Wenn du mehrere Shopify-Instanzen mit getrennten Domains mit Klar verbunden hast, solltest du für jeden dieser Stores eine eigene Pixel-Datenquelle anlegen.

  1. Gehe zu Store-KonfiguratorDatenquellen und klicke auf Neue Datenquelle hinzufügen

  2. Wähle Klar Pixel

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

  4. Wähle Shopify als Shop-System

  5. Wähle deine Tracking-Methode:

    1. Pixel mit domainvalidierter Zertifizierung (empfohlen) — du richtest bei deinem DNS-Anbieter eine Subdomain deiner Shop-Domain ein, und Klar liefert das Attributions-JavaScript über diese Subdomain aus. Das führt zu mehr getrackten Conversions, weil manche Browser Drittanbieter-JavaScript standardmäßig blockieren

    1. Grundlegendes Tracking — ein Drittanbieter-Skript, einfacher einzurichten, aber weniger genau

6. Wenn du Grundlegendes Tracking gewählt hast, springe zu Schritt 3 — dein Skript ist bereits verfügbar

7. Wenn du Pixel mit domainvalidierter Zertifizierung gewählt hast, gib deinen Domainnamen ein (ohne https:// und www.) und klicke auf Konfigurieren


2️⃣ Domain validieren (nur bei domainvalidiertem Pixel)

Klar zeigt dir zwei DNS-Einträge, die du in den DNS-Einstellungen deines Hosting-Anbieters hinzufügen musst.

Shopify-, WebGo-, All-Inkl-, Strato-Nutzer: Wenn du die DNS-Einträge hinzufügst, entferne deine Domain aus dem Name-Feld. Trage nur den numerischen Präfix ein.

Korrektes Format:

Eintragstyp

Falsch ❌

Richtig ✅

CNAME

123456789.your-shop.com

123456789

CNAME IPv4

123456789-4.your-shop.com

123456789-4

  1. Kopiere die beiden DNS-Einträge über das Kopier-Symbol neben jedem Feld und füge sie in die DNS-Einstellungen deines Hosting-Anbieters ein

  2. Klicke auf DNS-Einträge validieren

⚠️ Hinweis: Die DNS-Propagierung kann von wenigen Stunden bis zu 2 Tagen dauern. Sobald verifiziert, erscheint ein grünes Häkchen neben jedem Eintrag. Wenn du unsicher bist, wie du DNS-Einträge hinzufügst, melde dich über den Support-Chat — wir helfen dir gerne.

Sobald beide Einträge validiert sind, erscheint das Tracking-Skript in der Datenquelle. Kopiere es für den nächsten Schritt.


3️⃣ Das Tracking-Skript in Shopify implementieren

Entferne zuerst jeglichen vorhandenen Klar-Pixel-Code, um Doppelzählungen zu vermeiden. Prüfe diese Stellen:

  • theme.liquid

  • checkout.liquid (nur Shopify Plus)

  • Zusätzliche Skripte in deinen Checkout-Einstellungen

3.1 Standard-Shopify-Store

  1. Klicke in der Klar-Pixel-Datenquelle auf Skript kopieren

  2. Gehe in deinem Shopify-Admin zu SettingsCustomer Events

  3. Klicke auf Add Custom Pixel

  4. Gib dem Pixel einen eindeutigen Namen (z.B. Klar!)

  5. Lösche den Standard-Code im Code-Fenster und passe die Datenschutzeinstellungen an

  6. Füge dein Klar Pixel Customer Events JavaScript in das Code-Fenster ein

  7. Klicke auf Save und dann auf Connect Pixel, um das Tracking zu aktivieren

⚠️ Hinweis: Shopify Customer Events werden nur ausgelöst, wenn der Nutzer den Cookie-Banner akzeptiert hat — vorausgesetzt, es ist eine Shopify-kompatible Cookie-Lösung im Einsatz.

3.2 Shopify Markets mit mehreren Top-Level-Domains

Wenn du Shopify Markets mit mehreren TLDs nutzt (z.B. shop.de und shop.co.uk):

  1. Lege für jede TLD eine eigene domainvalidierte Pixel-Datenquelle an

  2. Ersetze das Standard-Skript durch dieses Multi-Domain-Skript und aktualisiere die getPixelDomain()-Funktion mit deinen tatsächlichen Pixel-URLs:

function getTLD() {

const hostname = window.location.hostname;

const parts = hostname.split('.');

if (parts.length > 1) {

return parts.slice(-2).join('.');

} else {

return null;

}

}

function getPixelDomain() {

const domain = getTLD();

switch (domain) {

case "domain-a.de":

return "123456789.domain-a.de"; // Address for Domain #1

case "domain-b.de":

return "987654321.domain-b.de"; // Address for Domain #2

default:

return "987654321.domain-b.de"; // Default fallback

}

}

const script = document.createElement('script');

script.type = 'text/javascript';

script.async = true;

script.src = 'https://' + getPixelDomain() + '/javascript/script.js';

document.getElementsByTagName('script')[0].parentNode.appendChild(script);

window._k_s_c_e = true;

window._k_s_c_e_i = init;

window._k_s_c_e_b = browser;

window._k_s_c_e_s = api.settings;

analytics.subscribe('all_events', (event) => {

window._k_s_q = window._k_s_q || [];

window._k_s_q.push(['Shopify:allEvents', event]);

});

Du musst nur die getPixelDomain()-Funktion anpassen — der Rest des Skripts bleibt gleich. Füge für jede weitere TLD einen neuen case zur switch-Anweisung mit der entsprechenden Pixel-Subdomain hinzu.


4️⃣ Das Datenschutz-Snippet hinzufügen

Füge das Klar-Datenschutz-Snippet zu deiner Datenschutzerklärung hinzu, um Kunden über den Klar Pixel zu informieren. Eine deutsche und englische Version findest du in der Klar-Pixel-Datenquelle, unter dem Tracking-Skript im eingeklappten Abschnitt 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 implementieren.

Hier findest du Anleitungen für jeden Marketing-Kanal:


Was passiert als Nächstes?

Ab jetzt trackt Klar Besucher und Kaufaktivitäten auf deiner Website. Die Daten erscheinen ab dem nächsten Tag in deinen Attributionsberichten — historische Daten von vor der Skript-Einbindung sind nicht verfügbar.

🎉 Dein Klar Pixel ist live — du kannst jetzt die Attributionsberichte nutzen!

Hat dies deine Frage beantwortet?