Référence des données Square
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. De plus, découvrez comment afficher vos données Square dans Klaviyo.
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
Pour vérifier la synchronisation des données de Square vers Klaviyo :
- Dans votre compte Klaviyo, sélectionnez l’onglet Intégrations .
- Sélectionnez Square dans la liste des intégrations activées.
- Sélectionnez l’onglet Données en haut.
Ici, vous verrez les données récentes synchronisées de Square vers Klaviyo, ainsi qu’une barre de progression de synchronisation pour la synchronisation de vos données historiques.
Si vous rencontrez des problèmes avec votre synchronisation, vous pouvez sélectionner Redémarrer l’importation ici pour redémarrer la synchronisation des données historiques.
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 Square auront une propriété appelée nom de la source qui indiquera si l’événement provient d’un point de vente (POS) ou du canal en ligne/web, afin que vous puissiez segmenter ces événements dans Klaviyo.
Détails des coordonnées client
Les profils des clients sont synchronisés entre Square et Klaviyo s’il existe une adresse e-mail et/ou un numéro de téléphone associé au client que le client a directement partagé avec votre entreprise. Les profils synchronisés entre Square et Klaviyo seront créés avec les propriétés suivantes :
- E-mail
Adresse e-mail du client - Prénom
Prénom du client (obligatoire) - Nom
Nom du client - 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
La plateforme Square est une plateforme de consentement marketing « opt-out ». Cela signifie que toute personne qui vous fournit son adresse e-mail n’a pas eu la possibilité de consentir explicitement à votre marketing par e-mail. À la place, Klaviyo marquera les personnes dont le champ email_unsubscribed est défini sur false dans Square comme « Jamais abonné » dans Klaviyo, et celles dont le champ email_unsubscribed est défini sur true dans Square comme « Désabonné » dans Klaviyo.
Consentement pour SMS
Les abonnés SMS collectés dans Square Online ne peuvent pas actuellement être synchronisés vers Klaviyo. Vous pouvez recueillir 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 qu’un panier a été abandonné dans une boutique Square Online et peut être utilisé dans un flux de panier abandonné.
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
Les propriétés de niveau supérieur de l’événement dans Klaviyo sont :
- $value
Montant total dans le panier - Articles
Articles inclus dans la commande - Collections
Collections liées aux articles inclus dans la commande - Nombre d’articles
Nombre total d’articles inclus dans la commande
Commande passée
Cet événement est déclenché lorsqu’un événement de commande est passé sur une boutique Square Online ou un terminal PDV.
Les propriétés de niveau supérieur de l’événement dans Klaviyo sont :
- $value
Montant total de la commande - Articles
Articles inclus dans la commande - Collections
Collections liées aux articles inclus dans la commande - Nombre d’articles
Nombre total d’articles inclus dans la commande - Codes de réduction
Codes de réduction appliqués à la commande - Total des remises
Montant total des remises - Nom de la source
Source de la commande (Square Online, POS) - Nom de l’emplacement
Nom de l’emplacement Square
Produit Commandé
Cet événement est déclenché lorsqu’un événement de commande est passé sur une boutique Square Online ou un terminal PDV. Un événement Ordered Product est déclenché pour chaque article dans un Placed Order.
Les propriétés de niveau supérieur de l’événement dans Klaviyo sont :
- $value
Montant total de la commande - Nom
Nom du produit commandé - Nom de la variante
Nom de la variante du produit - SKU
SKU du produit - ID produit
Identifiant du produit - ID de la variante
Identifiant de la variante - Quantité
Nombre de produits - Collections
Collections associées au produit - Option de variante
Option de variante du produit commandé - Option de modificateur
Options de modificateur appliquées à la commande
Commande Remboursée
Cet événement est déclenché lorsqu’une commande est remboursée sur une boutique Square Online ou un terminal PDV.
Les propriétés de niveau supérieur de l’événement dans Klaviyo sont :
- $value
Montant total de la commande - URL du reçu
URL du reçu de la commande - Nom de la source
Source de la commande (Square Online, POS) - Nom de l’emplacement
Nom de l’emplacement Square
Commande Annulée
Cet événement est déclenché lorsqu’un client crée une commande dans votre boutique, puis annule la commande dans son intégralité. L’événement suivi par Klaviyo comprend toutes les informations sur les articles achetés, y compris les noms des produits et les images. Les annulations partielles ne sont pas prises en charge.
Les propriétés de niveau supérieur de l’événement dans Klaviyo sont :
- $value
Montant total de la commande - Articles
Articles inclus dans la commande - Collections
Collections liées aux articles inclus dans la commande - Nombre d’articles
Nombre total d’articles inclus dans la commande - Codes de réduction
Codes de réduction appliqués à la commande - Total des remises
Montant total des remises - Nom de la source
Source de la commande (Square Online, POS) - Nom de l’emplacement
Nom de l’emplacement Square
Commande partiellement traitée
Un événement Fulfilled Partial Order sera enregistré si une commande est expédiée en plusieurs exécutions, et un événement sera enregistré pour chaque exécution partielle.
Les propriétés de niveau supérieur de l’événement dans Klaviyo sont :
- $value
Montant total pour l’exécution - Articles
Articles inclus dans l’exécution de la commande - Collections
Collections associées aux articles inclus dans l’exécution - Nombre d’articles
Nombre total d’articles inclus dans l’exécution - Codes de réduction
Codes de réduction appliqués à la commande - Total des remises
Montant total des remises - Nom de la source
Source de la commande (Square Online, POS) - Nom de l’emplacement
Nom de l’emplacement Square
Commande Traitée
Cet événement est déclenché lorsqu’une commande est exécutée sur une boutique Square Online ou un terminal PDV. Un événement Fulfilled Order est enregistré lors de la dernière exécution, s’il y en a plusieurs associées à une commande.
Les propriétés de niveau supérieur de l’événement dans Klaviyo sont :
- $value
Montant total de la commande - Articles
Articles inclus dans la commande - Collections
Collections liées aux articles inclus dans la commande - Nombre d’articles
Nombre total d’articles inclus dans la commande - Codes de réduction
Codes de réduction appliqués à la commande - Total des remises
Montant total des remises - FulfillmentStatus
Statut de l’exécution - Nom de la source
Source de la commande (Square Online, POS) - Nom de l’emplacement
Nom de l’emplacement Square