Direct la conținutul principal

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

Aflați cum să exportați feeduri de produse din platforme populare de comerț electronic și să le conectați cu Asistentul de cumpărături Mira AI pentru a permite recomandări inteligente de produse.

Scris de Michal Jindra

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, tagurile 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 web scraping nu funcționează? Depanarea surselor de cunoștințe Mira AI


Înainte de a începe

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


​
​

Pentru a adăuga feedul în Smartsupp:

  1. În builderul asistentului, deschideți Bază de cunoștințe → Produse și faceți clic pe Adăugați.

  2. Introduceți o denumire pentru sursă.

  3. Lipiți URL-ul complet al feedului dvs. de produse.

  4. La pasul Actualizați, alegeți cât de des trebuie să se actualizeze 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 de disponibilitate și produsele noi apar în chat fără să fie nevoie să încărcați din nou fișierul.

Notă: Mira AI încarcă imaginile din cardul produsului direct din feedul XML. Dacă un produs nu are imagine în feed, Mira AI va folosi Open Graph sau imaginea principală din pagina produsului — așa că merită să le configurați și pe acestea.

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

Aceste adrese IP se pot schimba ocazional. Dacă feedul dvs. nu se mai actualizează brusc, consultați acest articol pentru lista actuală 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 urmează convenții XML comune:

  • Extensia fișierului este .xml sau .rss.

  • Prima linie trebuie să înceapă cu <?xml ...?> sau <rss ...>.

  • Un tag părinte înconjoară toate produsele. Acest tag poate avea orice denumire (de ex. <SHOP>) — contează doar existența lui.

  • Fiecare produs este înconjurat de propriul său tag de item (vezi secțiunile de formate de mai jos).

Un schelet minim valid arată astfel:

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

Important: Dacă un tag obligatoriu lipsește de la un produs, acel produs va fi sărit din indexul Mira AI — vizitatorii nu-l vor vedea în recomandări. Asigurați-vă că fiecare produs are toate tagurile obligatorii completate.


Structura feedului Heuréka

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

Categorie

Taguri

Note

Wrapper de item (obligatoriu)

SHOPITEM, PRODUCT, PRODUKT

Unul dintre aceste taguri înconjoară fiecare produs.

Descriere (obligatoriu)

PRODUCTNAME (sau PRODUCT), DESCRIPTION, URL, PRICE_VAT, CATEGORYTEXT

Fiecare tag trebuie să conțină conținut. Tagurile goale sunt considerate lipsă.

Opțional

DELIVERY_DATE, PARAM

DELIVERY_DATE: 0 = în stoc, 1–7 = disponibil în maxim o săptămână, orice altceva / lipsă = indisponibil. PARAM poate fi repetat de oricâte ori pentru un produs.

Imagine

IMGURL

Imaginea produsului afișată pe card. Dacă lipsește, Mira AI folosește Open Graph sau imaginea principală din pagina produsului.

Ignorat

DELIVERY, EAN, ITEM_ID, VAT, ITEMGROUP_ID, ACCESSORY, MANUFACTURER

Mira AI sare peste aceste taguri — puteți să le lăsați în feed pentru alte instrumente.

Un tag PARAM conține o caracteristică suplimentară de produs ca 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 taguri. Consultați specificația oficială a feedului Google Merchant pentru referințe complete.

Categorie

Taguri

Note

Wrapper de item (obligatoriu)

item, entry, product

Unul dintre aceste taguri înconjoară fiecare produs.

Descriere (obligatoriu)

title, description, product_type (sau google_product_category), link, price

Pentru categorie, utilizați product_type sau google_product_category cu denumirea text — ID-urile numerice de categorie nu sunt încă acceptate.

Format preț

price

Format permis: 236 CZK sau CZK 236. Valuta este un cod de trei litere (CZK, EUR, GBP...).

Preț redus (opțional)

sale_price, sale_price_effective_date

Dacă sale_price este prezent, în aceeași valută și mai mic decât price, Mira AI menționează prețul redus în răspunsuri, căutări de produse și pe cardurile de produs. Cu sale_price_effective_date, prețul redus se va folosi doar în intervalul de date (verificat la momentul întrebării); în afara acestuia sau dacă intervalul nu poate fi citit, Mira AI folosește prețul obișnuit. Feedurile existente preiau prețurile reduse 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 AI folosește Open Graph sau imaginea principală din pagina produsului.

Ignorat

id, gtin, checkout_link_template, item_group_id

Mira AI sare peste aceste taguri — puteți să le lăsați în feed pentru alte instrumente.

Mira AI citește și dimensiunile produselor din feedul dvs. (tagul size) și le poate menționa când recomandă produse. Dimensiunile apar după ce feedul dvs. se actualizează.

Notă: ID-urile google_product_category numerice nu sunt încă acceptate. Folosiți întotdeauna varianta text pentru categorie — de exemplu "Îmbrăcăminte & Accesorii > Haine > Cămăși & Topuri" — sau folosiți product_type în schimb.


Exportați feedul 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

Heuréka & Google Shopping XML din panoul de administrare

Shopsys

Feeduri de produse prin platformă cu documentație pentru dezvoltatori

Eshop-rychle

Feeduri pentru motoarele de comparare de prețuri

Upgates

Export date XML cu structură completă de produse

Shoper

Feed Google de produse direct din platformă

Shopware

Google Shopping — export direct sau prin suplimente

Shoprenter

Feeduri Google Shopping & Heuréka

PrestaShop

Google Shopping prin suplimente

Magento

Google Shopping prin extensii

WooCommerce

Google Product Feed prin suplimente


Ce urmează?

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

Ați primit răspuns la întrebare?