Cet article explique comment préparer un fichier pour le scope “paniers abandonnés".
Les fichiers du scope "paniers abandonnés" sont très similaires aux fichiers "tickets", car les paniers abandonnés représentent des tickets qui n'ont jamais été validés. De plus, comme dans le cas des tickets, s'il y a des articles dans les paniers abandonnés, vous devrez les importer en tant que "tickets". “ordersitems”.
Les données des paniers abandonnés sont généralement collectées par le magasins en ligne, qui doivent stocker les sélections des clients dans des paniers et peuvent facilement identifier les paniers qui n'ont jamais été finalisés.
Les données dans la table paniers abandonnés peuvent être mises à jour avec des imports ultérieurs. Splio rejettera les objets "orderitems" qui sont liés à un "order" qui n'existe pas encore dans la base de données.
Vous trouverez un exemple de fichier pour ce scope à la fin de l'article.
Sachez que Splio commence à traiter les imports du scope "panier abandonné" en supprimant d'abord toutes les "lignes de tickets" pour chaque "ID de ticket" trouvé dans le fichier d'import.
Pré-requis
- Connaissance de base du format CSV et du codage UTF-8.
- Un éditeur de texte compatible UTF-8.
- Un tableur.
- La sous-séquence doit être définie dans le fichier de configuration dans le scope "abandonedcarts".
Préparation d'un fichier de paniers abandonnés
Modifiez le fichier d'import avec votre éditeur de texte compatible UTF-8 préféré. Si nécessaire, utilisez un tableur avec lequel vous êtes à l'aise pour contrôler le nombre et la position des colonnes.
💡 | N'oubliez pas de sauvegarder en utilisant l'encodage UTF-8 sans BOM.
En-tête et colonnes
La première ligne du fichier est appelée en-tête. L'en-tête ne doit contenir que les noms des colonnes utilisées dans les lignes suivantes.
⚠️ | Si Splio rencontre un nom de colonne qu'il ne peut pas reconnaître, il n'importera pas le fichier.
Les colonnes suivantes sont disponibles dans la table "paniers abandonnés" :
|
Colonne |
Obligatoire |
Type de champ / Maximum length |
Description |
|
order_id |
Oui |
Texte (max. 50 caractères) |
L'ID externe du panier abandonné. Cette valeur doit être unique pour chaque panier. |
|
customer_key |
Oui |
Texte |
Colonne spécifique utilisée par Splio pour identifier les contacts dans la base. |
|
card_code |
Non |
Texte |
Code d'une carte Loyalty, qui créée un lien entre le panier abandonné et la carte loyalty. Voir la section “tickets Loyalty” dans Imports - tickets (orders) pour plus de détails. |
|
store_id |
Oui |
Texte (max. 50 caractères) |
ID externe du magasin où le panier a été abandonné, lie les “abandonedcarts” aux “stores”. Les valeurs dans cette colonne doivent être sur des magasins existants dans la base. |
|
order_date |
Non |
Date |
Date associée au panier. ⚠️ | Pour éviter les erreur, complétez toujours les heures, minutes et secondes. |
|
shipping_amount |
Non |
Décimal |
Le montant de la livraison. |
|
discount_amount |
Non |
Décimal |
Le montant de la remise. |
|
tax_amount |
Non |
Décimal |
Le total des taxes (comme la TVA) appliquée au panier. |
|
total_amount |
Non |
Décimal |
Le total du montant (et de la livraison), sans la remise. |
|
currency |
Non |
Texte (max. 3 caractères) |
Le code à 3 lettres de la devise du panier; s'applique à tous les montants. Si aucune devise n'est précisée, Splio prendra la devise par défaut de l'univers. |
|
salesperson |
Non |
Texte (max. 120 caractères) |
Le vendeur. |
|
c0 |
Non |
|
Une colonne personnalisée définie dans votre univers pour les tickets. Vous pouvez en inclure jusqu'à 32, de “c0” à “c31”. |
📗 | Notez que les noms de colonnes sont toujours en minuscules.
💡 | La colonne customer_key identifie les contacts dans votre univers Splio. Voir notre article Imports - Contacts pour en savoir plus.
⚠️ | Rappelez-vous que Splio vérifie que les fichiers d'import contiennent les colonnes obligatoires. Vous devez inclure “order_id”, “customer_key”, et “store_id” pour que l'import réussisse.
Exemple 1 : clé client par défaut
Les premières lignes d'un fichier d'import « panier abandonné » à l'aide de la clé client par défaut (e-mail du contact) peuvent ressembler à ceci :
order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bKkUt-1531738300";"PPL000000045732";"MGZOO";"2018-06-27 12:17:27";"225.00";"EUR"
"70x1bKooY-1531738300";"PPL000000007633";"MGZOO";"2018-06-27 12:19:23;17.00";"EUR"
"70x1bu9Gt-1531756600";"PPL000000045661";"MGZOO";"2018-06-27 12:22:07";"112.50";"EUR"
📗 | Chaque ligne se compose exactement de 6 colonnes. Le "order_id" est utilisé pour distinguer les paniers d'achat, le "customer_key" relie le panier au contact qui a créé et abandonné le panier.
Exemple 2 : colonne personnalisée comme clé client
Comparez un fichier d'import en utilisant une colonne personnalisée comme clé client avec l'exemple 1 ci-dessus :
order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bKkUt-1531738300";"PPL000000045732";"MGZOO";"2018-06-27 12:17:27";"225.00";"EUR"
"70x1bKooY-1531738300";"PPL000000007633";"MGZOO";"2018-06-27 12:19:23;17.00";"EUR"
"70x1bu9Gt-1531756600";"PPL000000045661";"MGZOO";"2018-06-27 12:22:07";"112.50";"EUR"
📗 | Les deux imports sont très similaires, seul le type de valeurs dans la "customer_key" est différent. Vous devez toujours utiliser la clé client requise par votre univers Splio.
Nommez votre fichier
Pour enregistrer votre fichier, utilisez un nom composé du nom de l'univers, de la table («panier abandonné»), de la sous-séquence et de la date actuelle. Par exemple :
myuniverse_abandonedcarts_zoo_20210226.csv
Ce nom de fichier appartient à l'univers "myunivers", sous-séquence "zoo" défini pour les paniers abandonnés, et est daté du 26 février 2021.
Si vous voulez en savoir plus sur les convention de nommage, consultez Imports - Introduction.
Vous pouvez maintenant télécharger le fichier sur SFTP / FTPS.
Dates
Chaque date se compose de 4 chiffres pour un an, 2 pour un mois et 2 pour un jour, suivis des heures, des minutes et des secondes, de 2 chiffres chacun. Une date correcte pour le 15 mars 2018, 13h17, prendra la forme suivante :
2018-08-09 10:00:05
Le jour et l'heure sont séparés par un espace vide. Vous pouvez omettre la partie heure et utiliser uniquement la date. Si vous le faites, Splio considérera l'heure la plus tôt possible pour la journée (minuit). Donc,
2018-09-09
est traité exactement comme si vous aviez entré
2018-09-09 00:00:00
⚠️ | Il est obligatoire d'utiliser les heures, minutes et secondes pour les dates : 00:00:00 équivaut à minuit et Splio traitera chaque date sans heure comme ceci. Cela peut causer des erreurs et des triggers associés avec des dates échoueront. Toutes les données loyalty sont considérées comme des informations financières. Cela signifie que vous et votre marque êtes responsables de ces données et vous ne devez pas laisser de côté les détails.
📗 | Importer des dates avec des heures permet de surcroit de faire un ciblage beaucoup plus précis.
⚠️ | Utilisez toujours la même timezone pour les dates (c'est GMT+1 pour les clients en dehors de la Chine, et GMT+8 pour les clients chinois).
Explications : NULL et valeurs de suppression
NULL est une valeur spéciale qui indique à la base de données que le champ qui la contient est vide. Votre univers Splio peut être configuré pour interpréter les valeurs NULL comme des instructions pour vider les champs. Vous pouvez l'utiliser pour effacer les valeurs stockées dans la base de données. Pour ce faire, assurez-vous que la valeur importée est exactement NULL. Vous devez éviter les espaces de début ou de fin: "NULL " ou " NULL" seront reconnus comme des valeurs de chaîne. Si cette option n'est pas définie, Splio conservera les valeurs des champs où la valeur importée est NULL.
Différence entre NULL et une chaîne vide
"" est une chaîne vide. Dans la plupart des cas, NULL et "" seront importés en tant que valeur vide. Plus important encore, la chaîne vide "" n'est jamais considérée comme une valeur NULL, donc elle n'entraînera pas l'effacement d'une valeur existante.