L'importation de produits permet d'ajouter des articles à votre catalogue manuellement via l'outil d'importation, afin de les rendre immédiatement disponibles 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 ponctuellement.
Bien que l' étiquette "Le contact a visité un produit" ajoute 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 de Connectif, afin de le rendre disponible dès le départ.
Avant de commencer : préparation du fichier de produits
Pour effectuer l'importation, un fichier CSV valide contenant les champs des produits à importer est nécessaire.
Le tableau suivant présente les champs pouvant être inclus dans le fichier CSV :
| Nom | Type | Description | Exemple |
|---|---|---|---|
| productDetailUrl | Texte | URL de la page produit (l'URL doit être non encodée). Cette valeur doit obligatoirement figurer dans le document. | http://exple.com/productA |
| productId | Texte | Identifiant unique du produit (dans l'e-commerce). Cette valeur doit obligatoirement figurer dans le document. | 101 |
| name | Texte | Nom du produit. Cette valeur doit obligatoirement figurer dans le document. | Produit A |
| unitPrice | Décimal | Prix unitaire du produit. Cette valeur doit obligatoirement figurer 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 d'aperçu du produit. | http://expl.com/thumbs/productA.jpg |
| categories | Liste de textes |
La ou les catégories auxquelles appartient le produit. Si plusieurs catégories doivent être indiquées, le caractère "|" doit être utilisé pour les séparer. Si l'e-commerce permet des sous-catégories, le chemin complet doit être indiqué 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. Si plusieurs étiquettes doivent être indiquées, le caractère "|" doit être utilisé pour les séparer. | innovant|gadget |
| brand | Texte | Marque du produit. | GadgetPro |
| ratingCount | Entier | Nombre d'avis sur le produit. | 150 |
| rating | Décimal | Note moyenne du produit. | 4.5 |
| reviewCount | Entier | Nombre total d'avis sur le produit. | 75 |
| relatedExternalProductIds | Liste de textes | Identifiants des produits associés. Si plusieurs produits doivent être indiqués, utilisez le caractère "|". | 200|201 |
| priority | Entier | Niveau de priorité ou de préférence du 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, allant de 0 à 100 sans symbole de pourcentage. | 20 |
| discountedAmount | Décimal | Montant de la réduction du produit (doit correspondre à unit_price_original - unit_price). | 5.0 |
| publishedAt | Date | Date au format ISO8601 de 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 | Indiqué comme instock ou outofstock. Indique si le produit est disponible ou non. | instock |
| isBlacklisted | Booléen | Indiqué comme true ou false. Permet d'exclure le produit des recommandations si marqué comme true. Si aucune valeur n'est spécifiée, false est défini par défaut 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 de la table doivent être conservés exactement tels quels si l'importation des produits est effectuée 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,Un gadget innovant pour les maisons modernes.,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,Un outil durable et fiable pour les professionnels.,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 à "E-commerce > 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 et collant le contenu du fichier CSV dans la zone de texte centrale, mais cette option est plus limitée car elle ne prend pas en charge les importations de grandes quantités de produits.
3. Configurez les paramètres d'importation.
3.1. Sélectionnez Inclure l'en-tête si le fichier CSV contient un en-tête avec les noms des colonnes.
3.2. Choisissez, dans Délimiteur, le caractère qui délimite les colonnes de votre fichier.
3.3. Sélectionnez l'option Écraser les existants si vous souhaitez remplacer les informations des produits déjà existants dans Connectif par celles incluses dans le fichier.
3.4. Sélectionnez l'option Mettre à jour uniquement les champs vides si vous souhaitez que seuls les champs sans information soient mis à jour.
4. Cliquez sur Suivant .
ÉTAPE 2 : Configuration des champs à importer
Une fois le fichier importé, les champs du fichier CSV importé (colonne de gauche de l'interface) doivent être associés aux champs des produits dans Connectif.
5. Sélectionnez le nom de chaque champ du fichier importé et faites-le glisser vers son équivalent dans Connectif.
Dans l'exemple, le champ du fichier ID correspond au champ External product ID dans Connectif, Nom du produit sera attribué au champ Nom dans Connectif, Catégories correspondra à Categories et Prix unitaire sera associé à Unit Price.
Il existe également une valeur (toujours disponible) appelée Valeur Littérale. Son objectif principal est de "simuler" l'importation d'une colonne qui, en réalité, n'est pas présente dans le fichier CSV importé. Lorsqu'une Valeur Littérale est assignée à un champ du produit, un éditeur apparaît, permettant d'attribuer la valeur souhaitée à ce champ pour tous les produits à importer.
6. Cliquez sur Suivant .
ÉTAPE 3 : Vérification de l'importation
7. Cliquez sur Aller à la liste des importations .
8. Vérifiez que les produits et leurs informations ont été correctement importés.
Sur cet écran, le pourcentage d'avancement de l'importation des produits est affiché et, une fois terminé, un résumé de l'opération.
9. S'il y a une erreur, téléchargez le rapport d'erreurs au format CSV en cliquant sur le bouton (Télécharger le rapport d'erreurs au format CSV).
L'erreur d'importation la plus courante est qu'une des lignes importées dans le fichier CSV contient un type de donnée incompatible avec le champ assigné. Par exemple, si la valeur Texte "PRIX" est attribuée au champ Prix Unitaire du produit, l'importation de cet enregistrement entraînera une erreur.
Félicitations !
Vous êtes arrivé à la fin de la leçon.
Des questions non résolues ?
Rappelez-vous que nos spécialistes Connectif sont à votre disposition. Pour les contacter, il vous suffit d’ouvrir un ticket auprès du Support 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 en savoir plus sur les étiquettes et catégories des produits de votre eCommerce.
- Synchronisation et vérification des produits, pour exploiter tout le potentiel du catalogue de Connectif.
- Segments de produits, pour apprendre à gérer en temps réel des groupes de produits à utiliser dans différentes stratégies.
-
Recommandation d'offres, pour aider les clients indécis à choisir les produits en promotion sur le site.