Guide sur les données de Magento 2

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 extrait 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 données de commande et de client toutes les 30 minutes. Voici quelques exemples de ces données : les informations associées aux commandes passées, aux commandes honorées, etc.

Dans Klaviyo, vous pouvez accéder à l’ onglet Analyse de votre compte 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 de commande synchronisés depuis votre intégration Magento 2. Vous verrez également des événements de tracking sur site Klaviyo avec une icône en forme d’engrenage ; ceux-ci sont également suivis via l’intégration.

Comment Klaviyo détermine les indicateurs Magento 2

Indicateurs de commande

Les indicateurs de commande 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 par rapport à la matrice ci-dessous afin de déterminer quels événements doivent être déclenchés.

Si vous avez des statuts de commande personnalisés qui ne devraient pas déclencher l’indicateur Placed Order , ou qui ne correspondent pas au tableau ci-dessus, veuillez nous le faire savoir et nous pourrons ajuster la correspondance des statuts de commande en conséquence dans vos intégrations.

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 Started Checkout repose sur la création d’un « Devis » et sur l’association d’une adresse e-mail à celui-ci. Cela se produit après que le client a saisi son adresse e-mail à l’étape « Informations d’expédition » du paiement. Si un client ne termine pas le paiement, ce devis est synchronisé avec Klaviyo en tant qu’événement Started Checkout.

Si le client continue et finalise la commande, ce devis est converti en « facture » dans la base de données de Magento. Par conséquent, un événement Started Checkout n’est pas envoyé à Klaviyo. À la place, un événement Placed Order est envoyé. Notez qu’il peut falloir jusqu’à 1 heure pour que les événements Started Checkout soient synchronisés avec Klaviyo.

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 chacun des 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.
• OrderedProducts
  Les noms des produits dans la commande annulée.
• OrderedProductCount
  Le nombre de produits dans la commande annulée.
• 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.
• Produits commandés
  Les noms des produits dans la commande.
• OrderedProductCount
  Le nombre de produits dans la commande.
• 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é

Cet événement est suivi une fois pour chaque produit qu’un utilisateur commande lorsqu’il passe une commande.

• SKU
  Le SKU du produit.
• OrderCurrencyCode
  Le code de devise du produit.
• Prix
  La valeur du produit.
• Catégories
  La catégorie du produit.
• Avec remise
  Toutes les remises appliquées au produit.
• Quantité
  Le nombre de produits.
• 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.
• Produits commandés
  Les noms des produits dans la commande.
• OrderedProductCount
  Le nombre de produits dans la commande.
• 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é lorsqu’un client rembourse une commande.

• Valeur
  La valeur de la commande.
• Avec remise
  Si la commande bénéficie d’une remise ou non.
• OrderedProducts
  Les noms de tous les produits dans la commande.
• OrderedProductCount
  Le nombre de produits dans la commande.
• 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 se déclenche lorsqu’un client avec une adresse e-mail connue commence une commande. Sur une page de commande standard, cet événement se déclenche lorsqu’un client saisit ses informations de contact et de livraison sur la première page du processus de commande Magento, puis clique sur Continuer. Un événement Started Checkout n’est pas envoyé à Klaviyo si l’utilisateur termine le paiement. À la place, un événement Placed Order est enregistré.

• Valeur
  La valeur de la commande lors du paiement.
• ItemCount
  Le nombre d’articles dans la commande.
• 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).

Klaviyo génère une clé, la clé de reconstruction du panier, qui vous permet de créer un lien reconstruisant le panier du client s’il revient à 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 à l’aide de 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 consulte un produit sur votre site. Vous pouvez filtrer et cibler des 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 enregistré lorsqu’un client est actif sur votre site. Vous pouvez filtrer et cibler les indicateurs Active on Site en fonction des critères suivants :

• utm_medium
  Le support du paramètre de tracking UTM (par exemple, campagne).
• kx_present
  (Vrai ou faux) Indique si le paramètre kx est présent.
• 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 un contact à partir de la création d’une commande existante, d’un enregistrement client existant ou lorsqu’un passage en caisse est commencé. Klaviyo créera un nouveau profil Klaviyo pour chaque contact synchronisé et renseignera ce profil avec les informations suivantes :

• E-mail
• Prénom et nom de famille
• Ville, État/région, code postal, pays
• Phone Number
• Compte Magento créé (par exemple, YYY-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

Il se peut que la valeur Revenue sur votre tableau de bord Klaviyo ne corresponde pas toujours à la valeur de revenus que vous voyez dans Magento ; cela s’explique par le fait que Klaviyo ne soustrait pas les commandes annulées et remboursées de notre calcul des revenus.