Guide sur les données de Magento 2

Découvrez quelles données Klaviyo importe depuis votre boutique Magento 2 lorsque vous intégrez les deux plateformes. La synchronisation historique initiale importe jusqu’à 5 ans de données de commande et de données client, y compris les informations associées aux commandes passées, passées et exécutées. Une fois activée, l’intégration synchronise également les données de commande et les données client toutes les 30 minutes.

Dans Klaviyo, accédez à Analytics > Indicateurs dans la barre latérale gauche pour afficher tous les indicateurs de votre compte ; les indicateurs avec une icône Magento 2 correspondent aux événements synchronisés depuis vos intégrations Magento 2. Vous verrez également les événements de tracking onsite de Klaviyo avec une icône d’engrenage ; ils sont également trackés via les intégrations.

Comment Klaviyo détermine les indicateurs Magento 2

Indicateurs de commande

Klaviyo enregistre un événement Placed Order pour chaque commande qu’il synchronise. Il utilise également le Status actuel de la commande et l’historique des statuts dans Magento 2 pour enregistrer des indicateurs supplémentaires de commande.

Lorsqu’une commande est créée ou mise à jour, Klaviyo vérifie son statut actuel, ainsi que l’historique des statuts. Le tableau ci-dessous présente les mappages standard. Les commandes avec pending_payment, ou un statut personnalisé configuré pour être ignoré, sont exclues.

Si vous avez des statuts de commande personnalisés qui ne doivent pas déclencher l’indicateur Placed Order , ou qui ne sont pas alignés avec le tableau ci-dessus, veuillez nous en informer afin que nous puissions configurer les statuts personnalisés pour les ignorer ou les associer à d’autres événements de commande.

Les commandes dont le statut est « pending_payment » seront ignorées.

Indicateur Début de commande

Avec un processus de paiement Magento standard, cet événement est déclenché lorsqu’un client saisit ses coordonnées et ses informations de livraison sur la première page du processus de paiement Magento et clique sur Continuer.

L’événement Validation de commande lancée repose sur un panier (appelé « quote » dans Magento) avec une adresse e-mail associée. Klaviyo le synchronise uniquement si le panier est toujours actif et contient des articles au moment où la synchronisation s’exécute.

Si le client finalise la commande avant la synchronisation du panier, le panier n’est plus actif, et Klaviyo l’ignore. Un événement Placed Order est enregistré lorsque la commande se synchronise, sauf si son statut est ignoré. Un événement Started Checkout déjà synchronisé reste dans Klaviyo. Notez que la synchronisation des événements Started Checkout vers Klaviyo peut prendre jusqu’à 1 heure.

Indicateur Expédition terminée

Cet indicateur est déclenché lorsqu’une nouvelle expédition est créée dans votre boutique Magento 2.

Données d’indicateur Magento 2

Cette section couvre les indicateurs 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é lorsqu’un statut de commande est remplacé par canceled ou canceled dans votre boutique Magento 2.

• ProductCategories
  Les catégories des produits de la commande annulée.
• Valeur
  La valeur de la commande annulée.
• Avec remise
  (Vrai ou Faux) L’état de remise de la commande annulée.
• Noms des produits
  Les noms des produits de la commande annulée.
• ItemCount
  Le nombre d’articles de ligne dans la commande, et non la quantité totale d’unités.
• OrderCurrencyCode
  Le code de devise utilisé avec la commande annulée.
• CartPriceRuleIDs
  Un tableau d’ID de règles de prix du panier (chaînes d’ID numériques) qui incluent les règles appliquées automatiquement et la règle associée à un code de réduction appliqué.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.

Commande Traitée

Cet événement est suivi lorsque vous définissez le statut d’une commande sur terminée dans votre boutique Magento 2.

• ProductCategories
  Les catégories des produits dans la commande.
• Valeur
  La valeur de la commande.
• Avec remise
  Si la commande bénéficie d’une remise ou non.
• Noms des produits
  Les noms des produits dans la commande.
• ItemCount
  Le nombre d’articles de ligne dans la commande, et non la quantité totale d’unités.
• OrderCurrencyCode
  Le code de devise utilisé avec la commande.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.

Expédition Terminée

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

• StoreName
  Le nom de la boutique où la commande a été passée.
