Das Emarsys JavaScript API (auch Web Extend genannt) ist ein System zur Datensammlung, das die Aktivitäten und das Verhalten der Besucher auf Ihrer Website erfasst. Diese Informationen werden dazu verwendet, Ihre Emarsys Kontaktdatenbank mit Feldern zum Webverhalten anzureichern und personalisierte Produktempfehlungen für die Predict Lösungen zu generieren.
Bereit loszulegen? Unsere Javascipt API Referenz finden Sie im Emarsys Developer Hub.
Interaktion mit anderen Emarsys Produkten
Das Emarsys JavaScript API kann sowohl für die Datensammlung als auch für das Erstellen von Predict Produktempfehlungen verwendet werden. API-Funktionen, die mit anderen Emarsys-Produkten (wie etwa Predict) verknüpft sind, sind in der Befehlsreferenz entsprechend gekennzeichnet.
Voraussetzungen
Um das JavaScript API verwenden zu können, müssen Sie die JavaScript-Quelle scarab-v2.js
auf Ihre Seite laden. Das Code Snippet, das Sie in das HTML Ihrer Website einfügen müssen, ist in Ihrem Emarsys Marketing Plattform Account verfügbar. Um es anzuzeigen, gehen Sie zu Management > Predict Data Sources und klicken Sie Show tracking code in der Box Web Behavior. Der Code, der in dem modalen Fenster angezeigt wird, enthält bereits Ihre Merchant-ID, Sie müssen ihn also nur noch in das HTML Ihrer Website einfügen.
Achten Sie darauf, den Tracking Code auf allen Webseiten Ihrer Website einzufügen, und zwar immer unmittelbar vor dem Element </head>
. Da die Datei scarab-v2.js
asynchron geladen wird, blockiert sie weder die Darstellung der Seite noch die Ausführung eines anderen JavaScript Code.
Wenn Sie den Tracking Code bereits in Ihrer Website implementiert haben, können Sie ihn trotzdem jederzeit auf der Seite Data Sources anzeigen. Gehen Sie dafür zur Box Account Details rechts unten auf der Seite und klicken Sie Tracking code neben Ihrer Merchant-ID.
Ab Version 80 (2020.02.04.) der Chrome Cookie-Richtlinie müssen Cookies den Header SameSite
enthalten. Darüber hinaus muss der Kontext des Cookies mit einem Attribut angegeben werden. Emarsys entspricht den neuen Anforderungen der Datenschutzrichtlinie; daher müssen Emarsys Kunden nach dem Browser-Update ihre Cookie-Einstellungen nicht ändern, außer sie hosten ihre eigene Version der Datei scarab-v2.js
im Tracking Code.
In diesem Fall liegt es in der Verantwortung der Kunden, die Compliance mit den Chrome-Anforderungen sicherzustellen, indem sie ihr eigenes .js
-Script aktualisieren.
Das stellt sicher, dass die Funktionalitäten von Web Extend und Predict in Bezug auf den Benutzerdatenschutz unverändert bleiben.
Durch Verwendung der von Emarsys gehosteten Datei scarab-v2.js
ist die Rückwärtskompatibilität mit älteren Chrome-Versionen und anderen Browsern gegeben.
Weitere Informationen zu den erforderlichen Cookie-Headern und -Attributen erhalten Sie unter:
Vor Datenerfassung ausdrückliche Zustimmung der Nutzer einholen
Bevor Sie damit beginnen, mit Web Extend Daten zu erfassen, müssen Sie in der jeweiligen Web Session die ausdrückliche Einwilligung der Nutzer einholen.
Bevor Sie mit der Verwendung von Web Extend beginnen, müssen Sie sicherstellen, dass Sie vor dem Erfassen von Daten immer die dafür erforderliche Einwilligung von Ihren Konsumenten einholen (d.h. von einer natürlichen Person, etwa einem Kunden, Kontakt oder Account). Weitere Informationen zur Datenerfassung mit Web Extend erhalten Sie im Emarsys Developer Hub.
Befehlsreferenz
Alle erforderlichen Informationen zur Implementierung des Javascript API auf Ihrer Website finden Sie im Emarsys Developer Hub.
Web Extend unterstützt folgende Befehle: