1. À intégrer sur toutes les pages
<script> // Configuration du tracker SPREAD var spconfig = { public_key: "PUBLIC_KEY", // À remplacer par la clé d'API publique debug: false, set_cookie: true }; // Méthode de chargement du tracker function loadSpreadTracker(){window.domLoadEventFired=!0;var a=document.createElement("script");a.type="text/javascript",a.async=!0,a.charset="UTF-8",a.id="spread-tracker",a.src="//static-sb.com/js/sb-tracker.js",document.body.appendChild(a)}window.addEventListener?window.addEventListener("load",loadSpreadTracker,!1):window.attachEvent?window.attachEvent("onload",loadSpreadTracker):window.onload=loadSpreadTracker; </script>
Ce code va s'occuper :
- d'afficher les widgets,
- de poser le cookie de tracking sur le navigateur de l'utilisateur de votre site.
Détails de la configuration de l'objet spconfig
public_key
: Votre clé publique est disponible dans le back-office onglet Intégration > Tracker > Clés API.
debug
:true/false
Permet d'afficher les logs dans la console.
set_cookie
:true/false
Permet d'attribuer un cookie aux clients.
2. Remontée des créations de compte
Le code suivant est à insérer sur la page de confirmation de création du compte dans le footer, en plus du tag sur toutes les pages et avant la fonction loadSpreadTracker.
var spconfig = {...}; var sporder = { email: "xxx@xxx.xxx", external_id: "xxxxxx", name: "doe", //Si vous n'indiquez pas ce paramètre nous y insérerons le début de l'email firstname: "john", optin: 1, // 1:optin / 0:not optin / -1: unknown country : "FR", birthday : "1970-12-31", // format: YYYY-MM-DD gender : "male", // "male" or "female" address : "8, rue de la place", address_2 : "bâtiment A", address_3 : "appartement 23", cp : "76000", city : "Rouen", tel : "0235000000", mobile : "060606606", fonction : "developer", company : "SPREAD", lang : "fr_FR", action : "signup", // "signup" = Création de compte; "order" = Création de commande; "newsletter" = Inscription à la NL add_tag : ["tag1", "tag2", "tag3"], // Ajout de tags sur le profil (Add tags on profile) del_tag : ["tag2", "tag4"], // Suppression de tags sur le profil (Delete tags on profile) custom_fields: { 5874: "value" // Id du custom_field. } }; function loadSpreadTracker(){...};
3. Remontée de commandes
Ce JavaScript permet de remonter automatiquement les commandes et les informations clients dans la CRM de SPREAD lorsqu'ils passent commande sur votre site.
Le code suivant est à insérer sur la page de confirmation de commande dans le footer, en plus du tag sur toutes les pages et avant la fonction loadSpreadTracker.
Pour ce faire, il suffit d'ajouter les informations sur la commande dans l'objet sporder
configuré plus haut.
var spconfig = {...}; var sporder = { email: "johndoe@sb.am", state: "10", // 10: taked / 20: paid / 50: sent / 100: received amount: "158.31", idorder: "0000001", date: "2014-06-21 14:31:08", // Date de la commande au format YYYY-MM-DD hh:mm:ss (UTC) start_service: "2019-06-15", // Date de début de la prestation au format YYYY-MM-DD (UTC) end_service: "2019-06-26", // Date de fin de la prestation au format YYYY-MM-DD (UTC) add_order_tag : ["tag_commande_1", "tag_commande_2"], // Ajout de tags sur la commande del_order_tag : ["tag_commande_3", "tag_commande_4"], // Suppression de tags sur la commande product_attributes: [ ["size:xl", "type:shirt"], // Attributs du produit 1 ["size:s", "color:blue"], // Attributs du produit 2 ], // product_attributes: [] // Laisser vide pour supprimer tous les attributs // product_attributes: null // null ne déclenche aucune modification action: "order", }; function loadSpreadTracker(){...};
Correspondance Statuts de commande
0
: commandes annulées Ces commandes n’entrent pas en compte dans le chiffre d'affaires.
10
: statut des commandes dont le paiement n’a pas encore été validé Ces commandes n'entrent pas en compte dans le chiffre d'affaires à moins que vous ne le configuriez dans le BackOffice SPREAD, "Paramétrage > Tracker > 3. Configurez le statut de commande"
20
: statut des commandes payées
50
: statut des commandes expédiées
100
: statut des commandes terminées, avec paiement effectué et commande livrée au client
Gestion de l'idorder
La valeur idorder
est l’identifiant unique de la commande sur la boutique.
La première fois que cet identifiant est utilisé, la commande est enregistrée dans la CRM. Si l’identifiant de commande est présenté une deuxième fois, les données sont mises à jour.
Cet identifiant est particulièrement utile pour changer l’état de la commande (l’annuler ou la mettre à expédier).
4. Réactivation cookie
SPREAD utilise des cookies pour permettre une personnalisation optimale des affichages auprès des internautes.
Nous posons un cookie sur le profil dès son entrée dans la CRM SPREAD. Les cookies peuvent être enlevés de différentes façons par l'utilisateur lui-même et ainsi nous empêcher de le reconnaitre.
Cette fonctionnalité permet de remettre le bon cookie sur le profil lorsqu'il se connecte à son compte sur votre site.
C’est ce qui permet notamment de faire fonctionner l’affichage des widgets selon l’appartenance à un segment.
Pour réactiver un cookie il faut ajouter l’email en paramètre dans l’objet spconfig :
var spconfig = { public_key: "PUBLIC_KEY", // À remplacer par la clé d'API publique debug: false, set_cookie: true, email: "xxxxx" // À remplacer par le mail du profil connecté à votre site, };
Opt-in & Consentement
Le code suivant est à insérer au niveau de votre encart d'inscription à la Newsletter, en plus du tag sur toutes les pages et avant la fonction loadSpreadTracker.
var spconfig = {...}; var sporder = { email: "xxx@xxx.xxx", name: "doe", //Si vous n'indiquez pas ce paramètre nous y insérerons le début de l'email firstname: "john", optin: 1, // 1:optin / 0:not optin / -1: unknown }; function loadSpreadTracker(){...};
Ils utilisent respectivement les paramètres suivants:
optin
mobile_optin
Cookie et RGPD
Si vous souhaitez déclencher le tracker uniquement après avoir validé le consentement de votre utilisateur vous pouvez suivre les explications suivantes.
var spconfig = {...}; // Désactivation de l'auto-exécution du tracker SPREAD window.spAutoload = false; function loadSpreadTracker(){...}; // Chargement des widgets dès que possible // Notez que ce code va également faire la remontée de création de compte / commande si la variable sporder est disponible window.addEventListener("SPREAD_ready", function() { SPREAD.launch({widgets : true}); });
Détails de la méthode Spread.launch
// Initialise les widgets et pose cookie `spw` // Puisque c'est le premier appel, cela va également faire la remontée de commande si `sporder` est définie. SPREAD.launch({widgets : true}); // Initialise et pose le cookie `sbt` // Cela ne va avoir aucun impact sur les widgets et le cookie `spw` SPREAD.launch({tracker : true}); // Ne va avoir aucun effet SPREAD.launch(); // Supprime tous les widgets et le cookie `spw` // Cela ne va avoir aucun impact sur le cookie `sbt` SPREAD.launch({widgets : false}); // Charge les widgets + cookie `spw` et supprime le cookie `sbt` SPREAD.launch({widgets : true, tracker : false});