Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Principe général

 

 

Le javascript SPREAD permet :

  •  de mettre en place les widgets sur votre site web (exemples ci-dessous)
  •  de faire remonter les créations de compte dans la CRM SPREAD
  •  de faire remonter les commandes dans la CRM SPREAD

 

La CRM Spreadbutton permet ensuite de regrouper les informations commerciales, sociales et comportementales de votre base clients / prospects pour mener des actions spécifiques (fidélisation, animation, relance etc...)

 

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.

 

Exemple de Widget

JAVASCRIPT 1 - Widgets

 

Le javasript ci-dessous 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é aux javascript de création de compte et de remontée de commandes, il permet également de faire remonter ces infos dans la CRM SPREAD.

 

Deux possibilités pour intégrer ce JavaScript :

  • Méthode 1 : Le JavaScript est ajouté uniquement lorsque votre page est chargée (plus rapide)
  • Méthode 2 : Le JavaScript est ajouté même si le contenu de votre page n'est pas fini d'être chargé (plus lent)

 

Méthode 1
 <script type="text/javascript">

    var publicKeySb = "????????????????";  /*à remplacer par votre clé d’API Publique*/ 
        function loadSpreadTracker(){ window.domLoadEventFired=true;var e=document.createElement("script");e.type="text/javascript";e.async=true;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>
Méthode 2
 <script type="text/javascript">

	var publicKeySb = "????????????????" ;  /*à remplacer par votre clé d’API Publique*/ 

	var iproto = (("https:" == document.location.protocol) ? "https://" : "http://");

	document.write(unescape("%3Cscript src='" + iproto + "static-sb.com/js/sb-tracker.js' charset='UTF-8' type='text/javascript'%3E%3C/script%3E"));	

</script>


JAVASCRIPT 2 -  Remontée de commandes

 

Le traqueur de commande permet d’intégrer automatiquement les commandes et les clients dans la CRM de SPREAD (à chaque fois qu’un de vos clients passe une commande).

 

Le code suivant est à insérer sur la page de confirmation de commande, en plus du tag sur toutes les pages (de préférence avant).

 

 

 

<script type="text/javascript">

	var siteid = "????????????????" ; /*à remplacer par votre clé d’API Publique*/              
    var sbactionOrder = 1;			
    var orderemail = "john@doe.com" ; 		
    var orderamount = 13.30 ; 				
    var orderfirstname = "John" ; /* seulement si le nom et le prénom sont séparés*/
    var ordername = "Doe" ; 	/* «John Doe» si pas séparés */
    var idorder = "1340" ;  /* ID de la commande */
    var orderoptin = 1 ; 
    var orderstate = 20 ; /* 10, 20, 50, 100, 0 */
    var ordertest = 0 ;

    var sbOrderNum = "F2013-9743"; /* 2ème numéro de facture possible */

    /* Champs optionnels */
    var birthday = "1975-12-25"; 
    var gender = "male";  /* ou «female» */
    var address = "8, rue de la place";
    var cp = "76000";
    var city = "Rouen";
    var country = "FR";  /* pays au format ISO : FR, ES, IT, DE... */
    var tel = "0235000000";	
    var mobile = "0690870089";
    var fonction = "CEO";
    var company = "My Company";

    /*champs personnalisables */
    var sbCustomFieldText1 = "text1";
    var sbCustomFieldNum1 = 10;
    var sbCustomFieldDate1 = "2010-12-31";
    var sbCustomFieldBool1 = 1;

    /* Tags */
    var add_tag = "tag1, tag2, tag3";
    var del_tag = "tag4";

</script>

 

Informations obligatoires

 

Les seules informations obligatoires sont :

  •  le «orderemail» qui est l’adresse email du client
  •  le «siteid» qui est la clé d’API du site et peut être trouvé dans le tableau de bord SPREAD de la boutique ( Paramétrage > Clé API). Si vous avez mis le javascript sur toutes les pages, avec le  «publicKeySb» vous n’avez pas besoin de le préciser.
  •  le «sbactionOrder» qui permet de savoir qu’il s’agit d’une commande 

 

 

 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).

 

 

