Gestionnaires de tags (GTM, TMS...)

Sommaire


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.

Avertissement

L'intégration de SPREAD demandant du temps, pour utiliser SPREAD en attendant, nous vous recommandons d'importer votre CRM et de la mettre à jour toutes les semaines !

Voir les documentations sur l'import


Il n'est pas nécessaire d'attendre la fin de l'intégration pour communiquer auprès de vos contacts ou mettre en place des opérations marketing.


JAVASCRIPT 1 - Widgets

Ce code 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.

Javascript 1 - Affichage des widgets
 <script>
	var spconfig = {
		public_key: "PUBLIC_KEY", // À remplacer par la clé d'API publique dans votre back office, menu "Paramétrage > Tracker" en bas de page
		debug: false,
		set_cookie: true,
		track_order_enabled: true
	};

	// Script d'exécution

	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);
</script>


N'intégrez pas directement le fichier sb-tracker.js sur votre site !

Sinon, vous ne pourrez pas bénéficier des mises à jour que nous réalisons régulièrement !


Détail des variables

VariablesDescriptionType
public_key

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

chaîne

obligatoire

debug"True", permet d'afficher les logs dans la console

boolean

true ou false

set_cookie

"True", permet d'attribuer le cookie aux clients

Important pour le parrainage et les widgets sur segment par exemple

boolean

true ou false

track_order_enabled"True" permet aux remontées de commandes et de créations de compte de se faire dans le JavaScript et en GET

boolean

true ou false


JAVASCRIPT 2 - Remontée des créations de compte

Ce JavaScript permet d’intégrer automatiquement les visiteurs dans la CRM 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 le script d'exécution.


Cliquez ici pour accéder aux exemples de code et intégrez le code JAVASCRIPT entre les commentaires suivants :

Début : // JAVASCRIPT 2 - Remontée des créations de compte

Fin : // Fin JAVASCRIPT 2


Custom_fields

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 > Exemples de codes.


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. 


Détail des variables

VariablesDescriptionType

email 

Adresse email du client 

chaîne

 obligatoire 

name

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 

firstname

Prénom du client 

chaîne 

customer_cookieContient la valeur du cookie sbt s'il est présentchaîne
countryPayschaîne
birthdayAnniversaire

date

yyyy-mm-dd

genderCivilité

chaîne

male ou female

addressAdresse (Numéro et rue)chaîne
cpCode postalchaîne
cityVillechaîne
telNuméro de téléphonechaîne
mobileNuméro de téléphone mobilechaîne
tel_optinLe numéro de téléphone est il disposé à recevoir des appels de votre part

boolean

1 ou 0

mobile_optinLe numéro de téléphone mobile est il disposé à recevoir des sms de votre part

boolean

1 ou 0

fonctionPoste dans l'entreprisechaîne
companyNom de l'entreprisechaîne
action

"signup"

Permet de détecter qu'il s'agit d'une création de compte dans le BackOffice SPREAD

chaîne

obligatoire

add_tag

Indique un ou plusieurs tag dans la fiche du client

chaîne

del_tag

Supprime un ou plusieurs tag dans la fiche du client

chaîne 

custom_fields 

Champs personnalisés

Multiple


JAVASCRIPT 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, en plus du tag sur toutes les pages et avant le script d'exécution.


Cliquez ici pour accéder aux exemples de code et intégrez le code JAVASCRIPT entre les commentaires suivants :

Début : // JAVASCRIPT 3 - Remontée de commandes

Fin : // Fin JAVASCRIPT 3


Custom_fields

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 > Exemples de codes.

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.


Détail des variables

VariablesDescriptionType

email 

Adresse email du client 

chaîne

 obligatoire 

amountMontant de la commande

numérique

obligatoire - Point en séparateur de décimale

idorderRéférence de la commande

chaîne

obligatoire

dateDate de la commande

date

obligatoire (yyyy-mm-dd hh:mm:ss UTC)

stateStatut de la commande

0 : annulée

10 : enregistrée

20 : payée

50 : envoyée

100 : reçue

obligatoire

name

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 

firstname

Prénom du client 

chaîne 

customer_cookieContient la valeur du cookie sbt s'il est présentchaîne
countryPayschaîne
birthdayAnniversaire

date

yyyy-mm-dd

genderCivilité

chaîne

male ou female

addressAdresse (Numéro et rue)chaîne
cpCode postalchaîne
cityVillechaîne
telNuméro de téléphonechaîne
mobileNuméro de téléphone mobilechaîne
tel_optinLe numéro de téléphone est il disposé à recevoir des appels de votre part

boolean

1 ou 0

mobile_optinLe numéro de téléphone mobile est il disposé à recevoir des sms de votre part

boolean

1 ou 0

fonctionPoste dans l'entreprisechaîne
companyNom de l'entreprisechaîne
action

"order"

Permet de détecter qu'il s'agit d'une commande dans le BackOffice SPREAD, vous permet ainsi de les retrouver dans "Paramétrage > Tracker > Vérifier la remontée de commandes"

chaîne

obligatoire

add_tag

Indique un ou plusieurs tag dans la fiche du client

chaîne

del_tag

Supprime un ou plusieurs tag dans la fiche du client

chaîne 

custom_fields 

Champs personnalisés

Multiple


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 (variable "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

Remarque

Le montant des commandes au statut Annulé ne sera pas remonté dans le chiffre d'affaires (CA) du profil.


Spécificités des différents gestionnaires de tags

Eulerian

Pour le cas d'Eulerian, vous pouvez suivre les instructions ci-dessus mais deux étapes supplémentaires sont nécessaires : 

  • Remplacer "var spconfig" et "var sporder" par "window.spconfig" et "window.sporder"
  • Lorsque vous utilisez le gestionnaire de tag Eulerian, vous pouvez intégrer vos scripts dans une iFrame Eulerian sur votre site. SPREAD n'est pas compatible avec une iFrame. Eulerian vous propose une option permettant de ne pas intégrer vos scripts dans une iFrame.

Attention

Vous pouvez vérifier si le script est mis en iFrame.


Dans Eulerian, RDV dans le Tag Management System (TMS).

Vous y trouverez le Recettage TMS à activer, cela vous redirige sur votre site avec une popup en bas Eulerian Tech.

Dépliez cette pop-up pour obtenir la liste des tags appelés en iFrame.


Si vous avez bien réalisé la manipulation, vous ne devez pas y trouver SPREAD. 


Remarque

Une fois l'intégration de SPREAD terminée, vous devez réaliser un import de l'historique de vos commandes !

Cliquez ici pour consulter la documentation sur l'import de fichier CSV