Asistentul de cumpărături Mira AI folosește feed-ul 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 pe care le acceptă 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:

Feed-ul sau web scraping-ul nu funcționează? Depanarea surselor de cunoștințe Mira AI

Înainte să începeți

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

Pentru a adăuga feed-ul în Smartsupp:

În instrumentul de construcție al asistentului, deschideți Bază de cunoștințe → Produse și faceți clic pe Adăugați.
Introduceți o denumire pentru sursă.
Lipiți URL-ul complet al feed-ului dvs. de produse.
În pasul Actualizați, alegeți cât de des să se actualizeze feed-ul.

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

Mira AI actualizează automat feed-ul de produse la intervale regulate — modificările de preț, actualizările de disponibilitate și produsele noi apar în chat fără ca dvs. să încărcați din nou fișierul.

Notă: Mira AI încarcă imaginile pentru cardul de produs direct din feed-ul XML. Dacă un produs nu are imagine în feed, Mira folosește imaginea Open Graph sau imaginea reprezentativă de pe pagina produsului — de aceea merită să le configurați și pe acestea.

Notă: Dacă serverul dvs. restricționează conexiunile primite (firewall, lista albă IP), asigurați-vă că permiteți accesul din adresele IP ale feed-fetcher-ului Smartsupp: 94.130.187.58 și 188.245.65.74. Altfel, Mira AI nu va putea descărca feed-ul de produse.

Aceste adrese IP se pot schimba ocazional. Dacă feed-ul nu se mai actualizează brusc, 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 feed-uri de produse — Heuréka și Google Merchant. Ambele urmează convenții XML uzuale:

Extensia fișierului este .xml sau .rss.
Prima linie trebuie să înceapă cu <?xml ...?> sau <rss ...>.
O singură etichetă părinte înconjoară toate produsele. Poate avea orice denumire (de exemplu <SHOP>) — contează doar existența acesteia.
Fiecare produs este încadrat într-o etichetă individuală (vedeți secțiunile specifice 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 pentru un produs, acel produs este omis din indexul Mira — vizitatorii nu îl vor vedea în recomandări. Asigurați-vă că fiecare produs are toate etichetele cerute completate.

Structura feed-ului Heuréka

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

Categorie	Etichete	Note
Învelitoare produs (obligatorie)	`SHOPITEM`, `PRODUCT`, `PRODUKT`	Fiecare produs este încadrat într-una dintre aceste etichete.
Descriere (obligatorie)	`PRODUCTNAME` (sau `PRODUCT`), `DESCRIPTION`, `URL`, `PRICE_VAT`, `CATEGORYTEXT`	Toate etichetele trebuie să aibă conținut. Etichetele goale sunt considerate lipsă.
Voluntar	`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 de oricâte ori per produs.
Imagine	`IMGURL`	Imaginea produsului afișată pe card. Dacă lipsește, Mira folosește imaginea Open Graph sau cea reprezentativă 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ă o caracteristică suplimentară a produsului sub formă de pereche denumire–valoare:

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

Structura feed-ului Google Merchant

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

Categorie	Etichete	Note
Învelitoare produs (obligatorie)	`item`, `entry`, `product`	Fiecare produs este încadrat într-una dintre aceste etichete.
Descriere (obligatorie)	`title`, `description`, `product_type` (sau `google_product_category`), `link`, `price`	Pentru categorie, folosiți `product_type` sau `google_product_category` cu denumirea ca text — momentan nu sunt acceptate ID-urile numerice de categorie.
Format preț	`price`	Format acceptat: `236 CZK` sau `CZK 236`. Sunt acceptate și separatoare zecimale ș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 din 3 litere (CZK, EUR, GBP etc.).
Preț de promoție (opțional)	`sale_price`, `sale_price_effective_date`	Dacă `sale_price` există, este în aceeași monedă și mai mic decât `price`, Mira va menționa prețul promoțional în răspunsuri, căutări și pe cardurile produsului. Cu `sale_price_effective_date`, prețul promoțional este folosit doar în intervalul respectiv (verificare la momentul întrebării); în afara acestuia sau dacă intervalul nu poate fi citit, Mira folosește prețul de bază. Feed-urile existente preiau prețul promoțional la următoarea actualizare.
Voluntar	`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 cea reprezentativă 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 produselor din feed-ul dvs. (eticheta size) și le poate menționa când recomandă produse. Mărimile apar după actualizarea feed-ului.

Notă: ID-urile numerice google_product_category nu sunt încă acceptate. Folosiți mereu varianta text a categoriei — de exemplu „Imbrăcăminte & Accesorii > Îmbrăcăminte > Cămăși & Topuri" — sau folosiți product_type în loc.

Exportul feed-ului după 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	Feed-uri XML • Heuréka XML
Shopsys	Feed-uri de produse prin platformă, cu documentație pentru dezvoltatori	Feed-uri de produse
Eshop-rychle	Feed-uri pentru motoare de comparare a prețurilor	Export produse
Upgates	Export de date XML cu structura completă a produsului	Export 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	Feed-uri Google Shopping & Heuréka	Google Shopping • Heuréka
PrestaShop	Google Shopping prin suplimente	Suplimente
Magento	Google Shopping prin extensii	Extensii
WooCommerce	Feed de produse Google prin suplimente	Suplimente • Recomandat

Ce urmează?

Introducere în Asistentul de cumpărături Mira AI — configurați Mira AI și adăugați feed-ul de produse ca sursă.
Cum să începeți instruirea Mira AI — ajustați răspunsurile AI cu perechi Q&R personalizate.
Mira AI - disponibilitate stoc — permiteți vizitatorilor să verifice dacă un produs este pe stoc.
Întrebări frecvente Asistent cumpărături Mira AI — întrebări comune despre Mira AI.

💡 Aveți nevoie de ajutor suplimentar? Contactați echipa noastră de asistență — suntem bucuroși să vă ajutăm!

Articole similare

Cum să exportați feed-uri de produse din diferite platforme de comerț electronic pentru Asistentul de cumpărături MiraAI?