Référence de données Magento 2

Vous apprendrez

Découvrez quelles données Klaviyo importe de votre boutique Magento 2 lorsque vous intégrez les deux plateformes. L'intégration de Klaviyo avec Magento 2 permet de récupérer toutes les données historiques de votre boutique Magento 2 lors de la synchronisation historique initiale. Une fois activée, l'intégration commencera également à synchroniser les mesures et les données des clients en temps quasi réel. Ces données comprennent par exemple les informations associées aux commandes passées, aux commandes honorées, etc.

Dans Klaviyo, vous pouvez naviguer vers l'onglet Analytics de votre compte dans la barre latérale gauche pour voir toutes les mesures de votre compte ; les mesures avec une icône Magento 2 sont celles synchronisées à partir de votre intégration Magento 2.

Comment Klaviyo détermine les indicateurs de Magento 2

Mesures des commandes

Les indicateurs de commande de Magento 2 sont déterminés par le champ Statut d' une commande dans votre boutique Magento 2.

Chaque fois qu'une commande est créée ou que son statut est mis à jour, elle est évaluée en fonction de la matrice ci-dessous afin de déterminer les événements à déclencher.

Si vous avez des statuts de commande personnalisés qui ne devraient pas déclencher une mesure de commande passée , ou qui ne correspondent pas au tableau ci-dessus, veuillez nous en informer et nous pourrons ajuster le mappage du statut de commande en conséquence dans votre intégration.

Les commandes dont le statut est "en attente de paiement" seront ignorées.

Démarrage de la métrique de paiement

Dans le cas d'une commande Magento standard, cet événement est déclenché lorsque le client saisit ses coordonnées et ses informations de livraison sur la première page de la procédure de commande Magento et qu'il clique sur Continuer. 

L'événement " Vérification commencée " repose sur la création d'un "devis" et sur l'association d'une adresse électronique à ce devis. Cela se produit après que le client a saisi son adresse électronique à l'étape "Informations relatives à l'expédition" de la commande. Si un client ne termine pas le paiement, ce devis est synchronisé avec Klaviyo en tant qu'événement " Started Checkout".

Si le client finalise sa commande, ce devis est converti en "facture" dans la base de données de Magento. Par conséquent, l'événement Started Checkout n'est pas envoyé à Klaviyo. Au lieu de cela, un événement " Commande passée" est envoyé. Notez qu'il peut s'écouler jusqu'à une heure avant que les événements Started Checkout ne soient synchronisés avec Klaviyo.

Métrique de l'envoi effectué

Cette mesure est déclenchée lorsqu'un nouvel envoi est créé dans votre boutique Magento 2.

Les métriques de Magento 2

Cette section couvre chacun des indicateurs de Magento 2 et les données disponibles pour le filtrage lors de la création de segments et de flux.

Commande annulée

Cet événement est déclenché lorsque le statut d'une commande est modifié et devient annulé dans votre boutique Magento 2.

• ProductCategories: Les catégories des produits dans la commande annulée.
• Valeur: La valeur de l'ordre annulé.
• Réduit: (Vrai ou Faux) L'état de réduction de la commande annulée.
• OrderedProducts: Les noms des produits de la commande annulée.
• OrderedProductCount: Le nombre de produits dans la commande annulée.
• OrderCurrencyCode: Code de la devise utilisée pour la commande annulée.
• CartPriceRuleIDs: Un tableau d'ID de règles de prix du panier (chaînes numériques d'identification) qui comprend les règles appliquées automatiquement et la règle pour un coupon appliqué.

Commande exécutée

Cet événement est suivi lorsque vous définissez le statut d'une commande comme complète dans votre boutique Magento 2.

• ProductCategories: Les catégories des produits de la commande.
• Valeur: La valeur de l'ordre.
• Réduit: Indique si la commande fait l'objet d'une remise ou non.
• OrderedProducts:Les noms des produits de la commande.
• OrderedProductCount: Le nombre de produits dans la commande.
• OrderCurrencyCode: Code de la devise utilisée pour la commande.

Envoi effectué

Cet événement est suivi lorsqu'une nouvelle expédition est créée dans votre boutique Magento 2.

• StoreName: Le nom du magasin où la commande a été passée.
• StoreID: L'identifiant du magasin où la commande a été passée.
• BillingAddress: L'adresse de facturation de la commande.
• Suivi: Informations sur le suivi des envois.

Produit commandé

Cet événement est suivi une fois pour chaque produit commandé par un utilisateur lorsqu'il passe une commande.

• SKU: Le SKU du produit.
• OrderCurrencyCode:Le code de la devise du produit.
• Le prix: La valeur du produit.
• Catégories: La catégorie du produit.
• Réduit: Toutes les réductions appliquées au produit.
• Quantité: Le nombre de produits.
• Valeur: La valeur du produit.
• ProductID: L'identifiant du produit.

Commande passée

Cet événement est suivi lorsqu'un utilisateur passe une commande.

• ProductCategories: Les catégories des produits de la commande.
• Valeur: La valeur de l'ordre.
• Réduit: Indique si la commande fait l'objet d'une remise ou non.
• OrderedProducts:Les noms des produits de la commande.
• OrderedProductCount: Le nombre de produits dans la commande.
• OrderCurrencyCode: Code de la devise utilisée pour la commande.
• CartPriceRuleIDs: Un tableau d'ID de règles de prix du panier (chaînes numériques d'identification) qui comprend les règles appliquées automatiquement et la règle pour un coupon appliqué.

Ordre remboursé

Cet événement est déclenché lorsqu'un client rembourse une commande. 

