Importateur de produits CSV

Importez un catalogue produit, ou toute autre table de référence, depuis un fichier dans un Data Store.

Si vous souhaitez importer un catalogue de produits dans notre CDP, consultez la page d'importation des fichiers de catalogue de produits .

À quoi ça sert

Vos événements contiennent un product_id, mais pas la marge, le prix ou la catégorie. Ces informations se trouvent dans votre back office. Importez ce catalogue sous forme de fichier, puis utilisez un enrichissement pour rattacher les attributs manquants à vos événements avant qu'ils n'atteignent vos destinations.

Il en va de même pour toute table de référence qui n'est pas rattachée à un visiteur : liste de magasins, liste de prix, table de correspondance.

Cette source ne remplit que le Data Store. Rattacher les données à vos événements est une étape distincte, configurée dans Enrichments. Tous les types d'enrichissement peuvent lire depuis le Data Store.

Cet importeur CSV est à ne pas confondre avec le CSV Conversions Importer, qui importe des achat événements rattachés à un visiteur.

Avant de commencer

• Un fichier CSV avec une ligne d'en-tête, une ligne par élément et une colonne qui identifie de manière unique chaque ligne (par exemple product_id).

• une connexion FTP configurée dans les identifiants du connecteur.

• L'autorisation de créer des Data Stores, si vous souhaitez en créer un pendant la configuration plutôt que réutiliser un Data Store existant.

Configuration

Sources > Catalogue des Sources > Import de fichiers > Importeur CSV de produits.

1. Paramètres

Nom et environnement.

2. Paramètres du fichier

Le fichier d'exemple que vous fournissez ici n'est utilisé que pour générer le mapping. Ses lignes ne sont pas importées, le fichier n'est pas conservé, et le déposer ne compte pas comme un import. Un court extrait avec les bons en-têtes suffit.

3. Data Store

Choisissez le Data Store qui recevra vos données, ou créez-en un ici. Seuls les Data Stores sans périmètre utilisateur sont listés : cette source importe des données de référence, pas des données de visiteurs. Voir Data Stores. Rien n'est enregistré avant la dernière étape. Un Data Store créé ici n'existe nulle part tant que vous n'avez pas enregistré la source.

4. Champs

Déclarez ce qui est stocké : le nom du champ à gauche, la colonne de votre fichier qui l'alimente à droite. Un champ doit être la clé de correspondance. C'est ce qui fait de chaque import une mise à jour plutôt qu'un doublon : une ligne dont la clé existe déjà écrase cet enregistrement, une nouvelle clé en crée un. Les enregistrements absents du fichier ne sont pas modifiés — importer un fichier plus court ne supprime rien.

Si vous réutilisez un Data Store existant, les champs sont préremplis en faisant correspondre les noms de vos colonnes avec ceux déjà déclarés. Vérifiez-les avant d'activer : il s'agit d'une correspondance de noms, pas d'un contrôle du contenu. La clé de correspondance et les types de champs proviennent du Data Store et ne peuvent pas être modifiés depuis la source ; saisir un nouveau nom de champ l'ajoute au Data Store.

Les fichiers suivants sont lus avec cette même configuration : la question n'est pas reposée à chaque import. Vous pouvez l'ajuster ensuite depuis l'onglet Champs de la source, par exemple pour changer la colonne qui alimente un champ.

5. Récupération du fichier

Où le fichier est récupéré, et quand.

• Exécuter une seule fois — un import unique.

• Exécuter périodiquement — selon un calendrier récurrent, éventuellement limité à une date de début et une date de fin. Faites correspondre la fréquence à la fréquence réelle des changements de votre catalogue.

Activer la suppression du fichier après traitement supprime le fichier du FTP une fois lu. Utilisez-le si votre système dépose un nouveau fichier à chaque fois ; laissez-le désactivé si le même fichier est écrasé sur place. Définissez les adresses d'alerte dans Notifications: un import échoué reste sinon silencieux jusqu'à ce que quelqu'un remarque l'absence de données en aval.

Ce qui se passe à chaque import

Situation	Résultat
Ligne sans valeur dans la colonne de clé	Ligne ignorée, l'import continue
Même clé deux fois dans un même fichier	La dernière ligne l'emporte
Ligne mal formée	L'import s'arrête là ; les lignes déjà écrites restent écrites

Vérifier que cela fonctionne

Le contenu d'un Data Store ne peut pas être parcouru enregistrement par enregistrement. Deux points à vérifier :

• la colonne Enregistrements (24h) dans la liste des Data Stores, qui montre ce qui est arrivé au cours des 24 dernières heures ;

• le Live Event Inspector, qui montre si un événement en direct a bien été enrichi. C'est le vrai test.

Si un événement arrive sans les attributs attendus, trois causes sont possibles et méritent d'être distinguées : l'import ne s'est pas exécuté, la valeur de la clé sur l'événement n'existe pas dans votre catalogue, ou l'enrichissement n'est pas configuré pour ajouter ce champ.

Limitations

• Une clé de correspondance par Data Store, modifiable depuis le Data Store lui-même, jamais depuis la source. Pour faire la correspondance sur une deuxième clé, utilisez un deuxième Data Store.

• Modifier la clé de correspondance d'un Data Store qui contient déjà des enregistrements crée un ensemble dupliqué au prochain import : les enregistrements existants ne sont pas réindexés. Créez plutôt un nouveau Data Store.

• Les enregistrements ne peuvent pas être consultés, modifiés ou supprimés individuellement.

• Mise à jour uniquement : remplacer tout le catalogue ou ajouter sans mettre à jour n'est pas disponible.

• Les enregistrements n'expirent jamais. Une entrée obsolète reste en place jusqu'à ce qu'un import ultérieur l'écrase.

• La suppression du Data Store ne supprime pas la source, mais la source n'a alors plus de cible et doit être reconnectée avant de produire quoi que ce soit.