L’importation de produits permet d’ajouter des articles à votre catalogue manuellement via l’outil d’importation, afin de les utiliser immédiatement dans vos stratégies.
Dans cet article, vous apprendrez comment effectuer une importation de produits dans Connectif.
Difficulté : Faible.
Quand l’utiliser ? : Lors de l’intégration de votre compte Connectif et à tout moment de manière ponctuelle.
Bien que l’étiquette "Le contact a consulté un produit" enregistre automatiquement les produits au fur et à mesure qu’ils sont consultés, il est recommandé d’effectuer une importation initiale de l’ensemble du catalogue lors de l’intégration à Connectif, afin qu’il soit disponible dès le départ.
Avant de commencer : préparation du fichier de produits
Pour effectuer l’importation, vous avez besoin d’un fichier CSV valide contenant les champs des produits à importer.
Le tableau suivant montre les champs pouvant être inclus dans le fichier CSV :
| Nom | Type | Description | Exemple |
|---|---|---|---|
| productDetailUrl | Texte | URL de la page du produit (l’URL ne doit pas être encodée). Cette valeur est obligatoire dans le document. | http://exple.com/productA |
| productId | Texte | Identifiant unique du produit (dans l’eCommerce). Cette valeur est obligatoire dans le document. | 101 |
| name | Texte | Nom du produit. Cette valeur est obligatoire dans le document. | Product A |
| unitPrice | Décimal | Prix unitaire du produit. Cette valeur est obligatoire dans le document. | 20.99 |
| imageUrl | Texte | URL de l’image du produit. | http://exple.com/images/productA.jpg |
| description | Texte | Description du produit. | Un gadget innovant pour les maisons modernes. |
| thumbnailUrl | Texte | URL de l’image miniature du produit. | http://expl.com/thumbs/productA.jpg |
| categories | Liste de textes |
La ou les catégories auxquelles appartient le produit. Pour indiquer plusieurs catégories, utilisez le caractère "|". Si l’eCommerce permet des sous-catégories, indiquez le chemin complet en séparant chaque niveau avec le caractère "/". Par exemple : "/Ordinateurs/Claviers/Logitech". |
electronics/home/gadgets| electronics/home/accessories |
| tags | Liste de textes | Les étiquettes associées au produit. Pour en indiquer plusieurs, utilisez le caractère "|". | innovative|gadget |
| brand | Texte | Marque du produit. | GadgetPro |
| ratingCount | Entier | Nombre d’avis que le produit a reçus. | 150 |
| rating | Décimal | Note moyenne reçue par le produit. | 4.5 |
| reviewCount | Entier | Nombre d’avis que le produit a reçus. | 75 |
| relatedExternalProductIds | Liste de textes | Identifiants des produits associés. Pour indiquer plusieurs produits, utilisez le caractère "|". | 200|201 |
| priority | Entier | Niveau de priorité ou de préférence de ce produit. La valeur par défaut est 0. | 5 |
| unitPriceOriginal | Décimal | Prix unitaire original du produit. | 25.99 |
| unitPriceWithoutVAT | Décimal | Prix unitaire hors taxes du produit. | 17.49 |
| discountedPercentage | Décimal | Pourcentage de réduction, compris entre 0 et 100 sans le symbole %. | 20 |
| discountedAmount | Décimal | Montant de la réduction appliquée au produit (doit correspondre à unit_price_original - unit_price). | 5.0 |
| publishedAt | Date | Date au format ISO8601 correspondant à la première apparition du produit dans le catalogue de la boutique. | 2021-03-15T00:00:00Z |
| inStockUnits | Entier | Nombre d’unités du produit en stock. | 120 |
| availability | Texte | Doit être défini sur instock ou outofstock. Indique si le produit est disponible ou non. | instock |
| isBlacklisted | Booléen | Doit être défini sur true ou false et permet (si défini sur true) d’exclure le produit des recommandations. Si non spécifié, la valeur par défaut est false lors de la création du produit. | false |
| customField1 | Texte | Propriété personnalisée. | CustomValueA1 |
| customField2 | Texte | Propriété personnalisée. | CustomValueA2 |
| customField3 | Texte | Propriété personnalisée. | CustomValueA3 |
Les noms du tableau doivent rester exactement les mêmes si l’importation des produits se fait via l’API. Sinon, ils peuvent être modifiés, car ils devront ensuite être associés dans le mapping.
Ci-dessous, un exemple de données extraites du fichier CSV :
name,productDetailUrl,productId,unitPrice,imageUrl,thumbnailUrl,description,categories,tags,relatedExternalProductIds,priority,ratingCount,rating,reviewCount,brand,unitPriceOriginal,unitPriceWithoutVAT,discountedAmount,discountedPercentage,publishedAt,inStockUnits,availability,isBlacklisted,customField1,customField2,customField3 Product A,http://example.com/productA,101,20.99,http://example.com/images/productA.jpg,http://example.com/thumbs/productA.jpg,An innovative gadget for modern homes.,electronics/home/gadgets|electronics/home/accessories,innovative|gadget,200|201,5,150,4.5,75,GadgetPro,25.99,17.49,5.0,20,2021-03-15T00:00:00Z,120,instock,false,CustomValueA1,CustomValueA2,CustomValueA3 Product B,http://example.com/productB,102,45.5,http://example.com/images/productB.jpg,http://example.com/thumbs/productB.jpg,A durable and reliable tool for professionals.,tools/professional/hardware|tools/professional/accessories,durable|professional,300|301,3,200,4.7,90,ToolWorks,50.0,37.92,4.5,10,2021-06-20T00:00:00Z,80,outofstock,true,CustomValueB1,CustomValueB2,CustomValueB3
ÉTAPE 1 : Sélection de la source de données
1. Accédez à "Ecommerce > Catalogue" et cliquez sur Importer des produits.
2. Dans la section Sélectionnez une source de données, choisissez l’option Importer depuis un fichier.
Il est possible d’effectuer l’importation en copiant-collant le contenu du fichier CSV dans la zone de texte centrale, mais cette option est plus limitée car elle ne permet pas l’importation de grandes quantités de produits.
3. Configurez les paramètres de l’importation.
3.1. Cochez Inclure l’en-tête si le fichier CSV contient une ligne d’en-tête avec les noms des colonnes.
3.2. Dans Délimiteur, choisissez le caractère qui sépare les colonnes de votre fichier.
3.3. Sélectionnez l’option Écraser les existants si vous souhaitez remplacer les informations des produits déjà présents dans Connectif par celles du fichier.
3.4. Sélectionnez l’option Mettre à jour uniquement les champs vides si vous souhaitez ne mettre à jour que les champs sans données.
4. Cliquez sur Suivant .
ÉTAPE 2 : Configuration des champs à importer
Une fois le fichier importé, il faut associer les champs du CSV importé (colonne de gauche dans l’interface) aux champs des produits dans Connectif.
5. Sélectionnez le nom de chaque champ du fichier importé et faites-le glisser vers le champ correspondant dans Connectif.
Dans l’exemple, le champ du fichier ID alimente le champ Identifiant externe du produit dans Connectif, Nom du produit alimente le champ Nom dans Connectif, Catégories pour Catégories et Prix unitaire pour Prix unitaire.
Il existe également une valeur (toujours disponible) appelée Littéral. Son utilité principale est de "simuler" l’importation d’une colonne qui, en réalité, n’existe pas dans le fichier CSV importé. Lorsqu’on assigne un Littéral à un champ de produit, un éditeur apparaît pour permettre d’attribuer une valeur à ce champ pour tous les produits importés.
6. Cliquez sur Suivant .
ÉTAPE 3 : Vérification de l’importation
7. Cliquez sur Aller à la liste d’importation .
8. Vérifiez que les produits et leurs informations ont bien été importés.
Dans cet écran, le pourcentage de progression de l’importation s’affiche ainsi qu’un résumé une fois celle-ci terminée.
9. En cas d’erreur, téléchargez le CSV de rapport d’erreurs en cliquant sur le bouton (Télécharger le rapport d’erreurs en CSV).
L’erreur la plus fréquente lors d’une importation est qu’une des lignes du fichier CSV contient un type de donnée incompatible avec le champ associé. Par exemple, si la valeur Texte "PRIX" est attribuée au champ Prix unitaire du produit, cela provoquera une erreur pour cet enregistrement.
Félicitations !
Vous êtes arrivé à la fin de la leçon.
Vous avez encore des questions ?
Nos spécialistes Connectif sont à votre disposition. Pour les contacter, ouvrez simplement un ticket d’assistance en cliquant sur le bouton bleu “Aide” de votre tableau de bord.
Continuez à apprendre !
Pour tirer le meilleur parti de votre compte Connectif, nous vous recommandons de consulter les articles suivants :
- Fiche produit, pour connaître les étiquettes et catégories des produits de votre eCommerce.
- Synchronisation et vérification des produits, pour exploiter tout le potentiel du catalogue Connectif.
- Segments de produits, pour apprendre à disposer en temps réel de groupes de produits à utiliser dans différentes stratégies.
-
Recommandateur d’offres, pour aider les clients indécis à se décider pour les produits en promotion sur le site.