ℹ️ | 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. En outre, Splio créera un enregistrement par défaut (vide) dans ce scope pour chaque valeur order_id trouvée lors d’un import de "panier abonné" qui n'existe pas dans la base de données.
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.
- La sous-séquence doit être définie dans le fichier de configuration dans le scope "abandonedcart".
- Un éditeur de texte compatible UTF-8.
- Un tableur.
- Un fichier pour réimporter toutes les "lignes de ticket" liés à chaque "order_id" que vous mettez à jour.
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
70x1bMhtt-1531745300;"misterspots@examplemail.org";Internet;2018-06-22 11:30:00;173.00;EUR
70x1byTRJ-1531778200;"lady@examplemail.org";Internet;2018-06-21 12:10:00;244.99;EUR
70xb1KLio-1531723300;"8sk5k7g87@examplemail.org";Internet;2018-06-20 17:33:00;25.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).
Explication : NULL et valeurs de suppression
NULL est une valeur spéciale qui dit à 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 une instruction à vider les champs. Pour ce faire, assurez-vous que la valeur est exactement “NULL”.
Si cette option n'est pas définie, Splio gardera les valeurs des champs pour lesquels la valeur importée est “NULL”.
Différence entre “NULL” et chaîne de caractères vide
"" est une chaîne de caractères vides. Dans la plupart des cas, les valeurs “NULL” et "" seront importés comme valeurs vides.
Mais la valeur "" n'est jamais considérée comme valeur NULL, et donc n'effacera jamais une valeur préexistante.