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.

🚧
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.

Veuillez limiter la taille de votre fichier à 200K lignes.

En-tête et colonnes

La première ligne du fichier, appelée en-tête, est utilisée pour déterminer le contenu des lignes suivantes. Elle doit donc être construite uniquement à partir des noms des colonnes.

🚧
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.
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. Voir la section “Dates” si dessous pour plus de détails sur le format. Pour éviter les erreur, complétez toujours les heures, minutes et secondes.
shipping_amount	Non	Décimal	Représente le montant de la commande dû comme paiement pour l'expédition d'une commande ayant le même contenu que le panier.
discount_amount	Non	Décimal	Le montant total de la remise appliquée au panier.
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 lié au panier.
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.

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";"[email protected]";"Internet";"2018-06-22 11:30:00;173.00";"EUR"
"70x1byTRJ-1531778200";"[email protected]";"Internet";"2018-06-21 12:10:00";"244.99";"EUR"
"70xb1KLio-1531723300";"[email protected]";"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.

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 2021, 13h37, prendra la forme suivante :

2021-03-15 13:37:00

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.

Lorsque vous importez des dates avec l'heure, 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.