Wie der Pixel funktioniert
Converlay nutzt Shopifys Web Pixels API, um Storefront-Events zu erfassen. Der Pixel läuft in einem sandboxed iframe, der vollständig von Shopify verwaltet wird, und hat keinerlei Auswirkungen auf die Performance Ihres Shops.
Sandboxed-Ausführung
Shopify lädt benutzerdefinierte Pixel in einer isolierten Sandbox. Das bedeutet, der Pixel kann nicht auf das Haupt-DOM der Seite, Cookies zugreifen oder Ihre Storefront beeinträchtigen. Er empfängt Events über Shopifys Event-Bus.
Verfügbare Browser-APIs
| API | Verfügbar |
|---|---|
browser.localStorage | Ja |
browser.cookie | Nein |
document.cookie | Nein |
window.localStorage | Nein (verwenden Sie browser.localStorage) |
fetch / sendBeacon | Ja |
Erfasste Daten
Jeder Event-Payload enthält:
- Client ID — persistenter Bezeichner, gespeichert in
browser.localStorage - Session ID — rollendes 30-Minuten-Fenster, ebenfalls in localStorage gespeichert
- Click IDs —
gclid,fbclid,ttclidwerden aus der Seiten-URL extrahiert - UTM-Parameter —
utm_source,utm_medium,utm_campaign,utm_term,utm_content - Facebook Browser ID —
_fbpgeneriert aus der Client ID,_fbcaus fbclid - PII aus dem Checkout — E-Mail, Telefon, Name, Adresse (serverseitig mit SHA-256 gehasht vor der Weiterleitung)
- Einwilligungsstatus — zugeordnet von Shopifys Customer Privacy API zu Google Consent Mode v2-Signalen
Transport
Events werden über navigator.sendBeacon an den Converlay-Erfassungsendpunkt gesendet, um Zuverlässigkeit beim Seitenwechsel zu gewährleisten. Falls sendBeacon nicht verfügbar ist, fällt der Pixel auf einen Standard-fetch-POST-Request zurück.
Persistenz
Client ID und Session ID werden in browser.localStorage gespeichert. Falls localStorage nicht verfügbar ist (z. B. in datenschutzorientierten Browsern), fällt der Pixel auf In-Memory-Speicher zurück. In diesem Fall werden IDs bei jedem Seitenaufruf neu generiert.
Pixel-Versionierung
Jede Pixel-Bereitstellung enthält eine Versionsnummer und einen Commit-Hash. Sie können die laufende Version in Ihrem Converlay-Dashboard oder in der Browser-Konsole unter [Converlay]-Logeinträgen überprüfen.
Caching
Shopify cached Web-Pixel-Code aggressiv. Nach der Bereitstellung einer neuen Pixel-Version müssen Shops den Pixel unter Einstellungen → Kunden-Events trennen und erneut verbinden, damit Code-Änderungen wirksam werden. Einstellungsänderungen können per Bulk-Updater remote übertragen werden.