Guide sur les données de Magento 1

Objectif de cet article

Découvrez quelles données Magento 1 sont importées dans Klaviyo lorsque vous intégrez les deux plateformes. L’intégration de Klaviyo avec Magento récupère toutes les données historiques de votre boutique Magento au moment de votre synchronisation historique initiale. Une fois activée, l’intégration commencera à synchroniser les indicateurs et les données client en quasi temps réel. 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 Analyses de votre compte dans la barre latérale gauche pour afficher tous les indicateurs de votre compte ; les indicateurs avec une icône Magento sont ceux synchronisés depuis votre intégration Magento.

Indicateurs Magento

Commande Annulée

Cet événement est suivi lorsqu'un client crée une commande dans votre boutique Magento, mais l'annule avant qu'elle ne soit exécutée. Klaviyo suit les données associées, y compris toutes les informations sur les produits achetés. Les informations sur les produits comprennent les noms des produits, les images et les informations sur les variantes que vous pouvez utiliser dans les e-mails de suivi des achats.

Vous pouvez filtrer et cibler les événements de commande annulée en fonction des critères suivants :

• Valeur: valeur totale de la commande (sous-total + frais d’expédition - éventuelles réductions).
• Items: les noms des produits dans la commande d’une personne.
  p. ex. : t-shirt ou pantalon. En cas de commande multiple, plusieurs occurrences du même article s’afficheront.
• Catégories d’articles: l’ensemble complet des catégories des articles dans la commande d’une personne (par exemple, t-shirts, hommes, pantalons et soldes).
• Nombre d’articles: le nombre d’articles dans la commande (par exemple, 2).
• Code de devise: la devise spécifique utilisée pour payer un article selon le pays (p. ex., USD, EUR).
• Remisé: si une remise est appliquée à cet article spécifique (c’est-à-dire, vrai/faux).
• Code de réduction: le code de réduction appliqué.
• Unique Items: L’article individuel inclus dans une commande (par ex., chemises, shorts). Si plusieurs produits sont commandés, l’article unique ne s’affichera qu’une seule fois.
• Catégories d’articles uniques: les catégories dans lesquelles les articles uniques sont regroupés (par ex., hommes, soldes).
• Attributs (facultatif): Attributs de produit personnalisés.

Commande Terminée

Cet événement est suivi lorsqu’un client finalise un paiement dans votre boutique Magento. L’événement Checkout Completed ne se synchronise pas de façon rétroactive. Il n’est donc pas toujours une mesure exacte lorsque vous examinez le total des événements au fil du temps. Pour le tracking des revenus et la segmentation, utilisez l’événement Placed Order.

Vous pouvez filtrer et cibler les événements de paiement finalisé en fonction des critères suivants :

• Value: La valeur totale de la commande.
• Codes de réduction: tous les codes de code de réduction ou de réduction appliqués.
• Items: Les noms des produits dans le panier d’une personne (par ex., t-shirt ou pantalon).
• Nombre d’articles: le nombre total d’articles dans le panier d’une personne.
• Total des réductions (facultatif): Valeur totale en dollars de tout code de réduction ou remise.

Commande Débutée

Cet événement est suivi lorsqu’un client saisit ses coordonnées et ses informations de livraison sur la première page du processus de commande de Magento, puis clique sur continuer. Klaviyo suit les données produit associées aux articles du panier d’une personne, notamment les noms de produits, les images et les informations sur les variantes, que vous pouvez utiliser dans vos e-mails de panier abandonné. Cet événement comporte une propriété d’URL de paiement qui renvoie au panier exact de chaque client et peut être utilisée pour reconstruire le panier si un client ouvre l’e-mail depuis un nouvel appareil.

Vous pouvez filtrer et cibler les événements de paiement commencé en fonction des critères suivants :

• Valeur: la valeur du panier au moment du paiement (sous-total + frais d’expédition - remises éventuelles).
• Items: Les noms des produits dans le panier d’une personne (par ex., t-shirt ou pantalon).
• Nombre d’articles: le nombre total d’articles dans le panier d’une personne.
• Codes de réduction (facultatif): Tous les coupons ou codes de réduction appliqués.
• Total des réductions (facultatif): Valeur totale en dollars de tout code de réduction ou remise.

Commande Traitée

Cet événement est suivi lorsque vous marquez une commande dans votre boutique Magento comme étant expédiée. Klaviyo suit les informations relatives aux produits achetés, y compris les noms de produits, les images et les informations sur les variantes, qui peuvent être utilisées dans les e-mails de suivi des achats.

Vous pouvez filtrer et cibler les événements Commande traitée fonction des critères suivants :