• StoreID
  L’identifiant de la boutique où la commande a été passée.
• BillingAddress
  L’adresse de facturation de la commande.
• Suit
  Informations sur le tracking des expéditions.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.

Produit Commandé

Klaviyo enregistre 1 événement Ordered Product par unité commandée, jusqu’à 100 événements par ligne d’article. Par exemple, une commande de 3 T-shirts identiques génère 3 événements Ordered Product, chacun avec une quantité de 1. Pour les produits vendus en quantités fractionnaires, Klaviyo enregistre 1 événement avec la quantité commandée.

• SKU
  Le SKU du produit.
• OrderCurrencyCode
  Le code de devise du produit.
• Prix
  La valeur du produit.
• Catégories
  La catégorie du produit.
• Remisé
  (Vrai ou Faux) Indique si une remise a été appliquée au produit.
• Quantité
  La quantité représentée par cet événement : 1 pour les achats à l’unité, ou la quantité commandée pour les produits vendus en quantités fractionnaires.
• Value
  La valeur du produit.
• ProductID
  L’identifiant du produit.
• RootProductID
  L’ID du produit parent.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.

Commande passée

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

• ProductCategories
  Les catégories des produits dans la commande.
• Valeur
  La valeur de la commande.
• Avec remise
  Si la commande bénéficie d’une remise ou non.
• Noms des produits
  Les noms des produits dans la commande.
• ItemCount
  Le nombre d’articles de ligne dans la commande, et non la quantité totale d’unités.
• OrderCurrencyCode
  Le code de devise utilisé avec la commande.
• CartPriceRuleIDs
  Un tableau d’ID de règles de prix du panier (chaînes d’ID numériques) qui incluent les règles appliquées automatiquement et la règle associée à un code de réduction appliqué.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.

Commande Remboursée

Cet événement est déclenché lorsque le statut d’une commande passe à « closed » dans Magento 2. Un remboursement partiel qui laisse la commande dans un autre statut ne déclenche pas l’événement « Refunded Order » via le mappage de statut standard.

• Valeur
  La valeur de la commande.
• Avec remise
  Si la commande bénéficie d’une remise ou non.
• ProductNames
  Les noms de tous les produits de la commande.
• ItemCount
  Le nombre d’articles de ligne dans la commande, et non la quantité totale d’unités.
• OrderCurrencyCode
  Le code de devise utilisé avec la commande.
• ProductCategories
  Les catégories des produits dans la commande.
• CartPriceRuleIDs
  Un tableau d’ID de règles de prix du panier (chaînes d’ID numériques) qui incluent les règles appliquées automatiquement et la règle associée à un code de réduction appliqué.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.

Début de commande

Cet événement est déclenché lorsqu’un client dont l’adresse e-mail est connue commence un passage en caisse, et que le panier contient toujours des articles lorsque Klaviyo le synchronise. Sur une page de passage en caisse standard, le client saisit ses informations de contact et de livraison, puis clique sur Continuer. S’il finalise le passage en caisse avant que le panier ne soit synchronisé, Klaviyo ignore l’événement Started Checkout et enregistre Placed Order lorsque la commande est synchronisée, sauf si son statut est ignoré. Finaliser une commande ne supprime pas un événement Started Checkout qui a déjà été synchronisé.

• Valeur
  La valeur de la commande lors du paiement.
• ItemCount
  Le nombre de lignes d’articles dans le panier, et non la quantité totale d’unités.
• Articles
  Les articles dans la commande.
• ProductCategories
  Les catégories des produits dans la commande.
• Noms des produits
  Les noms des produits dans la commande.
• StoreName
  Le nom du magasin où la commande a été commencée.
• ID de la boutique
  L’ID de la boutique où la commande a été lancée.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.

Ajout au Panier

Veuillez noter que cet indicateur n’est suivi que si vous utilisez la version 4.0.0 ou ultérieure de l’extension Klaviyo. Cet indicateur est suivi lorsqu’un client pour lequel Klaviyo a déposé un cookie ajoute un article à son panier.

Il comprend des informations détaillées sur l’article qui a été ajouté. C’est utile lorsque vous créez des segments en fonction des produits que les utilisateurs ont ajoutés au panier, ou lorsque vous créez un flux de panier abandonné. Vous pouvez filtrer et cibler les indicateurs Added To Cart en fonction des critères suivants :

