Suivi côté serveur pour Squarespace Commerce
ROASaurus lit les commandes payées depuis la Squarespace Commerce API toutes les 5 minutes et les envoie à vos plateformes publicitaires depuis le serveur. Un extrait sur la page de statut de commande relie chaque commande au clic publicitaire.
| Squarespace en un coup d’œil | |
|---|---|
| Les commandes arrivent par | Interrogation de la Commerce API toutes les 5 minutes |
| Accès | Clé API développeur avec Orders: read |
| Formule | Les clés API nécessitent la formule Commerce Advanced |
| Commandes payées | État de paiement PAID |
| Extrait de la page de remerciement | Injection de code sur la page de statut de commande, avec {orderId} et {orderGrandTotal} |
Comment Squarespace se connecte
- Settings › Advanced › Code Injection › Header : collez la balise script ROASaurus.
- Sur la même page, sous Order Status Page (et Order Confirmation Page pour les produits numériques), collez l’extrait de la page de remerciement.
- Settings › Advanced › Developer API Keys › Generate Key, avec Orders: read, et saisissez-la dans ROASaurus.
Pourquoi une interrogation périodique et pas des webhooks
Squarespace n’envoie des webhooks qu’aux applications OAuth, pas aux intégrations qu’un marchand configure avec une clé API. ROASaurus récupère donc les commandes modifiées depuis sa dernière exécution, toutes les 5 minutes, avec un chevauchement de 30 minutes. Les commandes à l’état de paiement PAID sont envoyées ; les doublons sont ignorés.
Relier les commandes aux clics publicitaires
L’extrait utilise les propres variables de Squarespace, {orderId}, {orderGrandTotal} et {customerEmailAddress}, pour déclencher l’achat ROASaurus avec le même identifiant de commande. Il est encadré par {.if firstPageView}, de sorte qu’un acheteur qui recharge la page de statut de commande ne le déclenche pas deux fois. Sans l’extrait, ROASaurus se rabat sur un e-mail que le visiteur a donné plus tôt sur votre site, par exemple dans une popup.
Ce que ROASaurus lit dans chaque commande
Le numéro de commande, le total général et la devise, l’e-mail et l’identifiant du client, le nom, le téléphone et l’adresse de facturation, ainsi que le produit, la variante, la quantité, le prix payé et le SKU de chaque ligne.
Limites
- Les clés API nécessitent la formule Commerce Advanced.
- Les commandes arrivent jusqu’à 5 minutes après le paiement. « Fetch orders now » synchronise à la demande.
- Les commandes Squarespace n’incluent pas l’adresse IP de l’acheteur : le repli par IP n’est donc pas disponible. Ajoutez l’extrait.
- Le connecteur est construit d’après la documentation officielle de l’API de la plateforme. Cliquez sur Test connection après avoir enregistré vos identifiants, puis passez une commande de test et vérifiez l’Event log.
À lire aussi
Vos questions, nos réponses
De quelle formule Squarespace ai-je besoin ?
Les clés API développeur pour les commandes nécessitent la formule Commerce Advanced. Le script de suivi et l’extrait fonctionnent via l’injection de code.
Pourquoi Squarespace ne peut-il pas envoyer les commandes instantanément ?
Squarespace n’envoie des webhooks qu’aux applications OAuth, pas aux clés API des marchands. ROASaurus interroge donc la Commerce API toutes les 5 minutes.
Le rechargement de la page de commande comptera-t-il deux fois ?
Non. L’extrait ne s’exécute qu’à la première vue de la page de statut de commande, et ROASaurus ignore un second achat avec le même identifiant de commande.
Chaque vente, rattachée à la publicité qui l’a générée
Suivi côté serveur, bénéfice et valeur vie client dans une seule application. Essai gratuit de 14 jours, sans carte bancaire.
Démarrez votre essai gratuit →