• Valeur: valeur totale de la commande (sous-total + frais d’expédition - éventuelles réductions).
• Items: les noms des produits dans la commande d’une personne (p. ex., t-shirt ou pantalon). En cas de commandes multiples, plusieurs exemplaires du même article s’afficheront.
• Catégories d’articles: L’ensemble complet des catégories des articles dans la commande d’une personne (p. ex., t-shirts, hommes, pantalons et soldes).
• Item Count: Le nombre d’articles dans la commande. (par exemple, 2).
• Code de devise: La devise spécifique utilisée pour payer un article en fonction du pays (p. ex., USD, EUR).
• Remisé: si une remise est appliquée à cet article spécifique (c’est-à-dire, vrai/faux).
• Code de réduction: le code de réduction appliqué.
• Articles uniques: l’article individuel créé dans une commande (par ex., chemises, shorts). Si plusieurs produits sont commandés, l’article unique ne s’affichera qu’une seule fois.
• Catégories d’articles uniques: les catégories dans lesquelles les articles uniques sont regroupés (par ex., hommes, soldes).
• Attributs (facultatif): Attributs de produit personnalisés.

Produit Commandé

Cet événement est suivi lorsqu’un client passe sa commande. Un événement Ordered Product est suivi pour chaque article qu’une personne achète. Par exemple, si quelqu’un achète un t-shirt et un pantalon, un événement Placed Order est suivi et deux événements Ordered Product sont enregistrés : un événement pour le t-shirt et un événement pour le pantalon.

L’événement Produit commandé inclut des informations détaillées sur chaque produit qu’une personne achète. Cela est utile lorsque vous créez des segments comportementaux basés sur les options de variante de produit et d’autres informations détaillées qui ne sont pas disponibles dans l’événement Placed Order. Vous pouvez filtrer et cibler les événements Ordered Product en fonction des critères suivants :

• Value: Prix total de l’article (n’inclut pas les frais d’expédition ni les remises appliquées).
• Nom: le nom donné à cet élément spécifique.
• SKU: le SKU spécifique attribué pour suivre un article (par ex., REDMEDIUMTSHIRT).
• Catégories: L’ensemble complet des collections des produits dans la commande d’une personne (p. ex., t-shirts, hommes, pantalons et soldes).
• Prix: La valeur en dollars du produit spécifique (par exemple, chemises 25,50, chaussures 50,25).
• Coût: le coût de fabrication d’un produit (par ex., t-shirts 13,85, chaussures 20,00).
• Code de devise: la devise spécifique payée pour un article en fonction du pays (p. ex., USD, EUR).
• Avec remise: si une remise est appliquée à cet article spécifique (c’est-à-dire true ou false).
• ProductID: ID du produit spécifique dans votre boutique.
• Quantité : Quantité commandée.
• Attributs (facultatif): Attributs de produit personnalisés.

Commande passée

Cet événement est suivi lorsqu'un client termine le processus de paiement et crée une commande dans votre boutique Magento. Klaviyo suit les données connexes, y compris les informations sur les produits achetés, notamment les noms de produits, les images et les informations sur les variantes, que vous pouvez utiliser dans les e-mails de suivi des achats. Vous pouvez filtrer et cibler les événements de commande passée en fonction des critères suivants :

• Value: Valeur totale de la commande (sous-total + expédition - remises éventuelles).
• Items: les noms des produits dans la commande d’une personne, par exemple : t-shirt ou pantalon. Si l’article est commandé plusieurs fois, plusieurs exemplaires du même article s’afficheront.
• Catégories d’articles: l’ensemble complet des catégories des articles dans la commande d’une personne (p. ex., t-shirts, hommes, pantalons et soldes).
• Nombre d’articles: Le nombre d’articles dans la commande (p. ex., 2).
• Currency Code: Le code de devise spécifique utilisé pour payer un article en fonction du pays (par ex., USD, EUR).
• Remisé: si une remise est appliquée à cet article spécifique (c’est-à-dire, vrai/faux).
• Code de réduction: le code de réduction appliqué.
• Articles uniques: l’article individuel créé dans une commande (par ex., t-shirts, shorts). Si plusieurs produits sont commandés, l’article unique ne s’affichera qu’une seule fois.
• Unique Item Categories: Les catégories dans lesquelles les articles uniques sont regroupés (par exemple, mens, sale).
• Attributs (facultatif): jusqu’à 10 attributs de produit personnalisés peuvent être synchronisés pour les commandes passées. Cette synchronisation doit être activée avant que les données d’attributs personnalisés n’arrivent dans votre compte Klaviyo. Consultez la section ci-dessous pour savoir comment configurer cela.

Commande Remboursée

Cet événement est suivi lorsqu’une commande est remboursée dans Magento.

• Value: Valeur totale de la commande (sous-total + expédition - remises éventuelles).
• Code de réduction: le code de réduction appliqué.
• Currency Code: Le code de devise spécifique utilisé pour payer un article en fonction du pays (par ex., USD, EUR).
• Remisé: indique si une remise a été appliquée à cet article spécifique (c.-à-d. vrai/faux).
• Catégories d’articles: l’ensemble complet des catégories des articles dans la commande d’une personne (p. ex., t-shirts, hommes, pantalons et soldes).
• Nombre d’articles: le nombre d’articles dans la commande (par exemple, 2).
• Items: les noms des produits dans la commande d’une personne (p. ex., t-shirt ou pantalon). Si l’article est commandé plusieurs fois, plusieurs exemplaires du même article s’afficheront.
• Catégories d’articles uniques: les catégories dans lesquelles les articles uniques sont regroupés (par ex., hommes, soldes).
• Articles uniques: l’article individuel créé dans une commande, par exemple : chemises, shorts. Si plusieurs produits sont commandés, l’article unique ne s’affichera qu’une seule fois.

