Référence des champs de flux produits
Mikabot accepte plusieurs noms courants par champ : la plupart des flux existants s’importent sans modification. Cette page les recense tous.
Google Shopping (XML)
| Élément | Correspond à | Obligatoire |
|---|---|---|
g:id | Identifiant produit | Oui |
title | Titre du produit | Fortement recommandé |
description | Description | Fortement recommandé |
g:product_type | Catégorie | Recommandé |
g:brand | Marque | Facultatif |
g:price | Prix normal | Recommandé |
g:sale_price | Prix promotionnel | Facultatif |
g:image_link | URL de l’image | Recommandé |
link | URL de la page 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égories pour cet article. Après un import, un avertissement indique combien de produits sont concernés, et la recherche par catégorie ne les 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 |
|---|---|
| Identifiant 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 supplémentaires | categories, category, type |
| Marque | brand, manufacturer, maker, producer |
| Prix | price, cost, amount, value |
| Prix promotionnel | sale_price, discount_price, special_price, offer_price |
| 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 fonctionnel
id,title,description,product_category,brand,price,image_link,link
1001,Monstera Deliciosa,"Plante d'intérieur à grandes feuilles qui tolère peu de lumière.",Plantes d'intérieur,GreenCo,29.95,https://example.com/img/1001.jpg,https://example.com/p/1001
Les règles qui décident si une ligne s’importe
idest obligatoire et doit être unique. Les lignes sans identifiant sont ignorées et comptées comme missing id. Les lignes partageant un identifiant s’écrasent.- 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 par des guillemets tout champ contenant une virgule, un guillemet ou un saut de ligne, avec les doubles guillemets CSV standard.
- Une colonne
languageremplace la langue d’import pour cette ligne. Ne l’incluez pas, sauf si vous mélangez délibérément les langues dans un fichier.
Comment les prix sont lus
Les symboles monétaires, espaces et séparateurs de milliers sont supprimés. 19,95 comme 19.95 sont lus comme 19,95. Un prix manquant ou illisible devient 0, et un produit à 0 paraît cassé dans le chat : vérifiez cette colonne après votre premier import.
À quoi ressemble une bonne donnée produit
La description est ce que l’IA cherche et sur quoi elle raisonne. C’est là que la plupart des résultats Mikabot se gagnent ou se perdent.
- Écrivez à quoi sert le produit, pas seulement ce qu’il est. Supporte une pièce orientée nord répond à une vraie question ; Hauteur 60 cm non.
- Utilisez les mots employés par les clients, y compris familiers.
- Évitez le HTML, les slogans marketing et les mêmes formules répétées sur chaque produit.
- Renseignez la vraie catégorie dans
product_typeouproduct_category. Elle alimente la recherche par catégorie et l’indicateur Catalog Coverage.
Après l’import
- Comparez Products in Feed et Products in DB
- Ouvrez Ecommerce → Products et contrôlez titres, prix et images
- Ouvrez Ecommerce → Categories et vérifiez que l’arborescence ressemble à votre boutique
- Demandez au bot quelque chose de banal sur la Demo page
Voir aussi
Articles associés
Connecter un flux produits
Importez votre catalogue depuis un flux Google Shopping, une URL CSV ou un envoi de fichier.
Catégories et marques
Choisissez les parties du catalogue que le bot peut proposer, et définissez des questions de relance.
Réglages des recommandations produit
Choisissez une stratégie de recherche et affinez 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.