Asistentul de cumpărături Mira AI folosește feedul dvs. de produse pentru a recomanda produse, a răspunde la întrebările despre prețuri și a verifica disponibilitatea. Acest ghid explică formatele de feed acceptate de Mira AI, etichetele pe care le citește și unde găsiți instrucțiunile oficiale de export pentru cele mai populare platforme de e-commerce.

Am împărțit ghidul în următoarele secțiuni:

Feedul sau web scrapingul nu funcționează? Depanarea surselor de cunoștințe Mira AI

Înainte să începeți

Mira AI acceptă feeduri de produse XML standard — același format pe care majoritatea platformelor de e-commerce îl generează pentru Heuréka, Google Shopping, Zboží.cz și alte marketplace-uri similare. Cu cât feedul dvs. este mai bogat (preț, disponibilitate, descriere, link, categorie), cu atât recomandările Mira vor fi mai inteligente.

Pentru a adăuga feedul în Smartsupp:

În constructorul asistentului, deschideți Bază de cunoștințe → Produse și faceți clic pe Adăugați.
Introduceți un nume pentru sursă.
Lipiți URL-ul complet al feedului de produse.
La pasul Actualizați, alegeți cât de des trebuie să se actualizeze feedul.

Sfat: Consultați Introducere în Mira AI pentru setarea completă.

Mira AI actualizează automat periodic feedul dvs. de produse — modificările de preț, actualizările de stoc și noile produse apar în chat fără să fie nevoie să reîncărcați fișierul.

Notă: Mira AI încarcă imaginile produselor de pe card direct din feedul XML. Dacă un produs nu are imagine în feed, Mira va folosi imaginea Open Graph sau imaginea principală de pe pagina produsului – de aceea merită să le setați și pe acestea.

Notă: Dacă serverul dvs. restricționează conexiunile de intrare (firewall, lista albă IP), asigurați-vă că permiteți accesul din adresele IP ale feed-fetcherului Smartsupp: 94.130.187.58 și 188.245.65.74. În caz contrar, Mira AI nu va putea descărca feedul de produse.

Aceste adrese IP pot fi modificate ocazional. Dacă feedul dvs. încetează brusc să se actualizeze, verificați acest articol pentru lista actuală sau contactați echipa noastră de suport.

Formate de feed acceptate

Mira AI suportă două formate standard de feeduri de produse — Heuréka și Google Merchant. Ambele urmează convenții XML comune:

Extensia fișierului este .xml sau .rss.
Prima linie trebuie să înceapă cu <?xml ...?> sau <rss ...>.
O etichetă părinte încapsulează toate articolele de produs. Eticheta părinte poate avea orice nume (ex. <SHOP>) — contează doar existența acesteia.
Fiecare produs este încadrat în propria sa etichetă de articol (vezi secțiunile pentru fiecare format de mai jos).

Un schelet minim valid arată astfel:

<?xml version="1.0" encoding="UTF-8"?> <SHOP> <SHOPITEM> ... </SHOPITEM> <SHOPITEM> ... </SHOPITEM> </SHOP>

Important: Dacă lipsește o etichetă obligatorie dintr-un produs, acel produs va fi omis din indexul Mira — vizitatorii nu îl vor vedea în recomandări. Asigurați-vă că fiecare produs are completate toate etichetele obligatorii.

Structura feedului Heuréka

Pentru formatul Heuréka, Mira AI citește următoarele etichete. Consultați documentația oficială Heuréka XML feed pentru specificația completă.

