Aller au contenu
Retour à tous les articles d'assistance
Produits et e-commerce fluxcsvxmlréférence

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émentCorrespond àObligatoire
g:idIdentifiant produitOui
titleTitre du produitFortement recommandé
descriptionDescriptionFortement recommandé
g:product_typeCatégorieRecommandé
g:brandMarqueFacultatif
g:pricePrix normalRecommandé
g:sale_pricePrix promotionnelFacultatif
g:image_linkURL de l’imageRecommandé
linkURL de la page produitRecommandé

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.

ChampNoms de colonnes acceptés
Identifiant produit (obligatoire)id, external_id, product_id, sku
Titretitle, product_title, name, product_name
Descriptiondescription, desc, product_description, details
Catégorie principaleproduct_category, main_category, primary_category, category_name
Catégories supplémentairescategories, category, type
Marquebrand, manufacturer, maker, producer
Prixprice, cost, amount, value
Prix promotionnelsale_price, discount_price, special_price, offer_price
URL de l’imageimage_link, image, image_url, photo, picture
URL du produitlink, url, product_url, website
Languelanguage, 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

  • id est 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 language remplace 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_type ou product_category. Elle alimente la recherche par catégorie et l’indicateur Catalog Coverage.

Après l’import

  1. Comparez Products in Feed et Products in DB
  2. Ouvrez Ecommerce → Products et contrôlez titres, prix et images
  3. Ouvrez Ecommerce → Categories et vérifiez que l’arborescence ressemble à votre boutique
  4. Demandez au bot quelque chose de banal sur la Demo page

Voir aussi

Articles associés

Contactez-nous

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