Gestion de l’état de la commande (orderstate)

Si vous avez indiqué l’ «idorder» vous allez pouvoir faire évoluer l’état de la commande au fur et à mesure avec la variable orderstate :

  •  10     :    enregistrée
  •  20     :    payée
  •  50     :    expédiée
  •  100   :    reçue
  •  0       :    annulée

 

sbOrderNum est optionnel et peut être utilisé pour passer un numéro de facture différent de l’ID de commande.

 

 

Gestion des champs optionnels

Il est possible de faire remonter l'anniversaire, le sexe, l’adresse, le code postal, la ville, le pays, le numéro de téléphone (portable et fixe) du client. Egalement sa fonction et son entreprise pour le BtoB (voir le détail des variables pour le format).  

 

 

Gestion des champs personnalisables

Avec les variables sbCustomFieldText1sbCustomFieldNum1sbCustomFieldDate1 et sbCustomFieldBool1, il est possible d’insérer des infos spécifiques dans la CRM SPREAD. Chaque type peut être passé quatre fois (sbCustomFieldText3, sbCustomFieldText4, sbCustomFieldNum3, sbCustomFieldNum4,…).

 

 

 

Exemple :

  •  sbCustomFieldText1      :     «BtoB»  
  •  sbCustomFieldText2      :     «Vendeur»
  •  sbCustomFieldNum1     :     55  
  •  sbCustomFieldNum2     :     87 
  •  sbCustomFieldDate1     :     «1965-09-05»  
  •  sbCustomFieldDate2     :     «1986-12-23»
  •  sbCustomFieldBool1     :     0  
  •  sbCustomFieldBool2     :     1

 

 

 

 Gestion des tags

Avec les tags vous pouvez ajouter des informations concernant votre client ou ses commandes. Ils sont exclusivement liés à un client.

La variable add_tag permet d’ajouter des tags (séparés par une virgule).

La variable del_tag permet de supprimer des tags (séparés par une virgule).

 

 

Exemple :

  •  add_tag      :     « tag1,tag2,tag3 » 
  •  del_tag      :     « tag4 »Javascript 3 - création de compte

 

Ce javascript permet d’intégrer automatiquement les visiteurs qui créent un compte sur votre site directement dans la CRM de SPREAD.

Le code suivant est à insérer sur la page de confirmation de création du compte, en plus du tag sur toutes les pages.

Javascript 3 - création de compte

 

Ce javascript permet d’intégrer automatiquement les visiteurs qui créent un compte sur votre site directement dans la CRM de SPREAD.

Le code suivant est à insérer sur la page de confirmation de création du compte, en plus du tag sur toutes les pages.

 

<script type="text/javascript">
var siteid = "????????????????" ; /*à remplacer par votre clé d’API*/
var sbactionSignup = 1; 
var orderemail = "john@doe.com" ; 
var orderfirstname = "John" ; /* seulement si le nom et le prénom sont séparés*/
var ordername = "Doe" ; /* «John Doe» si pas séparés */ 
var orderoptin = 1 ; 
var ordertest = 0 ; 


/* Champs optionnels */
var birthday = "1975-12-25"; 
var gender = "male"; /* ou «female» */
var address = "8, rue de la place";
var cp = "76000";
var city = "Rouen";
var country = "FR"; /* pays au format ISO : FR, ES, IT, DE... */
var tel = "0235000000";
var mobile = "0690870089";
var fonction = "CEO";
var company = "My Company";

/*champs personnalisables */
var sbCustomFieldText1 = "text1";
var sbCustomFieldNum1 = 10;
var sbCustomFieldDate1 = "2010-12-31";
var sbCustomFieldBool1 = 1;

/* Tags */
var add_tag = "tag1, tag2, tag3";
var del_tag = "tag4";

</script>

 

 

Informations obligatoires

 

Les seules informations obligatoires sont :

  •  le «orderemail» qui est l’adresse email du client
  •  le «siteid»
  •  le «sbactionSignup» qui permet de savoir qu’il s’agit d’une création de compte

 Détail des  variables

 

