Naar de inhoud
Terug naar alle supportartikelen
Producten en e-commerce feedcsvxmlreferentie

Referentie productfeedvelden

Mikabot accepteert per veld verschillende gangbare namen, zodat de meeste bestaande feeds zonder aanpassing importeren.

Google Shopping (XML)

ElementWordtVerplicht
g:idProduct-IDJa
titleProducttitelAanbevolen
descriptionBeschrijvingAanbevolen
g:product_typeCategorieAanbevolen
g:brandMerkOptioneel
g:priceReguliere prijsAanbevolen
g:sale_priceActieprijsOptioneel
g:availabilityVoorraadstatusOptioneel
g:image_linkAfbeeldings-URLAanbevolen
linkURL van de productpaginaAanbevolen

Elementen worden met of zonder het voorvoegsel g: gelezen.

Zonder g:product_type kan Mikabot voor dat item geen categorie opbouwen, en categoriezoeken bereikt het dan niet.

CSV

De eerste rij moet een kopregel zijn. Kolomnamen worden hoofdletterongevoelig gematcht, en de eerst gevonden naam wint.

VeldGeaccepteerde kolomnamen
Product-ID (verplicht)id, external_id, product_id, sku
Titeltitle, product_title, name, product_name
Beschrijvingdescription, desc, product_description, details
Hoofdcategorieproduct_category, main_category, primary_category, category_name
Extra categorieëncategories, category, type
Merkbrand, manufacturer, maker, producer
Prijsprice, cost, amount, value
Actieprijssale_price, discount_price, special_price, offer_price
Voorraadstatusavailability, stock, stock_status, inventory_status
Afbeeldings-URLimage_link, image, image_url, photo, picture
Product-URLlink, url, product_url, website
Taallanguage, lang, locale

Een minimaal werkende CSV

id,title,description,product_category,brand,price,availability,image_link,link
1001,Monstera Deliciosa,"Grootbladige kamerplant die weinig licht verdraagt.",Kamerplanten,GreenCo,29.95,in_stock,https://example.com/img/1001.jpg,https://example.com/p/1001

Regels die bepalen of een rij importeert

  • id is verplicht en moet uniek zijn. Rijen zonder worden overgeslagen en geteld als missing id. Rijen met dezelfde id overschrijven elkaar.
  • De rijlengte moet met de kopregel overeenkomen. Een losse komma in een niet-aangehaalde beschrijving verschuift elke volgende kolom.
  • Zet elk veld met een komma, aanhalingsteken of regeleinde tussen aanhalingstekens, met standaard dubbele CSV-aanhalingstekens.
  • Een kolom language overschrijft de importtaal voor die rij. Laat hem weg tenzij je bewust talen in één bestand mengt.

Hoe prijzen gelezen worden

Valutasymbolen, spaties en duizendtalscheiders worden verwijderd, en zowel de Europese als de Angelsaksische notatie wordt begrepen: €1.234,56 en 1,234.56 worden allebei 1234,56; 19,95 en 19.95 worden allebei 19,95.

Een ontbrekende of onleesbare prijs wordt 0. Een product met prijs 0 oogt kapot in de chat, dus controleer die kolom na je eerste import.

Hoe de voorraadstatus gelezen wordt

Gangbare schrijfwijzen worden genormaliseerd naar in_stock, out_of_stock, preorder of backorder. in stock, instock, available en in worden allemaal in_stock; sold out, outofstock en unavailable worden out_of_stock. Al het andere wordt opgeslagen zoals het is.

Op dit veld werkt Ecommerce → AI configuration → Do not recommend unavailable products. Zonder dit veld heeft die instelling niets om te filteren.

Wat de AI leest

De beschrijving is het veld dat de AI doorzoekt en waarover hij redeneert.

  • Schrijf waar het product voor dient, niet alleen wat het is. Verdraagt een kamer op het noorden beantwoordt een vraag die een bezoeker kan stellen; Hoogte 60 cm niet.
  • Gebruik de woorden die klanten gebruiken, ook de informele.
  • Vermijd HTML, en vermijd standaardtekst die bij elk product hetzelfde is — daardoor worden producten moeilijker uit elkaar te houden.
  • Vul product_type of product_category in. Dat voedt het categoriezoeken.

Na het importeren

  1. Vergelijk Products in Feed met Products in DB
  2. Open Ecommerce → Products en controleer titels, prijzen en afbeeldingen
  3. Open Ecommerce → Categories en kijk of de boom op je winkel lijkt
  4. Vraag de bot op de Demo page naar iets alledaags

Verwant

Gerelateerde artikelen

Neem contact op

Ons supportteam staat klaar om je snel en persoonlijk te helpen wanneer je hulp nodig hebt.