• MaskedQuoteId
  MaskedQuoteId ou identifiant unique pour les clients connectés.
• AddedItemCategories
  Les catégories auxquelles l’article appartient.
• Nom du produit de l’article ajouté
  Le nom du produit dans votre boutique (par exemple, T-shirt rouge).
• AddedItemDescription
  La description de l’article.
• AddedItemImageURLKey
  L’URL de l’image de l’article.
• AddedItemPrice
  Prix de l’article.
• AddedItemProductID
  L’ID personnalisé dans votre boutique Magento 2 du produit, p. ex., 1234.
• AddedItemSKU
  Le SKU de l’article dans votre boutique (par ex., REDMEDIUMTSHIRT).
• AddedItemURL
  L’URL de l’article.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.
• integration_key
  Votre plateforme e-commerce (Magento 2).

Utilisez la valeur MaskedQuoteId de l’événement Added To Cart pour créer un lien qui reconstruit le panier du client lorsqu’il revient depuis un e-mail sur un autre appareil. Utilisez l’URL suivante :

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

Consultation d’un produit

Cet indicateur est suivi lorsqu’un client dont Klaviyo peut identifier l’affichage consulte un produit sur votre site. Vous pouvez filtrer et cibler les indicateurs Viewed Product en fonction des critères suivants :

• ProductID
  L’identifiant du produit.
• Nom
  Le nom du produit.
• SKU
  Le SKU du produit.
• URL
  L’URL du produit.
• Price
  Le prix du produit.
• FinalPrice
  Le prix final après application de toute remise.
• Catégories
  Un tableau contenant les catégories auxquelles le produit appartient.
• ImageURL
  L’URL de l’image du produit.
• external_catalog_id
  Utilisé pour organiser les catalogues dans Klaviyo.
• integration_key
  Votre plateforme e-commerce (Magento 2).

Activité sur le Site

Cet indicateur est suivi lorsqu’un client que Klaviyo peut identifier est actif sur votre site. Vous pouvez utiliser l’activité Active on Site dans les segments et les flux, mais les propriétés d’événement ci-dessous ne sont pas disponibles pour les filtres de segment ou de flux. Vous pouvez les examiner dans les données brutes de l’événement :

• utm_medium
  Le support du paramètre de tracking UTM (par exemple, campagne).
• kx_present
  Vrai lorsque le paramètre kx est présent dans l’URL. Le champ est omis lorsque le paramètre est absent.
• os
  Le système d’exploitation de l’appareil de l’utilisateur.
• initial_page_path
  Le chemin d’URL de la première page sur laquelle l’utilisateur est arrivé.
• browser
  Le type de navigateur de l’utilisateur.
• page
  URL de la page sur laquelle l’utilisateur était actif.
• utm_campaign
  Le paramètre de tracking UTM pour la campagne.
• utm_source
  La source UTM (par exemple, Klaviyo).

Données clients synchronisées

Klaviyo crée ou met à jour des profils à partir des commandes synchronisées, des dossiers clients, et des paiements commencés. Les informations suivantes sont ajoutées lorsqu’elles sont disponibles dans les données source :

• E-mail
• Prénom et nom de famille
• Ville, État/région, code postal, pays
• Phone Number
• Compte Magento créé (par ex., YYYY-MM+-dd hh:mm:ss ; 2015-05-21 13:04:00)
• Groupe de clients Magento (p. ex., vente en gros)
• Boutique Magento (p. ex., boutique américaine)
• Date de naissance (par exemple, YYYY-MM-dd ; 1990-03-25)
• Genre

Si vous mettez à jour le groupe de clients dans Magento 2, même après la création du profil d’origine dans Klaviyo, le groupe de clients sera mis à jour dans Klaviyo.

Valeur du chiffre d’affaires

Lorsque vous utilisez l’indicateur « Placed Order » de Magento 2 pour mesurer le revenu, les commandes annulées et remboursées ne sont pas soustraites automatiquement. Cela peut faire que le revenu affiché dans Klaviyo diffère du revenu affiché dans Magento.

Ressources supplémentaires