Comment pouvons nous vous aider ? 👋

Intégration Javascript

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.
  • 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});
 
 
🆘
Si vous avez d’autres questions sur ce sujet, vous pouvez contacter le support. 💬
Cela a-t-il répondu à votre question ?
😞
😐
🤩