Connecter Squarespace et rattacher ses commandes aux visites

01Connecter en un clic

1. 1

   Sur la page Integrations de votre site, ouvrez Squarespace et cliquez sur Connect with Squarespace.

2. 2

   Tally indique ce qui lui sera accordé : vos commandes et leurs transactions, en lecture seule, et un abonnement webhook. Il ne modifie jamais une commande. Cliquez sur Continue to Squarespace.

3. 3

   Squarespace vous demande de vous connecter, en tant que propriétaire du site ou administrateur, et de choisir le site. Sa page de confirmation demande d’autoriser Tally à lire vos commandes et transactions hors ligne, pour qu’il continue de les lire en votre absence. Cliquez sur Allow.

4. 4

   Vous revenez sur Integrations : Squarespace is connected, et un an de commandes est en cours d’import, remboursements compris.

Dès lors, chaque nouvelle commande arrive en quelques secondes via l’abonnement webhook. Toutes les 30 minutes, Tally lit aussi les commandes modifiées, si bien qu’une commande manquée par une notification arrive quand même.

02Ou connecter avec une clé API

1. 1

   Créer une clé API dans Squarespace

   Une clé API fonctionne avec les offres Core, Plus, Advanced et Commerce Advanced. Dans Squarespace, ouvrez Settings › Developer Tools › Developer API Keys, choisissez Generate Key, et donnez-lui uniquement ces autorisations (le guide de Squarespace) :

   Autorisation	Accès	Pourquoi
   Orders	Read	Chaque commande payée : son total et ses taxes, et l’e-mail du client (haché immédiatement, jamais stocké). Les noms et adresses ne sont jamais stockés.
   Transactions	Read	Quand chaque remboursement a eu lieu, et combien il a rendu.

   Read Only pour les deux. Squarespace ne fournit des webhooks qu’aux applications connectées en un clic : avec une clé, Tally lit donc les nouvelles commandes toutes les 10 minutes. Supprimez la clé au même endroit à tout moment.

2. 2

   Coller la clé API

   Sur la page Integrations de votre site (ou à l’étape Payments quand vous ajoutez un site), ouvrez Squarespace et renseignez :

   • API key : affichée une seule fois, à la création de la clé. Tally la stocke chiffrée et ne l’affiche plus jamais.

   Cliquez ensuite sur Connect Squarespace.

3. 3

   Tally vérifie l’accès et importe l’année écoulée

   Il vérifie la clé auprès de votre site et importe les 365 derniers jours, remboursements compris, puis lit les commandes nouvelles et modifiées toutes les 10 minutes. Pour rattacher chaque commande à la visite de son acheteur, ajoutez le snippet de Tally dans Pages › Custom Code › Code Injection : la balise dans Header, et les lignes de statut de commande données par Coverage and fixes dans les champs Order Status Page et Order Confirmation Page.

03Ajouter le code dans Code Injection

Squarespace n’exécute le code d’aucune application sur une boutique : le code s’ajoute donc à la main. Dans Squarespace, ouvrez Pages › Custom Code › Code Injection (anciennement sous Developer Tools). Squarespace propose Code Injection sur les offres Core, Plus et Advanced et sur certaines anciennes offres, pas sur Basic ni Personal.

Header

Le snippet, pour que chaque page de la boutique compte ses visites :

<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>

Order Status Page et Order Confirmation Page

Ces lignes, dans les deux champs. Squarespace affiche la page de statut de commande après le paiement pour les produits physiques, les produits téléchargeables et les services, et la page de confirmation de commande pour les cartes cadeaux, les abonnements et les adhésions. Il remplit {orderId} avec le numéro de commande, et les lignes l’envoient :

{.if firstPageView}
<script>
  window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };
  String('{orderId}').split(/[^0-9]+/).filter(Boolean).forEach(function (order) {
    tally('squarespace_order', { order: order });
  });
</script>
{.end}

La visite de l’acheteur sur cette page lui rattache la commande : confiance élevée. {.if firstPageView} empêche une visite ultérieure de la page, depuis le lien de l’e-mail, d’être comptée de nouveau. Sans ces lignes, une commande est liée par son e-mail quand votre site appelle identify avec l’adresse de l’acheteur, avec une confiance moyenne (objectifs et identify).

04Ce qui compte comme une vente

• Une commande compte une fois payée, à la date où elle a été passée : son total hors taxes, frais de port inclus et remises déjà déduites, dans la devise de la commande.
• Chaque remboursement compte à la date où il a été fait, lu dans les transactions de la commande, avec la part de taxes de la commande.

05Ce qui est conservé

De chaque commande, Tally conserve les montants, les dates et l’état du paiement, ainsi que deux hachages : l’un de l’e-mail du client, l’autre du numéro de commande. Le numéro venu de la page de statut de commande est haché dès son arrivée : seul le hachage est stocké. Les noms, adresses, numéros de téléphone, lignes de commande, réponses aux formulaires et notes ne sont jamais stockés.

06Déconnexion

• Dans Squarespace : déconnectez Tally dans le panneau Extensions, sous Connected extensions.
• Dans Tally : déconnectez-le sur la page Integrations. Tally supprime son abonnement webhook et oublie son accès, mais Squarespace continue de le lister sous Connected extensions jusqu’à ce que vous le déconnectiez là aussi. Une clé que vous avez créée vous-même se supprime dans Squarespace.
• Dans les deux cas, les commandes déjà importées restent, avec leurs justificatifs.

07Vérifier que ça marche

08Quand vos propres visites n’apparaissent pas

Connecté à Squarespace, le propriétaire d’un site est envoyé vers l’éditeur et ne voit jamais la boutique comme un visiteur : ces visites ne sont donc pas comptées. Testez dans une fenêtre de navigation privée, déconnecté, une fois le mot de passe du site saisi s’il en a un.