Categorie	Etichete	Note
Încapsulator articol (obligatoriu)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Una dintre aceste etichete încapsulează fiecare produs.
Descriere (obligatoriu)	`PRODUCTNAME` (sau `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Fiecare etichetă trebuie să conțină conținut. Etichetele goale sunt considerate lipsă.
Opțional	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = în stoc, 1–7 = disponibil în decurs de o săptămână, orice altceva / lipsă = indisponibil. `PARAM` poate fi repetat oricât de multe ori pentru fiecare produs.
Imagine	`IMGURL`	Imaginea produsului afișată pe card. Dacă lipsește, Mira folosește imaginea Open Graph sau imaginea principală de pe pagina produsului.
Ignorat	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI ignoră aceste etichete — le puteți lăsa în feed pentru alte instrumente.

O etichetă PARAM transportă un atribut suplimentar de produs sub formă de pereche nume–valoare:

<PARAM> <PARAM_NAME>Lățime</PARAM_NAME> <VAL>100–109 cm</VAL> </PARAM>

Structura feedului Google Merchant

Pentru formatul Google Merchant, Mira AI citește următoarele etichete. Consultați documentația oficială Google Merchant feed pentru referința completă.

Categorie	Etichete	Note
Încapsulator articol (obligatoriu)	`item`, `entry`, `product`	Una dintre aceste etichete încapsulează fiecare produs.
Descriere (obligatoriu)	`title`, `description`, `product_type` (sau `google_product_category`), `link`, `price`	Pentru categorie, folosiți `product_type` sau `google_product_category` cu numele din text — codurile numerice de categorie nu sunt încă suportate.
Format preț	`price`	Format permis: `236 CZK` sau `CZK 236`. Sunt acceptate și separatori zecimali și de mii, de exemplu `1049.00 CHF`, `1049,00 CHF`, `1.049,00 CHF`, `1,049.00 CHF` sau `1 049,00 CHF`. Moneda este un cod de 3 litere (CZK, EUR, GBP... ).
Preț promoțional (opțional)	`sale_price`, `sale_price_effective_date`	Dacă `sale_price` este prezent, în aceeași monedă și mai mic decât `price`, Mira va cita prețul promoțional în răspunsuri, căutări produse și pe cardurile de produs. Cu `sale_price_effective_date`, prețul promoțional este folosit doar în acea perioadă (verificată la momentul întrebării); în afara acesteia, sau dacă perioada nu poate fi citită, Mira folosește prețul obișnuit. Feedurile existente preiau prețurile promoționale la următoarea actualizare.
Opțional	`availability`	În stoc: `in_stock`, `in stock`. Indisponibil: `out_of_stock`, `out of stock`, `preorder`, `backorder`, orice altceva / lipsă.
Imagine	`image_link`	Imaginea produsului afișată pe card. Dacă lipsește, Mira folosește imaginea Open Graph sau imaginea principală de pe pagina produsului.
Ignorat	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI ignoră aceste etichete — le puteți lăsa în feed pentru alte instrumente.

Mira citește de asemenea mărimile produsului din feedul dvs. (eticheta size) și le poate menționa când recomandă produse. Mărimile vor apărea după actualizarea feedului.

Notă: ID-urile numerice google_product_category nu sunt încă suportate. Folosiți întotdeauna varianta text a categoriei — de exemplu „Îmbrăcăminte și accesorii > Îmbrăcăminte > Cămăși și bluze” — sau folosiți product_type în loc.

Export feed după platformă

Găsiți platforma dvs. de e-commerce în tabelul de mai jos și urmați ghidul oficial de export.

Platformă	Ce generează	Ghid oficial
Shoptet	Heuréka & Google Shopping XML din panoul de administrare	XML Feeds • Heuréka XML
Shopsys	Feeduri de produse prin platformă cu documentație pentru dezvoltatori	Product Feeds
Eshop-rychle	Feeduri pentru motoarele de comparare de prețuri	Export produse
Upgates	Export de date XML cu structura completă a produsului	Export date • Documentație XML
Shoper	Feed Google direct din platformă	Google Feed
Shopware	Google Shopping — export direct sau prin suplimente	Export direct • Suplimente
Shoprenter	Feeduri Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping prin suplimente	Suplimente
Magento	Google Shopping prin extensii	Extensii
WooCommerce	Feeduri Google Product prin suplimente	Suplimente • Recomandat

Ce urmează?

Introducere în Asistentul de cumpărături Mira AI — setați Mira AI și adăugați feedul de produse ca sursă.
Cum începeți instruirea Mira AI — rafinați răspunsurile AI cu perechi de întrebări și răspunsuri personalizate.
Mira AI – disponibilitatea stocului — permiteți vizitatorilor să verifice dacă un produs este în stoc.
Întrebări frecvente despre Asistentul de cumpărături Mira AI — întrebări comune despre Mira AI.

💡 Vă trebuie mai mult ajutor? Contactați echipa noastră de suport — vă ajutăm cu plăcere!

Articole similare

Cum să exportați feeduri de produse din diverse platforme de e-commerce pentru Asistentul de cumpărături Mira AI?