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


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>


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

Code Block
languagejs
themeEmacs
titleRemontée de création de compte
<script>
    var sporder = {
        email: "{{customer.email}}",
        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}}",
        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.

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.


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