L'API JavaScript Emarsys (aussi appelé parfois Web Extend) est un système de collecte de données qui capture l'activité et le comportement des visiteurs du site Web. Cette information est utilisée pour enrichir votre base de données de contact Emarsys avec les champs de comportement Web, et pour générer des recommandations de produit personnalisées pour les solutions Predict.
Prêt à sauter le pas ? Trouvez la référence de notre API Javascript sur le Hub du développeur Emarsys.
Quelle articulation avec les autres produits Emarsys ?
L'API JavaScript Emarsys peut être utilisé à la fois pour la collecte de données et l'obtention de recommandations de produit Predict. Les fonctionnalités d'API liées aux autres produits Emarsys (tels que Predict) sont désignées comme telles dans la Référence de commande.
Pré-requis
Afin d'utiliser l'API JavaScript, vous devez charger la source JavaScript scarab-v2.js sur votre page. Le fragment de code que vous devez insérer dans le HTML de votre site Web est disponible dans votre compte sur la Plateforme Marketing Emarsys. Pour l'afficher, allez à Admin > Sources de données et cliquez sur Afficher le code de traçage dans la case Comportement Web. Le code que vous verrez dans la fenêtre modale contient déjà votre Identifiant Marchand, donc il ne vous reste qu'à le coller dans le HTML de vos sites Web.
Assurez-vous d'ajouter notre code de traçage à toutes les pages de votre site Web, immédiatement avant l'élément </head> element. Comme le fichier scarab-v2.js est chargé de manière asynchrone, il ne bloc pas le rendu de la page ou l'exécution d'un autre code JavaScript.
Si vous avez déjà implémenté le code de traçage dans votre site Web, vous pouvez encore l'afficher à tout moment sur la page Sources de données. Pour ce faire, trouvez la case Informations du compte dans le coin inférieur droit, et cliquez sur Code de traçage à côté de votre Identifiant marchand.
La politique de cookies de Chrome à partir de sa version 80 (2020.02.04.) exige que les cookies contiennent l'en-tête SameSite. De plus, le contexte du cookie doit être précisé par une caractéristique. Emarsys se conforme aux nouvelles exigences en matière de politique de confidentialité. Par conséquent, après la mise à jour du navigateur les clients n'ont pas besoin de changer leurs paramètres de cookies à moins qu'ils n'hébergent leur propre version du fichier scarab-v2.js dans le code de traçage.
Dans ce cas, c'est la responsabilité des clients de se mettre en conformité avec les exigences de Chrome en mettant à jour leur propre script .js.
Cela assure que les capacités de Web Extend et Predict demeurent inchangées concernant les informations privées de l'utilisateur.
Utiliser le fichier scarab-v2.js hébergé par Emarsys procure une compatibilité rétroactive avec les versions de Chrome plus anciennes et d'autres navigateurs.
Pour plus d'informations sur les en-têtes et caractéristiques de cookies nécessaires, voir :
Référence de commande
Vous trouverez toutes les informations sur l'implémentation de l'API Javascript sur votre site sur le Hub du développeur Emarsys.
Web Extend supporte les commandes suivantes :