Référence d'API JavaScript de collecte de données – Emarsys

Fonctionnement avec les autres produits Emarsys

L'API JavaScript Emarsys peut être utilisé pour la collecte des données comme pour l'obtention de recommandations de produit Predict. Les fonctionnalités d'API liées à d'autres produits Emarsys (telles que Predict) sont marquées comme telles dans la Référence de commande.

Pré-requis

Pour 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 les HTML de votre site web est disponible dans votre compte de la Plateforme Marketing Emarsys. Pour l'afficher, allez à Gestion > Sources de données Predict 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 ID marchand, donc il ne vous reste plus 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, juste avant l'élément </head>.Comme le fichier scarab-v2.js est chargé de manière asynchrone, il ne bloque 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 Détails du compte dans le coin inférieur droit, et cliquez sur Code de traçage à côté de votre ID marchand.

La politique de cookies de Chrome à partir de la version 80 (2020.02.04.) exige que les cookies contiennent l'en-tête SameSite. De plus, le contexte du cookie doit être spécifié par un attribut. Emarsys est en conformité avec les nouvelles exigences en matière de politique de confidentialité et 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-là, il est de la responsabilité des clients de se mettre en conformité avec les exigences de Chrome en mettant à jour leur propre script .js.

Ceci assure que les capacités de Web Extend et Predict ne soient pas modifiées eu égard aux enjeux de confidentialité utilisateur.

Utiliser le fichier scarab-v2.js hébergé par Emarsys permet une compatibilité rétrospective avec les versions de Chrome plus anciennes et d'autres navigateurs.

Pour plus d'informations sur les en-têtes de cookie et les attributs exigés, voir :

Vous devez obtenir le consentement explicite avant de commencer à recueillir des données avec Web Extend dans cette session de navigation donnée.

Avant d'utiliser Web Extend il est de votre responsabilité de vous assurer de toujours obtenir le consentement nécessaire pour ces données auprès de vos consommateurs (c'est-à-dire une personne naturelle telle qu'un client, un contact ou un compte). Pour en savoir plus sur la collecte de données Web Extend, voir le Hub du développeur Emarsys.