Référence de données Magento 1

Vous apprendrez

Découvrez quelles données de Magento 1 sont importées dans Klaviyo lorsque vous intégrez les deux plateformes. L'intégration de Klaviyo avec Magento permet de récupérer toutes les données historiques de votre boutique Magento au moment de la synchronisation historique initiale. Une fois activée, l'intégration commencera à 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 sont celles synchronisées à partir de votre intégration Magento.

Métriques 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 - remises éventuelles).
• Articles: Les noms des produits dans la commande d'une personne.
  ex : t-shirt ou pantalon. Si vous commandez plusieurs fois, vous obtiendrez plusieurs exemplaires du même article.
• Catégories d'articles: L'ensemble complet des catégories d'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 devise: La devise spécifique payée pour un article en fonction du pays (par exemple, USD, EUR).
• Réduit: Si une remise est appliquée à cet article spécifique (c'est-à-dire vrai/faux).
• Coupon: Le code du coupon appliqué.
• Articles uniques: L'article individuel inclus dans une commande (par exemple, 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 d'articles uniques sont regroupées (par exemple, hommes, soldes).
• Attributs (facultatif): Attributs personnalisés du produit.

Checkout terminé

Cet événement est suivi lorsqu'un client passe à la caisse dans votre boutique Magento. L'événement Checkout Completed n'est pas synchronisé historiquement, et n'est donc pas toujours une mesure précise lorsque vous regardez les totaux d'événements au fil du temps. Pour le suivi des recettes et la segmentation, utilisez l'événement Commande passée.

Vous pouvez filtrer et cibler les événements "Checkout Completed" en fonction des critères suivants :

• Valeur : La valeur totale de la commande. 
• Codes de réduction: Tout coupon ou code de réduction appliqué.
• Articles: Les noms des produits dans le panier d'une personne (par exemple, un t-shirt ou un pantalon).
• Nombre d'articles: Le nombre total d'articles dans le panier d'une personne.
• Total des réductions (facultatif) : Valeur totale en dollars des coupons ou des remises.

Checkout démarré

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 paiement de Magento et qu'il clique ensuite sur Continuer. Klaviyo suit les données relatives aux articles du panier d'une personne, y compris les noms de produits, les images et les informations sur les variantes, que vous pouvez utiliser dans vos e-mails sur les paniers abandonnés. Cet événement possède une propriété "checkout URL" qui renvoie au panier exact de chaque client et qui peut être utilisée pour reconstituer le panier si un client ouvre l'e-mail à partir d'un nouvel appareil.

Vous pouvez filtrer et cibler les événements "Checkout Started" en fonction des critères suivants :

• Valeur: La valeur du panier au moment du paiement (sous-total + frais d'expédition - remises éventuelles).
• Articles: Les noms des produits dans le panier d'une personne (par exemple, un t-shirt ou un pantalon).
• Nombre d'articles: Le nombre total d'articles dans le panier d'une personne.
• Codes de réduction (facultatif): Tout coupon ou code de réduction appliqué.
• Total des réductions (facultatif) : Valeur totale en dollars des coupons ou des remises.

Commande exécuté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 de commande exécutée en fonction des critères suivants :

• Valeur: Valeur totale de la commande (sous-total + frais d'expédition - remises éventuelles).
• Articles: Les noms des produits contenus dans la commande d'une personne (par exemple, un t-shirt ou un pantalon). Si vous commandez plusieurs fois, des multiples du même article apparaîtront. 
• Catégories d'articles: L'ensemble complet des catégories d'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 devise: La devise spécifique payée pour un article en fonction du pays (par exemple, USD, EUR).
• Réduit: Si une remise est appliquée à cet article spécifique (c'est-à-dire vrai/faux).
• Coupon: Le code du coupon appliqué.
• Articles uniques : Si plusieurs produits sont commandés, l'article unique ne s'affichera qu'uneseule fois.
• Catégories d'articles uniques: Les catégories d'articles uniques sont regroupées (par exemple, hommes, soldes).
• Attributs (facultatif): Attributs personnalisés du produit.

Produit commandé

Cet événement est suivi lorsqu'un client passe sa commande. Un événement Produit commandé est suivi pour chaque article acheté par une personne. Par exemple, si quelqu'un achète un t-shirt et un pantalon, un événement "Commande passée" est suivi et deux événements "Produit commandé" sont enregistrés - un événement pour le t-shirt et un événement pour le pantalon.

L'événement Produit commandé contient des informations détaillées sur chaque produit acheté par une personne. Ceci est utile pour créer des segments comportementaux basés sur des options de variantes de produits et d'autres informations détaillées qui ne sont pas disponibles dans l'événement Commande passée. Vous pouvez filtrer et cibler les événements relatifs aux produits commandés en fonction des critères suivants :

• Valeur: Prix total de l'article (ne comprend pas les frais d'expédition ni les réductions éventuelles).
• Nom: Le nom donné à cet élément spécifique.
• SKU: L'UGS spécifique attribuée au suivi d'un article (par exemple, REDMEDIUMTSHIRT).
• Catégories: L'ensemble complet des collections de produits dans la commande d'une personne (par exemple, 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 exemple, chemises 13,85, chaussures 20,00).
• Code devise: La devise spécifique payée pour un article en fonction du pays (par exemple, USD, EUR). 
• Réduit: Si l'article en question bénéficie d'une remise (vrai ou faux).
• ProductID: ID d'un produit spécifique dans votre magasin.
• Quantité : Quantité commandée.
• Attributs (facultatif): Attributs personnalisés du produit.

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 :

• Valeur: Valeur totale de la commande (sous-total + frais de port - remises éventuelles).
• Articles: Les noms des produits dans la commande d'une personne, par exemple : t-shirt ou pantalon. Si vous commandez plusieurs fois, vous obtiendrez plusieurs exemplaires du même article. 
• Catégories d'articles: L' ensemble complet des catégories d'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 devise: La devise spécifique payée pour un article en fonction du pays (par exemple, USD, EUR).
• Réduit: Si une remise est appliquée à cet article spécifique (c'est-à-dire vrai/faux).
• Coupon: Le code du coupon appliqué.
• 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.
• Catégories d'articles uniques: Les catégories dans lesquelles sont regroupés les articles uniques (par exemple, hommes, soldes).
• Attributs (facultatif): Jusqu'à 10 attributs de produits personnalisés peuvent être synchronisés pour les commandes passées. Cette synchronisation doit être activée avant que les données des attributs personnalisés ne soient transférées dans votre compte Klaviyo. Reportez-vous à la section ci-dessous pour savoir comment procéder.

Ordre remboursé

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

• Valeur: Valeur totale de la commande (sous-total + frais de port - remises éventuelles).
• Coupon: Le code du coupon appliqué.
• Code devise: La devise spécifique payée pour un article en fonction du pays (par exemple, USD, EUR).
• Réduit: Si cet article spécifique a fait l'objet d'une remise (vrai/faux).
• Catégories d'articles: L' ensemble complet des catégories d'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).
• Articles: Les noms des produits contenus dans la commande d'une personne (par exemple, un t-shirt ou un pantalon). Si vous commandez plusieurs fois, vous obtiendrez plusieurs exemplaires du même article.
• Catégories d'articles uniques: Les catégories d'articles uniques sont regroupées (par exemple, hommes, soldes).
• Articles uniques: L'article individuel créé dans une commande, ex : chemises, shorts .Si plusieurs produits sont commandés, l'article unique ne s'affichera qu'une seule fois.

Les recettes, ou la valeur des commandes passées, sont calculées comme suit : (prix des commandes + frais d'expédition - remises). Pour filtrer un segment sur la base de la valeur $, filtrez le segment à l'aide de Revenu.

Le paiement est disponible en tant que propriété de second niveau dans le champ extra. Vous ne pouvez pas filtrer les propriétés de second 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'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, 2015-05-01 00:00:00)
• Groupe de clients Magento (par exemple, grossistes)
• Magento Store (par exemple, US Store)
• Date de naissance (par exemple, 1990-01-01)
• Genre
• L'identifiant du site web 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 si le profil original a été créé dans Klaviyo, le groupe de clients sera mis à jour dans Klaviyo.

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

Klaviyo peut synchroniser jusqu'à 10 attributs de produit personnalisés pour la mesure de la commande passée. Les attributs de produits personnalisés ne seront pas automatiquement intégrés dans Klaviyo ; toutefois, vous pouvez demander à Klaviyo de les intégrer. Pour ce faire, vous devez collecter l'identifiant de l'attribut personnalisé (instructions ci-dessous) et envoyer une demande à notre équipe d'assistance.

Trouvez les Custom Product IDs dans le panneau d'administration de Magento en allant sur Catalog > Attributes > Manage Attributes et en cliquant sur l'attribut.

L'ID peut être trouvé dans l'url comme suit : 

Vérifiez les données de vos commandes 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 ce qui figure dans l'interface de Magento 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 le réglage de votre fuseau horaire :

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

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

// 
// Commande passée
// ------------------------------------------

{
 " token": "PUBLIC_API_KEY",
 " service": "magento",
 " event": "Commande passée",
 " 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"], // Si un article est commandé plus d'une fois, dupliquez-le. Par exemple, si quelqu'un commande deux t-shirts, voici ce que cela donnerait : ["T-Shirt", "T-Shirt"]
 " Remise": true,
 " Coupon": "COUPON123",
 " Articles uniques": ["Winnie l'ourson", "Un conte de deux villes"],
 " Catégories d'articles": ["Fiction", "Classiques", "Enfants"],
 " Catégories d'articles uniques": ["Fiction", "Classiques", "Enfants"]
 }, "time": 1387302423
}

// 
// PRODUIT COMMANDÉ
// ------------------------------------------

{
 " token": "PUBLIC_API_KEY",
 " service": "magento",
 " event": "Produit commandé",
 " 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",
 " Nom: "Winnie l'ourson",
 " SKU": "WINNIEPOOH",
 " ProductID": "567",
 " Catégories": ["Fiction", "Classics"],
 " Prix": 9.99,
 " Discounted": true,
 " Cost": 5.00, // (optionnel),
 " Attribut : Couleur": "Rouge" // attributs du produit (facultatif)
 " $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
}

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

{
 " token": "PUBLIC_API_KEY",
 " service": "magento",
 " event": "Commande exécutée",
 " 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"], // Si un article est commandé plus d'une fois, dupliquez-le. Par exemple, si quelqu'un commande deux t-shirts, voici ce que cela donnerait : ["T-Shirt", "T-Shirt"]
 " Remise": true,
 " Coupon": "COUPON123",
 " Articles uniques": ["Winnie l'ourson", "Un conte de deux villes"],
 " Catégories d'articles": ["Fiction", "Classiques", "Enfants"],
 " Catégories d'articles uniques": ["Fiction", "Classiques", "Enfants"]
 }, "time": 1387302423
}

Ressources complémentaires

• Comment s'intégrer à Magento 1.x (CE et EE)
• Référence des exigences du système d'intégration Magento