Imports - Paniers abandonnés (abandoned carts)
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".
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 téléchargements 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 dossier 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.
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" :
- order_id - L'identifiant externe du panier abandonné importé ; cette colonne est obligatoire et doit être unique pour chaque enregistrement.
- customer_key - La colonne spéciale utilisée par Splio pour identifier les contacts dans la base de données ; cette colonne est obligatoire. Elle sera expliquée dans les exemples ci-dessous. Veuillez consulter l'article Imports - Contacts pour plus de détails.
- store_id - l'id externe du magasin où le panier était rempli ; crée une relation entre les «paniers abandonnés» et les «magasins». Cette colonne est obligatoire et doit contenir des références aux magasins précédemment importés.
- order_date - la date à laquelle le ticket a été passée ; cette colonne n'est pas obligatoire. Voir «dates» ci-dessous pour plus de détails sur le formatage.le ticket avait été finalisée.
- discount_amount - la remise totale appliquée au panier.
- tax_amount - le montant total de la taxe (TVA, taxe de vente) appliquée au panier abandonné.
- total_amount - la somme totale du panier.
- currency - le code à 3 lettres de la devise du panier abandonné ; s'applique à toutes les valeurs de montant. Si aucune devise n'est indiquée, Splio prendra la devise par défaut de l'univers.
- salesperson - le vendeur lié au ticket.
- Une ou plusieurs colonnes personnalisées, si définies pour des tickets dans votre univers Splio.
Notez que les noms de colonnes sont toujours en minuscules.
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
Chaque ligne se compose exactement de 6 colonnes. Le "order_id" est utilisé pour distinguer les paniers d'achat, le "customer_key" relie le ticket 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_2018027.csv
Ce nom de fichier appartient à l'univers "myunivers", sous-séquence "zoo" défini pour les paniers abandonnés, et est daté du 27 juin 2018.
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-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-03-07
est traité exactement comme si vous avez entré
2018-03-07 00:00:00
Informations avancées
Cette partie du document contient des informations supplémentaires qui complètent le guide ci-dessus et fournissent plus de détails.
Format de fichier
Nom de fichier |
|
<universe>_abandonedcarts_<name>_<date>(_<id>).csv |
Encodage |
|
UTF-8 |
Format |
|
CSV (no multiline) |
Séparateur de colonnes |
|
; (semicolon) |
Qualificateur de texte |
|
" (double quote, optional) |
Caractère d'échappement |
|
\ (backslash) |
Fin de ligne |
|
\n or \r\n |
Séparateur décimal |
|
. (dot) |
Format du champ de date |
|
yyyy-mm-dd HH:MM:SS or yyyy-mm-dd |
Si un champ de date dans le fichier n'est pas conforme au format ci-dessus, l'import ne sera pas traité.
Colonnes
Les sections ci-dessous décrivent les colonnes (champs) disponibles pour la construction ou la modification des fichiers de tickets.
/!\ N'oubliez pas que tous les noms de colonne sont sensibles à la casse. Pour cette raison, les noms par défaut sont tous en minuscules.
Colonne |
Obligatoire |
Type de données / longueur maximale |
Description |
order_id |
Oui (voir ci-dessus) |
Texte (max.50 caractères) |
L'identifiant externe du panier importé. |
customer_key |
Oui (voir ci-dessus) |
(Varie) |
Cette colonne fait référence à la clé client de la table des contacts. Son type correspond à celui de la colonne clé. |
store_id |
Oui |
Texte (max.50 caractères) |
Utilisé pour référencer l'ID externe du magasin où le panier a été enregistré. Splio créera un nouveau magasin s'il rencontre une valeur qu'il ne peut pas reconnaître. |
order_date |
Oui |
Date |
Date à laquelle le panier a été créé. Doit être conforme au format aaaa-mm-jj HH: MM: SS ou aaaa-mm-jj (si la partie horaire est omise, 00:00:00 sera utilisée). |
shipping_amount |
Non |
Décimal, "." (point) comme séparateur décimal |
Le montant égal au coût d'expédition du panier si la commande avait été finalisée. |
discount_amount |
Non |
Décimal, "." (point) comme séparateur décimal |
Le montant de la remise appliquée au panier. |
tax_amount |
Non |
Décimal, "." (point) comme séparateur décimal |
Le montant de la taxe appliquée au panier |
total_amount |
Non |
Décimal, "." (point) comme séparateur décimal |
La somme totale de tous les articles dans le panier plus les frais d'expédition moins la remise. |
currency |
Non |
Texte (max.3 caractères) |
La devise utilisée. |
salesperson |
Non |
Texte (max.120 caractères) |
Le vendeur est lié au ticket. |
<custom> |
Non |
Texte (max.255 caractères) |
Voir ci-dessous |
La fonction d'import de Splio permet d'utiliser des champs personnalisés qui ont été configurés dans votre univers. Pour inclure un champ personnalisé dans l'en-tête, utilisez le nom technique du champ (lettre minuscule "c" suivie de son identifiant numérique).
Par exemple, si vous avez un champ appelé "promo" dans votre table "tickets" et que son identifiant est 5, vous devez utiliser "c5" comme nom de la colonne. Vous pouvez inclure autant de champs (colonnes) personnalisés dans vos fichiers d'import que définis pour le scope donné dans votre univers Splio. Chaque nom de colonne ne doit être utilisé qu'une seule fois.
Gardez également à l'esprit que si Splio ne peut pas reconnaître le nom d'une colonne, il n'importera pas le fichier.
Surveillance
Les informations suivantes sont mises à disposition par Splio après l'import.
- Le nombre de lignes OK et KO
- Le nombre de lignes créées et mises à jour (la somme sera les lignes OK)
Mais les données ne sont pas disponibles si :
- L'import est abandonné ou n'est pas traité
- La raison pour laquelle une ligne a été sautée
Lorsqu'il est présent dans le dossier imports /, où vous téléchargez le fichier .csv à importer, vous devez aller dans les journaux / dossier pour trouver les journaux des imports. De même, les fichiers importés se trouvent dans / imports / archives /.