Référence des données Square

Environ 7 min de lecture

Mise à jour le 27 oct. 2025, 00:00 EST

Objectif de cet article

Découvrez quelles données sont synchronisées de Square vers Klaviyo, comment les afficher et quelles propriétés contiennent les événements Square.

Avant de commencer

Si vous ne l’avez pas encore fait, lisez notre article sur Démarrer avec Square pour obtenir des instructions étape par étape sur la manière d’intégrer votre boutique avant de poursuivre cet article.

Comment accéder à vos données

Assurez-vous que votre intégration Square est activée. Pour vérifier la synchronisation des données de Square vers Klaviyo :

Dans votre compte Klaviyo, sélectionnez Intégrations dans la barre de navigation de gauche.
Sélectionnez Square dans la liste.
Sélectionnez l’onglet Données en haut.

Ici, vous verrez les données récentes synchronisées depuis Square vers Klaviyo, ainsi qu’une barre de progression pendant la synchronisation de vos données historiques.

Si vous rencontrez des problèmes avec votre synchronisation, sélectionnez Redémarrer l’importation dans la section données historiques pour redémarrer une synchronisation historique incomplète, ou Réimporter pour l’exécuter à nouveau une fois qu’elle est terminée. Vous devez disposer de l’autorisation de gérer les intégrations pour utiliser ces commandes.

Données synchronisées depuis Square

Les événements de Square Online se synchronisent avec Klaviyo en temps réel, et les événements de Square POS se synchronisent toutes les 30 minutes.

Les données synchronisées entre Square et Klaviyo sont les suivantes :

Visiteurs connus du site suivis en tant qu’événements Active on Site (si vous avez laissé le paramètre JavaScript sur site coché)
Désinscription des e-mails
Informations client associées aux événements de commande
Votre catalogue Square (y compris les articles réservés au point de vente)
Les événements suivants :
- Commande abandonnée
- Commande passée
- Produit Commandé
- Commande Remboursée
- Commande Annulée
- Commande partiellement traitée
- Commande Traitée

Les événements de commande des points de vente Square seront synchronisés avec Klaviyo (et des profils Klaviyo seront créés) s’il existe une adresse e-mail et/ou un numéro de téléphone associé à la commande que le client a directement partagé avec votre entreprise.

Les événements au niveau de la commande, tels que Commande passée et Commande remboursée, incluent une propriété Nom de la source qui identifie la source, comme Square Online ou POS, afin que vous puissiez segmenter ces événements dans Klaviyo. Cette propriété n’est pas incluse dans les événements Produit commandé ou Passage en caisse abandonné.

Détails des coordonnées client

Les profils client se synchronisent de Square vers Klaviyo s’il existe une adresse e-mail et/ou un numéro de téléphone associé au client, que celui-ci a directement partagé avec votre entreprise. Les profils synchronisés de Square vers Klaviyo peuvent inclure les propriétés suivantes, selon les données disponibles dans Square :

E-mail
Adresse e-mail du client
Prénom
Prénom du client, si le prénom et le nom de famille sont tous les deux disponibles
Nom
Nom du client, si le prénom et le nom sont disponibles
Ville
Ville du client
État/Région
État du client
Code postal
Code postal du client
Pays
Pays du client
Numéro de téléphone
Numéro de téléphone du client. Klaviyo ne créera des profils uniquement téléphoniques que si vous avez configuré Klaviyo SMS
Date d’anniversaire
La date de naissance du client, si elle est fournie
Groupes Square
Groupes Square associés au client. Cela n’inclut pas actuellement les segments Square

Consentement aux e-mails

L’intégration Square synchronise le statut de désabonnement aux e-mails, mais ne synchronise pas le consentement à l’abonnement aux e-mails. Lorsque email_unsubscribed est défini sur true dans Square, Klaviyo marque le client comme Désabonné. Lorsqu’elle est définie sur false, la synchronisation ne modifie pas le statut d’abonnement aux e-mails d’un profil existant. Les nouveaux profils sans consentement aux e-mails sont marqués comme Jamais abonné.

Consentement pour SMS

Le consentement SMS collecté dans Square Online ne peut actuellement pas être synchronisé avec Klaviyo. Vous pouvez collecter le consentement SMS via un formulaire Klaviyo sur votre site Square.

Détails de l’article du catalogue

Les articles du catalogue se synchronisent de Square vers Klaviyo avec les propriétés suivantes :

nomarticle
Identifiant de l’article
Description de l’article
Prix de l’article
SKU
URL
URL de l’image
Quantité en stock
Politique d’inventaire
Catégorie
Publié
Variantes

Événements synchronisés et leurs propriétés

Commande abandonnée

Cet évènement est déclenché 1 heure après l’abandon d’un panier dans une boutique Square Online, et peut être utilisé dans un flux de panier abandonné. Square doit fournir un enregistrement client avec une adresse e-mail valide ou un numéro de téléphone pour que l’évènement se synchronise.

Pour que cet événement se synchronise avec Klaviyo, vous devez d’abord désactiver les e-mails de panier abandonné dans Square. Pour cela, procédez comme suit :

Connectez-vous à Square et accédez à votre page d’aperçu
Sélectionnez Communications > Panier abandonné
Sélectionnez Désactiver