Objectif

La plupart de nos expériences nécessite deux types de fichiers : les analytics au cours des X derniers mois et le catalogue le plus à jour possible. Le nombre de mois nécessaires, noté X, est déterminé en fonction des sites.

Bien souvent ces fichiers sont récupérés directement de Google Analytics pour les transactions et le CMS ou un flux Google Shopping pour le catalogue.

Si l'un de ces accès n'est pas disponible, il est possible de déposer ces fichiers de transactions et/ou de catalogues dans un SFTP.

Mise en place

Chaque client se voit attribuer un USERNAME et un PWD afin d'accéder au SFTP.

Sur le SFTP se trouvent deux dossiers, un dossier Transactions et un dossier Catalog

Dans le dossier Transactions, Potions s'attend à des fichiers de transactions mensualisées comme Transactions_2021_06.csv

Dans le dossier Catalog, Potions s'attend à un seul fichier contenant le catalogue de produits dans le format défini ensemble.

Voici comment fonctionne la récupération.

Potions vérifie tous les jours les nouveaux ajouts de données sur le SFTP.

Si un nouveau fichier a été déposé dans l'un ou l'autre des dossiers, l'ensemble des recommandations sont calculées. Potions prend alors les X fichiers de transactions (normalement mensualisés) déposés en dernier et le fichier catalog déposé en dernier.

En fonctionnant avec les dates de dépôts, et non les noms des fichiers, Potions permet à ses clients d'augmenter la fréquence des dépôts s'ils le souhaitent, oublier de cleaner le SFTP, ne pas déposer le jour même...

Potions se charge également de dédupliquer les transactions en cas d'erreur (overlap des fichiers de transactions), de vérifier que le fichier catalogue n'est pas vide et obéit au bon format, etc... Et nous vous préviendrons si nous détectons trop d'erreurs à chaque récupération.

Le format et contenu des fichiers

Nous sommes très flexibles sur les formats (csv, xml...).

En ce qui concerne le contenu,

le fichier transaction doit contenir un id de transaction ainsi que les sku contenu dans la transaction et la date de la transaction

le fichier catalogue doit contenir les skus et l'ensemble des attributs nécessaires au calcul des recommandations

Exemples : la catégorie, si vous souhaitez un top-sell par catégorie, une remise si vous souhaitez ordonner les recommandations par remise décroissante, etc.

Ajout des fichiers de transactions et de catalogue

Avec Filezilla

Lien de téléchargement : https://filezilla-project.org/

Hôte : sftp.get-potions.com

Identifiant : USERNAME

Mot de passe : PWD

Port : 22

Appuyez sur "Connexion rapide" puis acceptez d'ajouter l'hôte si c'est votre première connexion

Vous pouvez ensuite ajouter vos fichiers directement comme dans un explorateur de fichiers standard

Avec la commande `sftp`

Faites cette commande dans le dossier où se trouve les fichiers que vous souhaitez ajouter pour vous connecter :

sftp USERNAME@sftp.get-potions.com

Entrez votre mot de passe PWD

Ajoutez les fichiers avec cette commande :

put FILENAME

Vous pouvez vérifier que le fichier a bien été ajouté avec ls

Vous pouvez quitter avec exit

Dépôt sur SFTP Potions