Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Pour intégrer SPREAD sur votre Shopify, vous devez insérer des scripts JavaScript à différents endroits. 

Vous pourrez ainsi bénéficier : 

  • Des widgets sur votre site
  • Des remontées de création de comptes et de commandes
Note

Il n'y a pas de remontées de mises à jour de profil ni de commande car Shopify ne permet pas d'insérer du code à ce niveau. Pour le faire, il faudra passer par l'api v2 (uniquement des données profils, les commandes ne peuvent pas être remontées via api v2) et/ou de l'import (si vous pouvez récupérer automatiquement vos données, il est possible d'automatiser l'import par développement spécifique)


Warning
titleAvertissement

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.



Affichage des widgets

Dans votre Shopify, RDV dans Online Store > Themes > Customize Theme > Edit Code > footer.liquid (section)

Insérez ce script juste avant la balise </body> (c'est à dire à la fin de la page).

Code Block
languagejs
themeEmacs
titleScript d'affichage des widgets
<script> // Configuration du tracker SPREAD var spconfig = { public_key: "xxxx", // Remplacez xxxx par votre clé d'API publique (RDV dans votre back office, onglets "Paramétrage > Tracker") debug: false, set_cookie: true, track_order_enabled: true }; // Procédure de chargement du tracker JS SPREAD 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>


Voir les exemples de code, rubrique Tracker


Remontée de création de compte

Dans votre Shopify, rendez vous dans Online Store > Themes > Customize Theme > Edit Code > Customers/account.liquid (templates)

Insérez ce code avant la fonction loadSpreadTracker du script d'affichage des widgets (à la fin de la page, mais avant l'appel de votre page footer).


Voir les exemples de code, rubrique Remontées des créations de compte / commande


Documentation pour les variables Shopify : https://help.shopify.com/themes/liquid/objects/customer

compte
HTML Comment
hiddentrue


Code Block
languagejs
themeEmacs
titleRemontée de création de
commandes
<script>
var sporder
    var sporder = {
email:
        email: "{{customer.email}}",
name:
        name: "{{customer.last_name}}",
 // Si vous n'indiquez pas ce paramètre, nous y insérerons le début de l'email.
firstname:
        firstname: "{{customer.first_name}}",
action :
        action : "signup"
    };
</script>
Documentation pour les variables Shopify : https://help.shopify.com/themes/liquid/objects/customer



Remontée de création de commandes

Dans votre Shopify, rendez-vous dans Settings > Checkout > Additional scripts

Insérez ce code avant la fonction loadSpreadTracker du script d'affichage des widgets.


Voir les exemples de code, rubrique Remontées des créations de compte / commande


Doc variable : https://help.shopify.com/themes/liquid/objects/order

Doc adaptation date : https://help.shopify.com/themes/liquid/filters/additional-filters#date

+ changement format : http://ruby-doc.org/core-2.5.1/Time.html#method-i-strftime

Doc Adresse : https://help.shopify.com/themes/liquid/objects/address

HTML Comment
hiddentrue


Code Block
languagejs
themeEmacs
titleRemontée de création de commandes
<script>
    var sporder = {
        email: "{{customer.email}}",
        amount: "{{ order.total_price  | money_without_currency | replace: ',', '.'}}",
        idorder: "{{order.order_number}}",
        date: "{{order.created_at| date: '%Y-%m-%d %H:%M:%S'}}", // Y-m-d H:i:s
        state: "20", // 10:taken / 20:paid / 50:sent / 100:recieved
        name: "{{customer.last_name}}", // Si vous n'indiquez pas ce paramètre, nous y insérerons le début de l'email.
        firstname: "{{customer.first_name}}",
        address : "{{order.shipping_address.street}}",
        cp : "{{order.shipping_address.zip}}",
        city : "{{order.shipping_address.city}}",
        country : "{{order.shipping_address.country}}",
        action : "order"
	};

</script>

Doc variable : https://help.shopify.com/themes/liquid/objects/order

Doc adaptation date : https://help.shopify.com/themes/liquid/filters/additional-filters#date

+ changement format : http://ruby-doc.org/core-2.5.1/Time.html#method-i-strftime

Doc Adresse : https://help.shopify.com/themes/liquid/objects/address

Tip
titleAstuce de l'équipe

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.

  • Par exemple, vous pouvez contacter des profils importés tant qu'ils ont des consentements valides. Voir la documentation sur le RGPD
  • Dans un premier temps, vous pouvez aussi partager des opérations sur vos réseaux sociaux ou à travers des newsletters. L'intégration vous permettra ensuite d'afficher des widgets sur votre site. Voir les conseils pour partager une opération





    Note
    titleRemarque

    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