Microsoft Clarity: Einrichtung und Hilfe

Folgen Sie den Schritten im Schnellstart.

Öffnen Sie das Modul über "Configure". Tracking ist zunächst deaktiviert. Ihr Clarity-Projekt muss bereits existieren.

Die Einwilligung wird vor jedem Ereignis geprüft. Änderungen an der Einwilligung werden während des Besuchs wirksam. Sie müssen nicht allein deshalb neu laden, weil nach dem Seitenrendern eine gültige Einwilligung eingegangen ist. Das Modul unterstützt Einwilligungssignale von Cookies Revolution, Cookie Banner, Cookiebot, OneTrust und TCF. Testen Sie die Kategorie- und Dienstentscheidung Ihrer eigenen Einwilligungskonfiguration. Eine fehlende oder unlesbare Entscheidung ist keine Zustimmung. Ein unterstütztes Einwilligungswerkzeug in Ihrem Shop wird auch dann berücksichtigt, wenn Sie die Einwilligungseinstellung des Moduls deaktivieren.

Clarity-Ereignisse

Jeder dieser Schalter steht standardmäßig auf Ja. Schalten Sie einen Schalter aus, wenn Sie das Ereignis nicht möchten.

Sie erhalten nur Ereignisnamen. Diese Version hängt keine Produkt-IDs, Bestellreferenzen, Summen, Suchbegriffe oder eigenen Sitzungstags an diese Ereignisse an. Warenkorb- und Wunschlistenereignisse werden nach einem erfolgreichen Hinzufügen gesendet, nicht beim Klick auf den Button.

Kontakt- und Interaktionseinstellungen

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" und "Track product engagement" stehen standardmäßig auf Nein. Aktivieren Sie nur konfigurierte, testbare Signale. Telefonklicks verwenden Kontaktsignale. Chatstarts benötigen eine unterstützte Meldung eines tatsächlichen Chatstarts. Formulare benötigen eine serverseitig bestätigte Erfolgsquittung statt eines Klicks auf die Absenden-Schaltfläche.

Verwenden Sie "Product engagement thresholds", um die JSON-Konfiguration anzupassen. Standardmäßig werden 3 Galerieinteraktionen, 1 Variantenwechsel, 1 Detailinteraktion oder 45 Sekunden Verweildauer verlangt. Die Standarddrosselung für Optionen beträgt 1500 ms. Galerie-, Varianten- und Detailschwellen erlauben 1 bis 20, die Verweildauer 5 bis 600 Sekunden und die Drosselung 250 bis 60000 ms. Behalten Sie den Ereignisnamen high_intent_product_engagement bei. Der Standardtracker erfasst ihn einmal pro Produkt/Sitzung, wenn Trackingspeicherung erlaubt ist.

"Track custom events" steht standardmäßig auf Nein. Das Feld Regeln für benutzerdefinierte Events ist zunächst leer. Aktivieren Sie den Schalter erst nach dem Hinzufügen mindestens einer gültigen Regel.

Verwenden Sie unterschiedliche Namen mit 1 bis 64 Buchstaben, Zahlen, Unterstrichen oder Bindestrichen. Bis zu 15 unterschiedliche Namen sind möglich. Integrierte Handels- und Kontaktereignisnamen sind reserviert. Eigene Regeln senden nur den konfigurierten Ereignisnamen. Tags, Datenattribute und DOM-Ereignisdetails werden nicht als Eigenschaften weitergegeben.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-images img,.images-container img"},
  {"event":"LandingPageViewed","trigger":"url","contains":["/promo","utm_campaign=sale"]},
  {"event":"CheckoutControllerViewed","trigger":"controller","controllers":["order","orderopc","checkout"]},
  {"event":"SizeGuideOpened","trigger":"event","dom_event":"mprclarity:sizeguide"}
]

Eine Klickregel benötigt selector. Eine URL-Regel benötigt contains; die Fragmente sind Alternativen. Eine Controller-Regel benötigt controllers. Wenn Sie auch modules angeben, müssen Controller- und Modulbedingungen beide passen. Eine DOM-Ereignisregel verwendet dom_event, bei fehlender Angabe standardmäßig mprclarity:custom. once ist für Klicks standardmäßig false, für URL-, Controller- und DOM-Ereignisregeln true.

Lösen Sie das konfigurierte DOM-Ereignis aus Ihrem Theme aus:

document.dispatchEvent(new CustomEvent('mprclarity:sizeguide'));

Aktualisieren Sie Selektoren bei Theme-Änderungen. Verwenden Sie konfigurierte Regeln statt des alten Helfers window.mprclarityTrack.

Öffnen Sie eine erlaubte Seite in einem Kundenbrowser. Prüfen Sie bei erteilter Analyseeinwilligung die Netzwerkanfrage an https://www.clarity.ms/tag/PROJECT_ID. Prüfen Sie Ereignisse nur mit Namen für Produktaufruf, erfolgreichen Warenkorbzugang, Suche, Registrierung und Testbestellung. Prüfen Sie Sitzungen und Aufzeichnungen in Clarity; PrestaShop speichert diese Berichte nicht.

Prüfen Sie Ablehnung und Widerruf getrennt. Das Tracking folgt den Regeln Ihres Shops zum Datenversand und der Ihrem Clarity-Projekt zugewiesenen Integration. Eine andere demselben Clarity-Projekt zugewiesene Integration, ein unabhängig geladenes Clarity-Tag, Mitarbeiterausschlüsse oder unsichere Seiten-URLs können Tracking zurückhalten. Öffentliche Seiten enthalten nur Tracking-Einstellungen. Ausstehende Registrierungsereignisse werden für jeden Besucher privat abgerufen.

Lädt das Tag nicht, prüfen Sie "Enable Microsoft Clarity", das Format der Projekt-ID und die Bereitschaftstabelle. Testen Sie außerhalb Ihres Backoffice-Browsers. Prüfen Sie Analyse- und Diensteinwilligung, lokale JavaScript-Dateien, blockierte Anfragen und doppelte Clarity-Lader.

Fehlen Warenkorb- oder Wunschlistenereignisse, prüfen Sie, ob eine erfolgreiche Aktion das erwartete Erfolgssignal erzeugt. Ein stark angepasstes Theme kann Integrationsarbeit benötigen. Verwenden Sie eigene Regeln für separate beabsichtigte Klickmessungen.

Lassen sich eigene Regeln nicht speichern, entfernen Sie reservierte Namen, ungültiges JSON oder nicht unterstützte Auslöser. Fehlt eine Kaufmarkierung nach erneutem Laden der Bestätigung, kann die einmalige Beanspruchung pro Bestellung bereits verbraucht sein. Dieses Modul hat keine Server-Conversion-API, keinen Wiederholungsworker und keine Cron-Aufgabe zum Senden von Clarity-Ereignissen.

Setzen Sie "Enable Microsoft Clarity" auf Nein und speichern Sie, um die Integration mit erhaltenen Einstellungen zu pausieren. Zum Entfernen deinstallieren Sie über "Module Manager". Die Deinstallation entfernt Menü und Modulkonfiguration. Ihr Clarity-Projekt und die Aufzeichnungen werden weiterhin in Clarity verwaltet.

Verwenden Sie die obigen Einstellungsnamen, wenn ein Referenzbild von Ihrer installierten Version abweicht.