Le chiffre d’affaires, ou la valeur Commande passée, est calculé comme suit : (prix des commandes + frais de livraison - remises). Pour filtrer un segment en fonction de $value, filtrez le segment à l’aide de Chiffre d’affaires.

Payment est disponible en tant que propriété de deuxième niveau sous le champ extra. Vous ne pouvez pas filtrer sur des propriétés de deuxième niveau pour la segmentation, mais vous pouvez utiliser ces données comme variable d’événement dans vos modèles d’e-mail.

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, 2015-05-01 00:00:00)
• Groupe de clients Magento (p. ex., vente en gros)
• Boutique Magento (p. ex., boutique américaine)
• Date de naissance (p. ex., 1990-01-01)
• Genre
• website_ID ne sera pas extrait
• Les suspensions ne sont pas copiées dans Klaviyo et n'apparaissent donc pas dans la plate-forme Klaviyo.

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

Synchroniser les attributs de produit personnalisés pour les commandes passées

Klaviyo peut synchroniser jusqu’à 10 attributs de produit personnalisés pour l’indicateur Placed Order. Les attributs de produit personnalisés ne seront pas transférés automatiquement vers Klaviyo ; toutefois, vous pouvez demander à Klaviyo de les importer. Pour ce faire, vous devez collecter l’ID de l’attribut personnalisé (instructions ci-dessous) et envoyer une demande à notre équipe d’assistance.

Trouvez les ID de produit personnalisés dans le panneau administrateur de Magento en accédant à Catalog > Attributes > Manage Attributes, puis en cliquant sur l’attribut.

L’ID se trouve dans l’URL, comme suit :

Vérifier les données de commande synchronisées

Klaviyo importe toutes vos données Magento. Pour le vérifier, vous pouvez comparer le nombre de commandes d’un jour donné avec celui indiqué dans l’interface Magento et confirmer qu’ils correspondent. Cliquez sur Analytics dans la barre latérale gauche, trouvez l’indicateur Placed Order et cliquez dessus. Vous serez redirigé vers la page du graphique de l’indicateur, qui affiche par défaut les 30 derniers jours de données. Vous pouvez voir ci-dessous un exemple du graphique de l’indicateur affiché.

Passez la souris sur le point de données d’hier ou consultez le tableau des données sous le graphique pour voir combien de commandes vous avez eues hier. Comparez ce nombre à celui stocké dans Magento et vous devriez constater 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 votre paramètre de fuseau horaire :

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

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.

Propriétés des commandes Magento synchronisées

Vous trouverez ci-dessous des exemples de payloads JSON pour les indicateurs Placed Order, Ordered Product et Fulfilled Order, qui correspondent aux propriétés que nous stockons pour les commandes synchronisées via l’API SOAP Magento.

C’est utile pour envoyer les propriétés appropriées pour les commandes qui seront combinées aux données de commande Magento.

Commande passée

// 
// PLACED ORDER
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Placed Order",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "1234",
    "$value" : 29.98,
    "$extra" : {},
    "Currency Code" : "USD",
    "Item Count" : 2,
    "Items" : ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "Discounted" : true,
    "Coupon" : "COUPON123",
    "Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
    "Item Categories" : ["Fiction", "Classics", "Children"],
    "Unique Item Categories" : ["Fiction", "Classics", "Children"]
  },
  "time" : 1387302423
}

Produit Commandé

// 
// ORDERED PRODUCT
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Ordered Product",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "123456789", // LineId (unique)
    "$value" : 9.99,
    "Currency Code" : "USD",
    "Name" : "Winnie the Pooh",
    "SKU" : "WINNIEPOOH",
    "ProductID" : "567",
    "Categories" : ["Fiction", "Classics"],
    "Price" : 9.99,
    "Discounted" : true,
    "Cost" : 5.00, // (optional),
    "Attribute: Color" : "Red" // product attributes (optional)
    "$extra" : {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  },
  "time" : 1387302423
}

Commande Traitée

// 
// FULFILLED ORDER
// ------------------------------------------

{
  "token" : "PUBLIC_API_KEY",
  "service" : "magento",
  "event" : "Fulfilled Order",
  "customer_properties" : {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
  "properties" : {
    "$event_id" : "1234",
    "$value" : 29.98,
    "$extra" : {},
    "Currency Code" : "USD",
    "Item Count" : 2,
    "Items" : ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "Discounted" : true,
    "Coupon" : "COUPON123",
    "Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
    "Item Categories" : ["Fiction", "Classics", "Children"],
    "Unique Item Categories" : ["Fiction", "Classics", "Children"]
  },
  "time" : 1387302423
}