Zum Hauptinhalt springen

Den Klar Pixel für Shopify einrichten (Customer Events)

Klar Pixel einrichten: Domain validieren, Tracking-Script in Shopify Customer Events einbauen und URL-Parameter ergaenzen

Verfasst von Maximilian Rast

tl;dr

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

Das Einrichten des Klar Pixel dauert ein paar Minuten und besteht aus fünf Schritten:

  1. Klar Pixel Datasource hinzufügen in Klar und Domain Validated (empfohlen) oder Basic Tracking wählen

  2. Deine Domain validieren über zwei DNS-Records bei deinem Hosting-Provider

  3. Das Tracking-Script implementieren in den Shopify Customer Events

  4. URL-Parameter hinzufügen in deinen Ad-Accounts, damit Conversions und Kosten gematcht werden können

  5. Bei Bedarf das Datenschutz-Snippet zu deiner Datenschutzerklärung hinzufügen.

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


1️⃣ Klar Pixel Datasource hinzufügen

Wenn du mehrere Shopify-Instanzen mit separaten Domains mit Klar verbunden hast, solltest du für jeden dieser Stores 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 ein (z. B. Klar Pixel DE)

  4. Wähle Shopify als dein Shop System

  5. Wähle deinen Tracking-Typ:

    1. Domain Validated Pixel (empfohlen) – du richtest bei deinem DNS-Provider eine Subdomain deiner Shop-Domain ein, und Klar liefert das Attribution-JavaScript über diese Subdomain aus. Das führt zu mehr getrackten Conversions, weil manche Browser Third-Party-JavaScripts standardmäßig blockieren

    1. Basic Tracking Script – ein Third-Party-Script, einfacher einzurichten, aber ungenauer

6. Wenn du Basic Tracking Script gewählt hast, spring weiter zu Schritt 3 – dein Script ist bereits verfügbar

7. Wenn du Domain Validated Pixel gewählt hast, gib deinen Domainnamen ein (ohne https:// und www.) und klicke auf Configure


2️⃣ Deine Domain validieren (nur Domain Validated)

Klar zeigt dir zwei DNS-Records, die du in den DNS-Einstellungen deines Hosting-Providers hinzufügen musst.

Shopify-, WebGo-, All-Inkl-, Strato-Nutzer: Wenn du die DNS-Records hinzufügst, entferne deine Domain aus dem Name-Feld. Gib nur das numerische Präfix ein.

Korrektes Format:

Record-Typ

Falsch ❌

Richtig ✅

CNAME

123456789.your-shop.com

123456789

CNAME IPv4

123456789-4.your-shop.com

123456789-4

  1. Kopiere die zwei DNS-Records und füge sie über das Copy-Icon neben jedem Feld in die DNS-Einstellungen deines Hosting-Providers ein

  2. Klicke auf Validate DNS Records

⚠️ Hinweis: Die DNS-Propagation kann von ein paar Stunden bis zu 2 Tagen dauern. Sobald verifiziert, erscheint ein grünes Häkchen-Icon neben jedem Record. Wenn du unsicher bist, wie du DNS-Records hinzufügst, melde dich über den Support-Chat – wir helfen gerne.

Sobald beide Records validiert sind, erscheint das Tracking Script in der Datasource. Kopiere es für den nächsten Schritt.


3️⃣ Das Tracking-Script in Shopify implementieren

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

  • theme.liquid

  • checkout.liquid (nur Shopify Plus)

  • Additional Scripts in deinen Checkout-Einstellungen

3.1 Standard-Shopify-Store

  1. Klicke in der Klar Pixel Datasource auf Copy Script

  2. Geh in deinem Shopify Admin zu Settings → Customer Events

  3. Klicke auf Add Custom Pixel

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

  5. Lösche den Default-Code im Code-Fenster und passe die Privacy-Einstellungen 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 feuern nur, wenn der Nutzer das Cookie-Banner akzeptiert hat – vorausgesetzt, eine Shopify-kompatible Cookie-Lösung ist vorhanden.

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 separate Domain Validated Pixel Datasource an

  2. Ersetze das Standard-Script durch dieses Multi-Domain-Script und aktualisiere die Funktion getPixelDomain() 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 Funktion getPixelDomain() anpassen – der Rest des Scripts bleibt gleich:

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

}

}

Für jede weitere TLD fügst du der Switch-Anweisung einen neuen case mit der entsprechenden Pixel-Subdomain hinzu.


4️⃣ Das Datenschutz-Snippet hinzufügen

Füge das Klar-Datenschutz-Snippet zu deiner Datenschutzerklärung hinzu, um deine Kunden über den Klar Pixel zu informieren. Du findest eine deutsche und englische Version in der Klar Pixel Datasource, unter dem Tracking-Script im eingeklappten Abschnitt 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?

Ab jetzt trackt Klar Besucher und Kaufaktivität auf deiner Seite. Daten erscheinen ab dem nächsten Tag in deinen Attribution-Reports – historische Daten von vor dem Einbau des Scripts sind nicht verfügbar.

🎉 Dein Klar Pixel ist live – du kannst jetzt die Attribution-Reports nutzen!

Hat dies deine Frage beantwortet?