Hinweis: Dieser Artikel wurde automatisch übersetzt. 🤖
So richtest du das Klar Tracking Pixel ein, indem du deine Domain validierst, das Tracking-Skript implementierst und UTM-Parameter anpasst.
Möchtest du den Attributionsbericht in Klar nutzen? Tolle Wahl 🎉
Um unsere vollständig integrierte Attributionslösung zu ermöglichen, musst du die Klar Pixel Datenquelle in Klar konfigurieren und ein Tracking-Skript auf deiner Website implementieren. Das sollte nur wenige Minuten dauern.
Wenn du das Klar Pixel über WooCommerce (nicht GTM) implementieren möchtest, beachte bitte diesen Artikel
1. Hinzufügen der Klar Pixel Datenquelle
Wenn du mehrere WooCommerce-Instanzen mit separaten Domains hast, die mit Klar verbunden sind, solltest du für jeden dieser Shops eine eindeutige Pixel-Datenquelle erstellen.
Gehe zu deiner Store Configurator Seite in Klar und klicke auf Datenquelle verbinden
Wähle die Datenquelle Klar Pixel
Gib einen Namen für die Datenquelle ein – z. B. Klar Tracking Script
Konfiguriere ein Basis-Tracking-Skript und klicke auf Konfigurieren.
2. Implementierung des Klar-Skripts in deiner serverseitigen Umgebung
Alle Events müssen mit einer POST-Anfrage an "https://september.durchsichtig.xyz/server-side-event/EVENT_NAME" gesendet werden. Die IP des Kunden muss im Header "x-serverside-ip" angegeben werden.
Für die korrekte Implementierung musst du 5 verschiedene Events konfigurieren:
Zu implementierende Events
Klar:VisitEvent
Klar:ProductViewedEvent
Klar:UpdateCartEvent
Klar:UpdateCheckoutEvent
Klar:OrderEvent
Alle diese Events werden durch das Auslösen eines CustomEvent im Dokument emittiert. Wenn das Event erfolgreich ausgelöst wurde, wird ein Fetch-Event mit der Payload ausgelöst.
2.1 Klar:VisitEvent
Bitte löse dieses Event auf jeder Seite deiner Website aus.
{
"pageTitle": "Bestes Produkt der Welt",
"eventName": "VisitEvent",
"createdAt": "2024-04-11T11:11:15.783Z",
"pageUrl": "https://getklar.com/dogs",
"septemberId": "Eindeutige ID wie ein COOKIE, muss ein 16-stelliger Nanoid sein",
"googleAnalyticsId": "Wert des _ga Cookies",
"facebookId": "Wert des _fbp Cookies",
"dataSourceId": "Die DataSource ID findest du in der Pixel-Datenquelle",
"referrer": "https://google.de",
"hasGivenConsent": true,
"customerId": "Wenn verfügbar",
"screen": "1920x1200"
}
2.2 Klar:ProductViewedEvent
Bitte löse dieses Event aus, wenn der Kunde ein Produkt im Webshop ansieht.
{
"productId": "46667923652922",
"productTitle": "Beste HundetransportBOX",
"productSku": "F0011",
"createdAt": "2024-04-11T11:22:43.984Z",
"eventName": "ProductViewedEvent",
"pageUrl": "https://getklar.com/dogs/transport",
"septemberId": "Eindeutige ID wie ein COOKIE, muss ein 16-stelliger Nanoid sein",
"googleAnalyticsId": "Wert des _ga Cookies",
"facebookId": "Wert des _fbp Cookies",
"dataSourceId": "Die DataSource ID findest du in der Pixel-Datenquelle",
"referrer": "https://getklar.com/dogs",
"hasGivenConsent": true,
"customerId": "Wenn verfügbar",
"screen": "1920x1200"
}
2.3 Klar:UpdateCartEvent
Bitte löse dieses Event aus, wenn der Kunde den Inhalt des Warenkorbs ändert, z. B. Produkte hinzufügt/entfernt.
{
"cartId": "123456789",
"productId": "46667923652922",
"productSku": "F0011",
"productTitle": "Beste HundetransportBOX",
"productPrice": 8.5,
"productQuantity": 1,
"eventName": "AddToCartEvent",
"createdAt": "2024-04-11T11:27:06.262Z",
"pageUrl": "https://getklar.com/dogs/transport",
"septemberId": "Eindeutige ID wie ein COOKIE, muss ein 16-stelliger Nanoid sein",
"googleAnalyticsId": "Wert des _ga Cookies",
"facebookId": "Wert des _fbp Cookies",
"dataSourceId": "Die DataSource ID findest du in der Pixel-Datenquelle",
"referrer": "https://getklar.com/dogs",
"customerId": "Wenn verfügbar",
"hasGivenConsent": true,
"screen": "3840x2160"
}
2.4 Klar:UpdateCheckoutEvent
Bitte löse dieses Event aus, wenn der Kunde den Checkout-Bereich deines Shops betritt.
{
"checkoutId": "7297e4e6e7c95f2e8c3da4c66d60f7e7",
"createdAt": "2024-04-11T11:29:32.929Z",
"eventName": "UpdateCheckoutEvent",
"pageUrl": "https://getklar.com/checkouts/cn/Z2NwLWV1cm9wZS13ZkVKSz"
"septemberId": "Eindeutige ID wie ein COOKIE, muss ein 16-stelliger Nanoid sein",
"googleAnalyticsId": "Wert des _ga Cookies",
"facebookId": "Wert des _fbp Cookies",
"dataSourceId": "Die DataSource ID findest du in der Pixel-Datenquelle",
"referrer": "https://getklar.com/dogs/transport",
"hasGivenConsent": true,
"customerId": "Wenn verfügbar",
"screen": "3840x2160"
}
2.5 Klar:OrderEvent
Bitte löse dieses Event auf der Seite "Checkout beendet" aus, wenn die Bestellung vom Kunden aufgegeben wurde.
{
"orderId": "5916248703148",
"customerId": "Wenn verfügbar",
"checkoutId": "7282c2584c907ddcd9f17dd01f374137",
"checkoutItems": [{
"productId": "42897447452844",
"productSku": "12345",
"productTitle": "HundeBOX",
"productQuantity": 1,
"productPrice": 0
}],
"shippingTotal": 0,
"checkoutTax": 0,
"checkoutTotal": 629.95,
"eventName": "OrderEvent",
"createdAt": "2024-04-11T11:35:18.474Z",
"pageUrl": "https://getklar.com/checkouts/cn/Z2NwLWV1cm9wZS13ZkVKSz"
"septemberId": "Eindeutige ID wie ein COOKIE",
"googleAnalyticsId": "Wert des _ga Cookies",
"facebookId": "Wert des _fbp Cookies",
"dataSourceId": "Von Klar bereitgestellte DataSource ID",
"referrer": "https://getklar.com/dogs/transport",
"hasGivenConsent": true,
"screen": "3840x2160"
}
Fehlerbehebung
Wenn eine Anfrage falsch ist, gibt der Server einen Statuscode 400 zusammen mit einem "X-Klar-Failure" Header zurück. Der Wert des Headers gibt den spezifischen Fehlertyp an:
"read-headers": Fehlende oder ungültige Header in der Anfrage
"get-body": Falsches Format oder fehlender Anfrage-Body
"invalid-json": Body wurde bereitgestellt, enthält aber ein ungültiges JSON-Format
Falls du unbekannte Fehler oder Bugs entdeckst, kontaktiere bitte Pascal, unseren Kundensupport.
3. Hinzufügen von Datenschutz-Snippets
Stelle sicher, dass du unser Datenschutz-Snippet in deine Datenschutzerklärung aufnimmst, um deine Kunden über die Nutzung des Klar Tracking Pixels zu informieren. Du findest ein deutsches und ein englisches Snippet in der Klar Pixel Datenquelle unter dem Tracking-Skript in einem aufgeklappten Bereich namens „Datenschutz-Snippet“.
4. Implementierung der Klar URL-Parameter
Um sicherzustellen, dass Conversions und Kosten so genau wie möglich zugeordnet werden können, musst du die vordefinierten Klar Tracking-Codes in deinen Werbekonten implementieren.
Hier sind Anleitungen, wie du das für jeden Marketingkanal machst:
Wie geht es weiter?
Ab sofort können wir Besucher auf deiner Website und ihre Kaufaktivitäten verfolgen, um unsere Attributionsberichte zu speisen.
Ab morgen siehst du Daten in deinen Berichten, aber nur ab dem Zeitpunkt, an dem du das Skript hinzugefügt hast.