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 Admin > 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.
Die Cookie-Richtlinie von Chrome ab Version 80 (2020.02.04.) verlangt, dass Cookies den Header SameSite enthalten. Darüber hinaus muss der Kontext des Cookies mit einem Attribut spezifiziert werden. Emarsys erfüllt die neuen Anforderungen zum Datenschutz, daher ist es nicht erforderlich, dass Kunden nach dem Browser-Update ihre Cookie-Einstellungen ändern - es sei denn, sie hosten ihre eigene Version der Datei scarab-v2.js im Tracking-Code.
In diesem Fall obliegt es der Verantwortung der Kunden, dafür zu sorgen, dass sie die Anforderungen von Chrome erfüllen; dafür müssen sie ihr eigenes .js-Skript aktualisieren.
Damit ist sichergestellt, dass das Leistungsspektrum von Web Extend und Predict im Sinne des Datenschutzes unverändert bleibt.
Die Verwendung der von Emarsys gehosteten Datei scarab-v2.js sorgt für Rückwärtskompatibilität mit älteren Chrome-Versionen und anderen Browsern.
Weitere Informationen zu den erforderlichen Cookie-Headern und Attributen erhalten Sie unter:
Befehlsreferenz
Alle erforderlichen Informationen zur Implementierung des Javascript API auf Ihrer Website finden Sie im Emarsys Developer Hub.