Menu
- A quoi sert le Javascript de SPREAD
- Javascript 1 - Affichage des widgets
- La Fonction loadSpreadTracker
- Javascript 2 - Remontées des créations de compte
- Informations obligatoires
- Javascript 3 - Remontées des commandes
DOCUMENTATION EN COURS DE MODIFICATION
Les scripts sont indiqués dans Paramétrage > Tracker > Indiquez "Autre" dans la liste déroulante des solutions ecommerce.
AnchorTitre_un Titre_un
Titre_un | |
Titre_un |
A quoi sert le Javascript de SPREAD?
Le javascript de SPREAD permet :
- d'afficher les widgets sur votre site web (Javascript 1),
- de faire remonter les créations de compte dans la CRM SPREAD (Javascript 2),
- de faire remonter les commandes dans la CRM SPREAD (Javascript 3).
Le javascript de SPREAD a été conçu pour ne pas ralentir le temps d’affichage de vos pages (fonctionnement asynchrone) et ainsi vous garantir un fonctionnement transparent.
AnchorTitre_deux Titre_deux
Titre_deux | |
Titre_deux |
JAVASCRIPT 1 - Widgets
Ce javascript est à insérer sur toutes les pages du site, juste avant la balise </body>.
Sa fonction principale est de permettre de piloter les widgets depuis le backoffice SPREAD. Associé à la remontée de création de compte (Javascript 2) et à la remontée des commandes (Javascript 3), il permet également de faire remonter ces infos dans la CRM SPREAD.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<script type="text/javascript"> var spconfig = { public_key: "*****************************", debug: false, set_cookie: true, track_order_enabled: true }; function loadSpreadTracker(){ window.domLoadEventFired=true;var e=document.createElement("script");e.type="text/javascript";e.async=true;e.charset="UTF-8";e.id="spread-tracker";e.src="//static-sb.com/js/sb-tracker.js";document.body.appendChild(e) } if(window.addEventListener) { window.addEventListener("load",loadSpreadTracker,false) } else if(window.attachEvent) { window.attachEvent("onload",loadSpreadTracker) } else { window.onload=loadSpreadTracker } </script> |
Dans ce script, il vous suffit de modifier les étoiles ( **** ) par votre clé API publique que vous trouverez dans votre BackOffice (onglet Paramétrage > Tracker).
Note | ||
---|---|---|
| ||
N'intégrez pas directement le fichier "sb-tracker.js" sur votre site sans quoi vous ne pourrez pas bénéficier des mises à jour que nous réalisons régulièrement |
AnchorTitre2_a Titre2_a
Titre2_a | |
Titre2_a |
La Fonction loadSpreadTracker
La fonction loadSpreadTracker est affichée ci-dessus avec le script d'affichage des widgets. Tout comme lui, elle doit être placée sur toutes les pages de votre site. Elle est essentielle au bon fonctionnement de nos scripts et doit être placée après ces derniers.
Anchor Titre_trois Titre_trois
Javascript 2 - Remontée des créations de compte
Ce javascript permet d’intégrer automatiquement les visiteurs dans la Customer Family de SPREAD lorsqu'ils créent un compte sur votre site.
Le code suivant est à insérer sur la page de confirmation de création du compte, en plus du tag sur toutes les pages et avant la fonction loadSpreadTracker.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<script> var sporder = { email: "johndoe@sb.am", name: "doe", firstname: "john", customer_cookie : "xxx", country : "xxx", birthday : "Y-m-d", gender : "xxx", // "male" or "female" address : "xxx", cp : "xxx", city : "xxx", tel : "xxx", mobile : "xxx", tel_optin : 1, // 0 or 1 mobile_optin : 1, // 0 or 1 fonction : "xxx", company : "xxx", action : "signup", add_tag : ["tag1", "tag2", "tag3"], // Indique un ou plusieurs tags sur la fiche du client del_tag : ["tag2", "tag4"], // Supprime un ou plusieurs tags sur la fiche du client custom_fields: { // Voir Custom_fields ci-dessous } }; </script> |
HTML Comment |
---|
<script type="text/javascript"> var siteid = "????????????????" ; /*à remplacer par votre clé d’API Publique*/ var sbactionSignup = 1; var spreadOrderEmail = "john@doe.com" ; var spreadOrderFirstname = "John" ; /* seulement si le nom et le prénom sont séparés*/ var spreadOrderName = "Doe" ; /* «John Doe» si pas séparés */ var spreadOrderOptin = 1 ; var ordertest = 0 ; /* Champs optionnels */ var spreadOrderBirthday = "1975-12-25"; var spreadOrderGender = "male"; /* ou «female» */ var spreadOrderAddress = "8, rue de la place"; var spreadOrderCp = "76000"; var spreadOrderCity = "Rouen"; var spreadOrderCountry = "FR"; /* pays au format ISO : FR, ES, IT, DE... */ var spreadOrderTel = "0235000000"; var spreadOrderMobile = "0690870089"; var spreadOrderFonction = "CEO"; var spreadOrderCompany = "My Company"; /* Champs personnalisables */ /* 7 et 8 correspondent aux id des champs personnalisables que vous trouvez dans votre backoffice, menu Paramétrage > Tracker */ var sbCustomFields = {custom_fields : {7 : "Professionnel", 8 : "Cosmétique"}}; /* Tags */ var add_tag = "tag1, tag2, tag3"; var del_tag = "tag4"; </script> |
Info | ||
---|---|---|
| ||
Si vous souhaitez faire remonter des champs qui vous sont propres, vous pouvez utiliser les champs personnalisés. Après avoir créé vos champs personnalisés, vous retrouverez le script pré-rempli directement dans le paramétrage du tracker (indiquez "Autre" dans la liste déroulante des solutions ecommerce pour le voir). |
AnchorTitre3_a Titre3_a
Titre3_a | |
Titre3_a |
Informations obligatoires
Pour remonter les nouveaux clients, seulement certaines données doivent impérativement être présentes dans le script. Il s'agit de :
- «email» l’email du client,
- «action : "signup" » permet de détecter qu'il s'agit d'une création de compte.
AnchorTitre_quatre Titre_quatre
Titre_quatre | |
Titre_quatre |
JAVASCRIPT 3 - Remontée de commandes
Ce javascript permet de remonter automatiquement les commandes et les informations clients dans la Customer Family de SPREAD lorsqu'ils passent commande sur votre site.
Le code suivant est à insérer sur la page de confirmation de commande, en plus du tag sur toutes les pages et avant la fonction loadSpreadTracker.
Code Block | ||||
---|---|---|---|---|
| ||||
<script> var sporder = { email: "johndoe@sb.am", amount: "13", idorder: "xxx", date: "xxx", // Y-m-d H:i:s state: "10", // 10:taked / 20:paid / 50:sent / 100:recieved name: "doe", firstname: "john", customer_cookie : "xxx", country : "xxx", birthday : "Y-m-d", gender : "xxx", // "male" or "female" address : "xxx", cp : "xxx", city : "xxx", tel : "xxx", mobile : "xxx", tel_optin : 1, // 0 or 1 mobile_optin : 1, // 0 or 1 fonction : "xxx", company : "xxx", action : "order", add_tag : ["tag1", "tag2", "tag3"], // Indique un ou plusieurs tags sur la fiche du client del_tag : ["tag2", "tag4"], //Supprime un ou plusieurs tags sur la fiche du client custom_fields: { // Voir Custom_fields ci-dessous } }; </script> |
HTML Comment | ||
---|---|---|
|
Info | ||
---|---|---|
| ||
Si vous souhaitez faire remonter des champs qui vous sont propres, vous pouvez utiliser les champs personnalisés. Après avoir créé vos champs personnalisés, vous retrouverez le script pré-rempli directement dans le paramétrage du tracker (indiquez "Autre" dans la liste déroulante des solutions ecommerce pour le voir). |
Anchor | ||||
---|---|---|---|---|
|
Informations obligatoires
Pour la remontée de commandes, seulement certaines données doivent impérativement être présentes dans le script. Il s'agit de :
- «email» l’email du client,
- «idorder» la référence commande,
- «amount» le montant,
- «state» le statut de la commande,
- «date» la date de la commande,
- «action : "order" » permet de détecter qu'il s'agit d'une commande vous pourrez alors vérifier votre remontée de commandes.
Anchor Titre4a_i Titre4a_i
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).
Anchor | ||||
---|---|---|---|---|
|
Gestion de l’état de la commande (state)
Grâce à l’«idorder» vous allez pouvoir faire évoluer l’état de la commande au fur et à mesure avec la variable state :
- 10 : enregistrée
- 20 : payée
- 50 : expédiée
- 100 : reçue
- 0 : annulée
Détail des variables
Variables | Description | Type |
---|---|---|
siteid | Clé API Publique Spread (Paramètrage > Tracker) | chaîne facultatif si «publicKeySb» est définie |
spreadOrderEmail | Adresse email du client | chaîne obligatoire |
spreadOrderAmount | Montant de la commande | num point en séparateur de décimal |
spreadOrderFirstname | Prénom du client | chaîne |
spreadOrderName | Nom du client. (Si le prénom n’est pas dissocié, ne pas mettre orderfirstname et mettre le nom ET le prénom dans ordername) | chaîne |
spreadIdOrder | Identifiant unique de commande | chaîne, fortement conseillée |
spreadOrderOptin | Le client accepte de recevoir votre newsletter | boolean 1 ou 0 |
spreadOrderState | Etat de la commande | integer 20 : payée 50 : expédiée 100 : reçue 0 : annulée |
ordertest | à 1, le script affiche les valeurs chargées au lieu d’effectuer le tracking | boolean 1 ou 0 |
sbOrderNum | Pour passer un numéro de commande (public contrairement à l’idorder) | varchar |
Variables | Description | Type |
---|---|---|
spreadOrderBirthday | Date d'anniversaire | date ("YYYY-MM-DD") |
spreadOrderGender | Sexe : female ou male | chaîne |
spreadOrderAddress | Adresse | chaîne |
spreadOrderCp | Code Postal | chaîne |
spreadOrderCity | Ville | chaîne |
spreadOrderCountry | Pays | chaîne |
spreadOrderTel | Numéro de téléphone | chaîne |
spreadOrderMobile | Numéro de portable | chaîne |
spreadOrderFonction | Fonction occupée dans l'entreprise (BtoB) | chaîne |
spreadOrderCompany | Entreprise du client (BtoB) | chaîne |
add_tag | Possibilité de passer des informations liées au client (Abonnement, etc...) | chaîne |
del_tag | Possibilité de supprimer un tag ajouté précédemment | chaîne |
Besoin de plus d'aide?
Column | |||||
---|---|---|---|---|---|
| |||||
|
Column | ||
---|---|---|
| ||
|
Column | |||||
---|---|---|---|---|---|
| |||||
|
Column | ||
---|---|---|
| ||
|
Column | |||||
---|---|---|---|---|---|
| |||||
|