• Valeur: La valeur de l'ordre.
• Réduit: Indique si la commande fait l'objet d'une remise ou non. 
• OrderedProducts: Les noms de tous les produits de la commande.
• OrderedProductCount: Le nombre de produits dans la commande. 
• OrderCurrencyCode: Code de la devise utilisée pour la commande. 
• ProductCategories: Les catégories des produits de la commande. 
• CartPriceRuleIDs: Un tableau d'ID de règles de prix du panier (chaînes numériques d'identification) qui comprend les règles appliquées automatiquement et la règle pour un coupon appliqué.

Début de l'encaissement

Cet événement est déclenché lorsqu'un client dont l'adresse électronique est connue commence à passer à la caisse. Sur une page de paiement standard, cet événement est déclenché lorsque le client saisit ses coordonnées et ses informations de livraison sur la première page du processus de paiement de Magento et qu'il clique sur Continuer. L'événement Started Checkout n'est pas envoyé à Klaviyo si l'utilisateur termine le paiement. Au lieu de cela, un événement de commande passée est enregistré.

• Valeur: La valeur de la commande lors du paiement.
• ItemCount: Le nombre d'articles dans la commande. 
• Articles: Les éléments de la commande. 
• ProductCategories: Les catégories des produits de la commande. 
• ProductNames: Les noms des produits de la commande. 
• StoreName: Le nom du magasin où la commande a été lancée.
• StoreID: L'identifiant du magasin où la commande a été lancée.

Ajouté au panier

Veuillez noter que cette mesure n'est suivie que si vous utilisez l'extension Klaviyo version 4.0.0 et supérieure. Cette mesure est suivie lorsqu'un client, qui a été identifié par Klaviyo, ajoute un article à son panier.

Il contient des informations détaillées sur l'élément ajouté. Ceci est utile pour créer des segments basés sur les produits que les utilisateurs ont ajoutés au panier, ou pour construire un flux de panier abandonné. Vous pouvez filtrer et cibler les indicateurs ajoutés au panier en fonction des critères suivants :

• MaskedQuoteId: MaskedQuoteId ou identifiant unique pour les clients connectés.
• AddedItemCategories: Les catégories auxquelles l'élément appartient.
• AddedItemProductName: Le nom du produit dans votre magasin, par exemple T-shirt rouge.
• AddedItemDescription: La description de l'élément.
• AddedItemImageURLKey: L'URL de l'image de l'élément.
• AddedItemPrice: Le prix de l'article.
• AddedItemProductID: L'identifiant personnalisé du produit dans votre boutique Magento 2, par exemple 1234.
• AddedItemSKU: Le SKU de l'article dans votre magasin, par exemple REDMEDIUMTSHIRT.
• AddedItemURL: L'URL de l'élément.

Klaviyo génère une clé, la clé de reconstruction du panier, qui vous permet de créer un lien qui reconstruit le panier du client au cas où il reviendrait à son panier via un e-mail déclenché par cet événement sur un autre appareil. Cette clé se trouve dans le tableau de propriétés "extra". Vous pouvez créer ce lien en utilisant l'URL suivante :

{{ organization.url|trim_slash }}reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }}

Données clients synchronisées

Klaviyo crée un contact à partir de la création d'une commande existante, d'une fiche client existante ou lorsqu'une commande est lancée. Klaviyo créera un nouveau profil Klaviyo pour chaque contact synchronisé, et remplira ce profil avec les informations suivantes :

• Courriel
• Nom et prénom
• Ville, État/Région, Code postal, Pays
• Numéro de téléphone
• Compte Magento créé (par exemple, AAAA-mm-jj hh:mm:ss ; 2015-05-21 13:04:00)
• Groupe de clients Magento (par exemple, grossistes)
• Magento Store (par exemple, US Store)
• Date de naissance (par exemple, AAAA-mm-jj ; 1990-03-25)
• Genre

Si vous mettez à jour le groupe de clients dans Magento 2, même si le profil original a été créé dans Klaviyo, le groupe de clients sera mis à jour dans Klaviyo.

Vérifiez les données de vos commandes synchronisées

Klaviyo importe toutes vos données Magento 2. Pour le vérifier, vous pouvez comparer le nombre de commandes d'un jour donné avec ce qui figure dans l'interface de Magento 2 et confirmer qu'ils correspondent. Cliquez sur Analytics dans la barre latérale gauche, trouvez l'indicateur Placed Order et cliquez dessus. Vous accéderez ainsi à la page du graphique métrique et les données des 30 derniers jours s'afficheront par défaut. Vous pouvez voir un exemple de tableau métrique ci-dessous.

Passez la souris sur le point de données d'hier ou consultez le tableau de données situé sous le graphique pour connaître le nombre de commandes que vous avez reçues hier. Comparez ce nombre à celui stocké dans Magento et vous devriez voir qu'ils correspondent exactement. Si ce n'est pas le cas, le problème le plus probable est que le fuseau horaire de votre compte Klaviyo ne correspond pas à celui de Magento.

Pour vérifier ou mettre à jour le fuseau horaire de votre compte :

1. Cliquez sur le nom de votre organisation en bas à gauche.
2. Sélectionnez Paramètres.
3. Allez dans l'onglet Organisation . 

Vous pouvez constater que la valeur du revenu sur votre tableau de bord Klaviyo ne correspond pas toujours à la valeur du revenu que vous voyez dans Magento ; c'est parce que Klaviyo ne soustrait pas les commandes annulées et remboursées de notre calcul du revenu.

Ressources complémentaires

• Comment s'intégrer à Magento 2.x (CE et EE)
• Dépannage de votre intégration Magento 2