Introduction
Les données produits sont le fondement de vos listes de vente. Vendably vous offre deux méthodes pour les importer : une connexion directe à votre plateforme de commerce électronique existante, ou l'importation d'un fichier structuré. Chaque approche a ses avantages. Une connexion directe synchronise vos données en temps réel, tandis qu'un import de fichier vous donne plus de contrôle sur la transformation des données avant leur chargement.
Cet article explique comment mettre en place chaque méthode, comment le mappage de champs fonctionne, et ce qu'il faut vérifier pour garantir que vos données arrivent correctement dans Vendably.
Où accéder à l'importation de données
Tous les outils d'importation se trouvent dans DataHub, sous la section Sources. C'est ici que vous créez une nouvelle connexion ou lancez un import de fichier. Une source reste active et peut être relancée à tout moment, tandis qu'un import unique charge les données une seule fois.
Deux approches : connexion directe ou fichier
| Approche | Plateforme supportée | Synchronisation | Fréquence | Idéal pour |
|---|---|---|---|---|
| Connexion OAuth | Shopify, WooCommerce, BigCommerce | Webhooks temps réel | Automatique | Synchronisation continue, stock et prix en direct |
| Import fichier | Toute source | Manuel ou FTP planifié | À la demande ou calendrier | Migration unique, données externes, contrôle personnalisé |
Connexion directe via OAuth
Si vous utilisez Shopify, WooCommerce ou BigCommerce, vous pouvez connecter votre plateforme directement à Vendably. Cette connexion utilise OAuth, un protocole sécurisé qui vous permet d'autoriser Vendably à accéder à vos données sans partager vos identifiants.
Une fois connectée, votre plateforme envoie des mises à jour en temps réel à Vendably via des webhooks. Cela signifie que si vous modifiez un prix, ajoutez un nouveau produit ou mettez à jour un stock sur votre plateforme, Vendably reçoit automatiquement ces changements sans intervention manuelle. Vous n'avez pas besoin de relancer un import tous les jours.
Au moment de la connexion, Vendably détecte automatiquement les champs de votre plateforme et les mappe sur son schéma standard. Cependant, si votre plateforme utilise des noms ou des structures inhabituels, vous pouvez ajuster ce mappage manuellement pour vous assurer que chaque champ est correctement interprété.
Import de fichier
Si vous n'utilisez pas une plateforme supportée, ou si vous devez charger des données provenant d'une source externe (fournisseur, système ERP, fichier de migration), vous pouvez importer un fichier. Vendably accepte les formats CSV, XML et JSON.
Vous avez deux options : charger le fichier manuellement via l'interface Vendably, ou configurer un pull FTP planifié. Le pull FTP récupère automatiquement un fichier depuis votre serveur FTP selon un calendrier que vous définissez (par exemple, chaque nuit à 2 heures du matin). Cela vous permet d'automatiser l'import sans connexion directe à votre plateforme.
Mappage de champs : traduire vos données
Que vous utilisiez une connexion directe ou un fichier, vos données source doivent être traduites en champs Vendably standard. C'est le mappage de champs.
Vendably propose une détection automatique : elle examine vos données source et essaie de deviner quel champ source correspond à quel champ Vendably (par exemple, 'SKU' vers 'sku', 'Product Title' vers 'title'). Dans la plupart des cas, cela fonctionne bien.
Cependant, si votre source utilise des noms non standard ou des structures imprévues, vous devez ajuster le mappage manuellement. Par exemple, si votre fichier appelle le titre 'Product Name' au lieu de 'Title', vous devez indiquer à Vendably que 'Product Name' doit être mappé sur le champ 'title'. Vous pouvez aussi laisser certains champs source non mappés s'ils ne correspondent à rien dans Vendably.
Le mappage est visible et modifiable dans l'interface de configuration de la source. Prenez le temps de vérifier qu'il est correct avant de finaliser l'import, car un mappage incorrect entraîne des données mal placées ou manquantes.
Étapes du pipeline d'importation
Une fois que vous lancez un import (manuel ou planifié), Vendably exécute une série d'étapes pour traiter vos données. Comprendre ce pipeline vous aide à diagnostiquer les problèmes.
1. Récupération (Fetch)
Vendably récupère vos données : soit depuis votre plateforme connectée (via API), soit depuis le fichier que vous avez fourni (upload ou pull FTP).
2. Import initial
Les données sont parsées et structurées selon le mappage de champs que vous avez défini. Chaque enregistrement est validé par rapport aux règles de base (champs obligatoires présents, types de données corrects).
3. Post-traitement
Vendably applique des transformations : normalisation des formats (par exemple, uniformiser les codes couleur), enrichissement des données si vous avez fourni des règles, suppression des doublons.
4. Analyse
Vendably examine les données importées pour détecter les problèmes : champs vides importants, valeurs invalides, incohérences. Un rapport d'analyse est généré et vous est présenté.
5. Application des overlays supplémentaires
Si vous avez configuré des overlays (par exemple, des données supplémentaires provenant d'une autre source ou d'une bibliothèque de contenu), elles sont fusionnées avec les données importées.
6. Finalisation
Les données validées et enrichies sont écrites dans la base de données Vendably. Elles deviennent alors disponibles dans le Product Hub et prêtes à être exportées vers vos canaux de vente.
Permissions et rôles
L'accès à l'importation de données dépend de votre rôle dans Vendably :
| Rôle | Créer/modifier source | Lancer import manuel | Consulter données importées |
|---|---|---|---|
| Owner | Oui | Oui | Oui |
| Admin | Oui | Oui | Oui |
| Editor | Non | Oui | Oui |
| Viewer | Non | Non | Oui |
Cela signifie que seuls les propriétaires et administrateurs peuvent configurer une nouvelle source ou modifier le mappage de champs. Les éditeurs peuvent déclencher un import manuel (par exemple, charger un nouveau fichier), mais pas modifier la configuration. Les lecteurs peuvent consulter les données mais ne peuvent rien modifier.
Configuration d'une connexion directe
Pour connecter une plateforme supportée :
- Allez dans DataHub > Sources.
- Cliquez sur Ajouter une source et sélectionnez votre plateforme (Shopify, WooCommerce ou BigCommerce).
- Vous êtes redirigé vers l'écran d'authentification de votre plateforme. Connectez-vous et autorisez Vendably à accéder à vos données.
- Une fois autorisé, Vendably détecte automatiquement vos produits et leurs champs.
- Examinez le mappage de champs proposé. Ajustez-le si nécessaire.
- Confirmez la configuration. Vendably lance un import initial de tous vos produits.
- Les webhooks sont activés. À partir de maintenant, tout changement sur votre plateforme (prix, stock, nouveau produit) est envoyé à Vendably en temps réel.
Configuration d'un import de fichier
Pour importer un fichier unique :
- Allez dans DataHub > Sources.
- Cliquez sur Importer un fichier.
- Sélectionnez le format (CSV, XML ou JSON) et téléchargez votre fichier.
- Vendably analyse le fichier et propose un mappage automatique.
- Vérifiez et ajustez le mappage si nécessaire.
- Cliquez sur Importer. Vendably traite le fichier selon le pipeline décrit plus haut.
- Un rapport de résultat vous montre combien de produits ont été importés avec succès, et signale les erreurs ou avertissements.
Pour configurer un pull FTP planifié :
- Allez dans DataHub > Sources.
- Cliquez sur Ajouter une source et sélectionnez FTP planifié.
- Entrez vos paramètres FTP (hôte, port, identifiants, chemin du fichier).
- Définissez un calendrier (par exemple, chaque jour à 02:00 UTC).
- Configurez le mappage de champs pour le fichier que vous allez placer sur le serveur FTP.
- Confirmez. Vendably se connecte au serveur FTP selon le calendrier et tire automatiquement le fichier.
Vérifier que l'import a réussi
Après un import, vérifiez que vos données sont correctes :
- Consultez le rapport d'import. Il indique le nombre de produits importés, les erreurs rencontrées et les avertissements. Corrigez tout problème signalé.
- Allez dans le Product Hub. Vérifiez que vos produits apparaissent avec les bons titres, descriptions, prix et images.
- Vérifiez un échantillon de produits en détail. Assurez-vous que chaque champ est rempli correctement et que rien n'a été mal mappé.
- Testez une export vers un canal. Si possible, exportez quelques produits vers l'un de vos canaux de vente et vérifiez qu'ils apparaissent correctement.
Si vous découvrez un problème de mappage après l'import, vous pouvez corriger le mappage de la source et relancer l'import. Les données seront mises à jour.
Gestion des mises à jour continues
Si vous utilisez une connexion directe, vos données sont mises à jour en temps réel via les webhooks. Vous ne devez rien faire. Cependant, vous pouvez toujours déclencher un import manuel complet si vous soupçonnez que certaines données n'ont pas été synchronisées.
Si vous utilisez un fichier ou un pull FTP, vous devez relancer l'import chaque fois que vous avez de nouvelles données. Pour un pull FTP planifié, cela se fait automatiquement selon votre calendrier. Pour un fichier manuel, vous devez télécharger le nouveau fichier et cliquer sur importer.
Considérations pour la qualité des données
L'import est une étape clé, mais ce n'est que le début. Une fois vos données dans Vendably, vous pouvez les enrichir et les transformer davantage :
- Utilisez la La bibliothèque de contenu et la génération de contenu par IA pour ajouter des descriptions ou des attributs manquants.
- Configurez des Règles de flux : filtrage et transformation des produits à l'export pour transformer vos données avant de les envoyer vers vos canaux.
- Gérez vos images via le Hébergement d'images produit et conformité canal via le CDN pour garantir qu'elles répondent aux exigences de chaque canal.
Résumé
Importer vos données produits dans Vendably est simple : connectez votre plateforme pour une synchronisation automatique, ou chargez un fichier pour plus de contrôle. Dans les deux cas, le mappage de champs traduit vos données source en schéma Vendably. Une fois importées, vérifiez que vos données apparaissent correctement dans le Product Hub, puis utilisez les outils de Vendably pour les enrichir et les optimiser pour chaque canal de vente.
Le succès d'une importation dépend de trois éléments : une source correctement configurée, un mappage de champs exact, et une vérification minutieuse des données après l'import. Prenez le temps de bien faire ces trois étapes, et vos produits seront prêts à être distribués avec confiance.