Produits et e-commerce fluxcsvxmlréférence

Référence des champs de flux produit

Mikabot accepte plusieurs noms courants pour chaque champ, ce qui permet à la plupart des flux existants d’être importés sans modification.

Google Shopping (XML)

Élément	Correspond à	Obligatoire
`g:id`	ID produit	Oui
`title`	Titre du produit	Recommandé
`description`	Description	Recommandé
`g:product_type`	Catégorie	Recommandé
`g:brand`	Marque	Facultatif
`g:price`	Prix normal	Recommandé
`g:sale_price`	Prix promotionnel	Facultatif
`g:availability`	État du stock	Facultatif
`g:image_link`	URL de l’image	Recommandé
`link`	URL de la fiche produit	Recommandé

Les éléments sont lus avec ou sans le préfixe g:.

Sans g:product_type, Mikabot ne peut pas construire de catégorie pour cet article, et la recherche par catégorie ne l’atteindra pas.

CSV

La première ligne doit être une ligne d’en-tête. Les noms de colonnes sont comparés sans tenir compte de la casse, et le premier nom trouvé l’emporte.

Champ	Noms de colonnes acceptés
ID produit (obligatoire)	`id`, `external_id`, `product_id`, `sku`
Titre	`title`, `product_title`, `name`, `product_name`
Description	`description`, `desc`, `product_description`, `details`
Catégorie principale	`product_category`, `main_category`, `primary_category`, `category_name`
Catégories additionnelles	`categories`, `category`, `type`
Marque	`brand`, `manufacturer`, `maker`, `producer`
Prix	`price`, `cost`, `amount`, `value`
Prix promotionnel	`sale_price`, `discount_price`, `special_price`, `offer_price`
État du stock	`availability`, `stock`, `stock_status`, `inventory_status`
URL de l’image	`image_link`, `image`, `image_url`, `photo`, `picture`
URL du produit	`link`, `url`, `product_url`, `website`
Langue	`language`, `lang`, `locale`

Un CSV minimal qui fonctionne

id,title,description,product_category,brand,price,availability,image_link,link
1001,Monstera Deliciosa,"Plante d'intérieur à grandes feuilles qui tolère la faible lumière.",Plantes d'intérieur,GreenCo,29.95,in_stock,https://example.com/img/1001.jpg,https://example.com/p/1001

Ce qui décide si une ligne est importée

id est obligatoire et doit être unique. Les lignes sans identifiant sont ignorées et comptées comme missing id. Les lignes partageant un id s’écrasent mutuellement.
La longueur de la ligne doit correspondre à l’en-tête. Une virgule isolée dans une description non protégée décale toutes les colonnes suivantes.
Protégez tout champ contenant une virgule, un guillemet ou un saut de ligne avec des guillemets doubles CSV standard.
Une colonne language remplace la langue d’import pour cette ligne. Ne l’incluez pas, sauf si vous mélangez délibérément des langues dans un seul fichier.

Comment les prix sont lus

Les symboles monétaires, les espaces et les séparateurs de milliers sont supprimés, et les formats européen comme anglo-saxon sont compris : 1 234,56 € et 1,234.56 donnent tous deux 1234,56 ; 19,95 et 19.95 donnent tous deux 19,95.

Un prix manquant ou illisible devient 0. Un produit à 0 paraît cassé dans le chat : vérifiez cette colonne après votre premier import.

Comment l’état du stock est lu

Les orthographes courantes sont normalisées en in_stock, out_of_stock, preorder ou backorder. in stock, instock, available et in deviennent tous in_stock ; sold out, outofstock et unavailable deviennent out_of_stock. Le reste est stocké tel quel.

C’est ce champ sur lequel agit Ecommerce → AI configuration → Do not recommend unavailable products. Sans lui, ce réglage n’a rien à filtrer.

Ce que lit l’IA

La description est le champ que l’IA parcourt et sur lequel elle raisonne.

Écrivez à quoi sert le produit, pas seulement ce qu’il est. Tolère une pièce exposée au nord répond à une question que peut poser un visiteur ; Hauteur 60 cm, non.
Employez les mots qu’utilisent les clients, y compris les mots familiers.
Évitez le HTML, et évitez le texte passe-partout répété sur chaque produit : il rend les produits plus difficiles à distinguer.
Remplissez product_type ou product_category. C’est ce qui alimente la recherche par catégorie.

Après l’import

Comparez Products in Feed et Products in DB
Ouvrez Ecommerce → Products et vérifiez titres, prix et images
Ouvrez Ecommerce → Categories et vérifiez que l’arborescence ressemble à votre boutique
Demandez au bot quelque chose d’ordinaire sur la Demo page

À voir aussi

Articles associés

Connecter un flux produit

Importez votre catalogue depuis un flux Google Shopping ou une URL CSV.

Catégories et marques

Choisissez les parties de votre catalogue que le bot peut proposer, et paramétrez les questions de suivi.

Réglages des recommandations produit

Choisissez une stratégie de recherche et réglez la façon dont l'IA trouve et présente vos produits.

Contactez-nous

Notre équipe d'assistance est prête à vous fournir une aide rapide et personnelle lorsque vous en avez besoin.

Contactez-nous Retour à tous les articles d'assistance