VariablesDescriptionType
siteid

Clé API Publique Spread (Paramètrage > Tracker)

chaîne

 facultatif si «publicKeySb» est définie

orderemail 

Adresse email du client 

chaîne

 obligatoire 

orderamount 

Montant de la commande 

num

point en séparateur de décimal 

orderfirstname 

Prénom du client 

chaîne 

ordername 

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 

idorder 

Identifiant unique de commande 

chaîne, fortement conseillée

orderoptin 

Le client accepte de recevoir votre newsletter 

boolean 1 ou 0 



orderstate 



Etat de la commande 

integer
10 : enregistrée 

 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

sbCustomFieldText1 

Possibilité de passer une chaîne de caractère 

chaîne
sbCustomFieldNum1 

Possibilité de passer une valeur 

integer
sbCustomFieldDate1 

Possibilité de passer une date 

date

("YYYY-MM-DD")

sbCustomFieldBool1 

Possibilité de passer un booléen 

boolean

1 ou 0

sbOrderNum 

Pour passer un numéro de commande (public contrairement à l’idorder) 

varchar
VariablesDescriptionType
birthdayDate d'anniversaire

date

("YYYY-MM-DD")

genderSexe : female ou malechaîne
addressAdressechaîne
cpCode Postalchaîne
cityVillechaîne
countryPayschaîne
telNuméro de téléphonechaîne
mobileNuméro de portablechaîne
fonction

Fonction occupée dans l'entreprise

(BtoB)

chaîne
company

Entreprise du client

(BtoB)

chaîne
add_tag

Possibilité de passer des informations liées au client

(Abonnement, etc...)

chaîne
del_tagPossibilité de supprimer un tag ajouté précédemmentchaîne

Intégration solutions e-commerce

 

Découvrez dans la documentation «solutions» l’intégration avec votre logiciel ecommerce. 

 

A télécharger ici : http://sb.am/public/Integration_traqueur_SB_solution.pdf 

 

Historique du document

 

2.3 - 28 mars 2014 : gestion des tags et ajout de champs optionnels : adresse, ville, code postal, téléphone, fonction, entreprise.

 

2.2 - 17 novembre 2013 : charset UTF-8 dans le javascript

 

2.1 - 23 juillet 2013 : séparation nom / prénom

 

2.0 - 6 juin 2013 : détails sur les widgets

 

1.9 - 27 mai 2013 : ajout de détails sur les variables et les javascript

 

1.8 - 27 janvier 2013 : ajout des variables anniversaire, sexe et pays

 

1.7 - 4 janvier 2013 : ajout du sbOrderNum 

 

1.6 - 27 novembre 2012 : remplacement de static.sb.am par static-sb.com dans le code de tracking

 

1.5 - 27 octobre 2012 : ajout des «custom fields» qui permettent d’insérer des infos de type text, num, date ou boolean dans la CRM

 

1.4 - 19 octobre 2012 : nouvelle version du javascript et nouveau code à insérer qui gère l’inscription à l’espace client d’un site e-commerce et des actions personnalisées

 

1.3 - 18 avril 2012 : nouvelle version du javascript à installer sur tout le site pour pouvoir activer les widgets

 

1.2.2 - 12 janvier 2012 : lien vers le document spécifique sur les solutions ecommerce

 

1.2.1 - 1 décembre 2011 : détails 42Stores

 

1.2 - 17 novembre 2011 : ajout du protocole HTTPS

Les paramètres n’ont pas changé, si votre site n’utilise pas de https sur votre page de conversion, vous n’avez pas besoin de mettre à jour.

 

1.1.1 - 14 octobre 2011 : correction des " autour de la clé d’API dans le javascript. Nouvelle version du plugin Prestashop

 

1.1 - 3 octobre 2011 : ajout des informations sur l’ensemble des plateformes et solutions ecommerce.

 

1.0 - version initiale

 

 

Unable to render {include} The included page could not be found.

  • No labels