Asistentul de cumpărături Mira AI folosește feedul dvs. de produse pentru a recomanda produse, a răspunde la întrebări 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 comerț electronic.

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

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

Înainte de a începe

Mira AI acceptă feeduri standard de produse în format XML — același format pe care majoritatea platformelor de comerț electronic îl generează pentru Heuréka, Google Shopping, Zboží.cz și alte piețe online 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 editorul asistentului, deschideți Bază de cunoștințe → Produse și faceți clic pe Adăugați o sursă nouă.
Introduceți un nume pentru sursă.
Lipiți URL-ul complet al feedului dvs. de produse.
La pasul Actualizare , alegeți cât de des să fie actualizat feedul.

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

Mira AI actualizează automat feedul dvs. de produse la intervale regulate — modificările de preț, actualizările disponibilității și produsele noi apar în chat fără să fie nevoie să încărcați din nou fișierul.

Notă: În perioada de probă, actualizările automate ale feedului sunt suspendate. După ce treceți la un plan superior, alegeți un interval de actualizare pentru feedul dvs. pentru a le activa.

Notă: Mira AI încarcă imaginile cardurilor de produse direct din feedul dvs. XML. Dacă un produs nu are o imagine în feed, Mira folosește imaginea Open Graph sau imaginea principală de pe pagina produsului — așadar, merită să le păstrați și pe acestea configurate.

Notă: Dacă serverul dvs. restricționează conexiunile de intrare (firewall, listă de adrese IP permise), asigurați-vă că permiteți accesul de la adresele IP ale serviciului Smartsupp de preluare a feedurilor: 94.130.187.58 și 188.245.65.74. În caz contrar, Mira AI nu va putea descărca feedul dvs. de produse.

Aceste adrese IP se pot schimba ocazional. Dacă feedul dvs. încetează brusc să se actualizeze, consultați acest articol pentru lista curentă sau contactați echipa noastră de asistență.

Formate de feed acceptate

Mira AI acceptă două formate standard de feeduri de produse — Heuréka și Google Merchant. Ambele respectă convențiile XML uzuale:

Extensia fișierului este .xml sau .rss.
Prima linie trebuie să înceapă cu <?xml ...?> sau <rss ...>.
O etichetă părinte cuprinde toate elementele de produs. Eticheta părinte poate avea orice nume (de ex. <SHOP>) — contează doar să existe.
Fiecare produs este cuprins în propria etichetă de element (consultați mai jos secțiunile specifice fiecărui format).

O structură minimală validă arată astfel:

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

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

Structura feedului Heuréka

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

Categorie	Etichete	Note
Etichetă de încadrare a elementului (obligatorie)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Una dintre aceste etichete cuprinde fiecare produs.
Descriere (obligatorie)	`PRODUCTNAME` (sau `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Fiecare etichetă trebuie să aibă conținut. Etichetele goale sunt considerate lipsă.
Opționale	`DELIVERY_DATE`, `PARAM`	`DELIVERY_DATE`: 0 = în stoc, 1–7 = disponibil în decurs de o săptămână, orice altă valoare / lipsă = indisponibil. `PARAM` se poate repeta de oricâte 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.
Ignorate	`DELIVERY`, `EAN`, `ITEM_ID`, `VAT`, `ITEMGROUP_ID`, `ACCESSORY`, `MANUFACTURER`	Mira AI omite aceste etichete — le puteți păstra în feed pentru alte instrumente.

O etichetă PARAM conține un atribut suplimentar al produsului sub forma unei perechi nume–valoare:

<PARAM> <PARAM_NAME>Width</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 Specificația oficială a feedului Google Merchant pentru documentația de referință completă.

Categorie	Etichete	Note
Etichetă de încadrare a elementului (obligatorie)	`item`, `entry`, `product`	Una dintre aceste etichete cuprinde fiecare produs.
Descriere (obligatorie)	`title`, `description`, `product_type` (sau `google_product_category`), `link`, `price`	Pentru categorie, folosiți `product_type` sau `google_product_category` cu denumirea în format text — ID-urile numerice ale categoriilor nu sunt încă acceptate.
Formatul prețului	`price`	Format acceptat: `236 CZK` sau `CZK 236`. Moneda este un cod de 3 litere (CZK, EUR, GBP…).
Opționale	`availability`	În stoc: `in_stock`, `in stock`. Indisponibil: `out_of_stock`, `out of stock`, `preorder`, `backorder`, orice altă valoare / 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.
Ignorate	`id`, `gtin`, `checkout_link_template`, `item_group_id`	Mira AI omite aceste etichete — le puteți păstra în feed pentru alte instrumente.

Mira citește și mărimile produselor din feedul dvs. (eticheta size ) și le poate menționa atunci când recomandă produse. Mărimile apar după actualizarea feedului dvs.

Notă: ID-urile numerice google_product_category nu sunt încă acceptate. Folosiți întotdeauna versiunea text a categoriei — de exemplu "Îmbrăcăminte & accesorii > Îmbrăcăminte > Cămăși & topuri" — sau folosiți product_type în schimb.

Exportul feedului în funcție de platformă

Găsiți platforma dvs. de comerț electronic în tabelul de mai jos și urmați ghidul oficial de export.

Platformă	Ce generează	Ghid oficial
Shoptet	XML Heuréka & Google Shopping din panoul de administrare	Feeduri XML • XML Heuréka
Shopsys	Feeduri de produse prin platformă, cu documentație pentru dezvoltatori	Feeduri de produse
Eshop-rychle	Feeduri pentru motoare de comparare a prețurilor	Export de produse
Upgates	Export de date XML cu structura completă a produselor	Export de date • Documentație XML
Shoper	Feed de produse Google direct din platformă	Feed Google
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	Google Product Feed prin suplimente	Suplimente • Recomandate

Ce urmează?

Introducere în asistentul de cumpărături Mira AI — configurați Mira AI și adăugați feedul dvs. de produse ca sursă.
Cum începeți instruirea Mira AI — ajustați răspunsurile AI cu perechi personalizate de întrebări&răspunsuri.
Mira AI - disponibilitatea în stoc — permiteți vizitatorilor să verifice dacă un produs este în stoc.
Întrebări frecvente despre asistentul de cumpărături Mira AI — întrebări frecvente despre Mira AI.

💡 Aveți nevoie de mai mult ajutor? Contactați Echipa noastră de asistență — vă ajutăm cu plăcere!

Articole similare

Cum exportați feeduri de produse de pe diverse platforme de comerț electronic pentru asistentul de cumpărături MiraAI?