1. FAVI help page
  2. Cerințe privind feed-ul XML
  3. Semnificații și cerințe pentru elementele individuale

Semnificații și cerințe pentru elementele individuale


NUMĂRUL DE IDENTIFICARE (ID) *

ID-ul este o denumire unică pentru fiecare produs din sistemul e-shop. Această denumire nu poate fi schimbată pe parcursul perioadei de cooperare, în caz contrar, istoricul și poziția produsului pot fi pierdute.

În cazul în care mai multe produse au același ITEM_ID, feed-ul XML va fi considerat eronat și actualizarea nu va funcționa.

Elementul poate conține numere, litere minuscule și majuscule fără diacritice și caractere speciale, cum ar fi liniuțe și sublinieri. 

Necesar pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží <ITEM_ID>abc987</ITEM_ID>
Google <g:id>abc987</g:id>
Compari/Árukereső/Pazaruvaj <Identifier>abc987</Identifier>
Ceneo id=“abc987
Jeftinije/Ceneje <![CDATA[abc987]]>

DENUMIREA VARIANTELOR 

Desemnarea variantelor de produse de grup. Produsele care sunt variante diferite ale unui singur produs au un ITEM_ID unic, dar același ITEMGROUP_ID.

Recomandat pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží <ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
Google  <g:item_group_id>ZD563</g:item_group_id>
Compari/Árukereső/Pazaruvaj <GroupId>ZD563</GroupId>
Ceneo nespecificat în specificațiile Ceneo
Jeftinije/Ceneje nespecificat în specificațiile Jeftinije/Ceneje

DENUMIREA UNUI PRODUS *

Denumirea exactă a produsului. Denumirea identifică produsul și ajută la listarea corectă a acestuia în catalog. Denumirea produsului trebuie să fie clară și descriptivă. Nu este indicat să se folosească un nume format dintr-un singur cuvânt, cum ar fi un nume generic al unei colecții sau al unei ediții. 

Produsele sunt categorisite în catalogul nostru în principal pe baza numelui produsului, adică ideal ar trebui ca numele produsului să conțină specificațiile de bază ale produsului, în special denumirea, cum ar fi: lenjerie de pat pentru copii (așadar, nu este potrivit să listăm doar lenjeria de pat, dacă este pentru copii), scaune de grădină, scaune de masă, etc. Numele produsului poate conține numele producătorului sau al mărcii, dar nu și numele sau URL-ul magazinului. Titlul nu ar trebui să conțină informații precum în stoc, reducere, promoții, transport gratuit, etc.

Necesar pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element

Heureka/Zboží

<PRODUCTNAME>MERIDA double bed, 160×200 cm</PRODUCTNAME>
Google  <g:title>MERIDA double bed, 160×200 cm</g:title>
Compari/Árukereső/Pazaruvaj <Name>MERIDA double bed, 160×200 cm</Name>
Ceneo <name>MERIDA double bed, 160×200 cm</name>
Jeftinije/Ceneje <name><![CDATA[MERIDA double bed, 160×200 cm]]></name>

DESCRIEREA PRODUSULUI *

Descrierea produsului. Descrierea trebuie să includă informații despre varianta specifică a produsului. Apreciem utilizarea cuvintelor cheie relevante care ajută la listarea produselor dvs. în filtre. Descrierea produsului trebuie să fie descriptivă și plină de informații care să motiveze clienții să facă o achiziție.

Este mai bine să creați o descriere de produs neformatată, deoarece codificarea dvs. va fi păstrată în catalogul FAVI. Nu este permisă includerea de URL-uri către o altă pagină a magazinului dvs., adrese de e-mail și informații generale de contact.

Pe pagina de detalii a produsului din catalogul FAVI, puteți verifica cum ar trebui să arate descrierea unui anumit produs. În general, sistemul FAVI permite doar următoarele coduri html:

  • <p> </p>, 
  • <b> </b>,
  • <strong> </strong>,
  • <i> </i>,
  • <em> </em>, 
  • <br>, 
  • <ul> </ul>,
  • <li> </li>,
  • <ol> </ol>.

Alte coduri și formate nu sunt acceptate. Utilizarea acestora poate distruge textul și reduce calitatea acestuia. Aveți grijă, de asemenea, la codificarea unui caracter special, dacă acesta este necesar. De exemplu, simbolul ampersandă (&) trebuie codificat cu șirul ASCII &lt;li&gt dacă nu utilizați CDATA pentru trimiterea de informații.  

Necesar pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed

Element

Heureka/Zboží

<DESCRIPTION>Modern bed is made from …</DESCRIPTION>
Google <g:description>Modern bed is made from …</g:description>

Compari/Árukereső/Pazaruvaj

<Description>Modern bed is made from…</Description>

Ceneo

<desc><![CDATA[Modern bed is made from …]]></desc>

Jeftinije/Ceneje

<description>![CDATA[Modern bed is made from …]]></description>


CATEGORIA DE PRODUSE *

Categoria de produse. Categoria determină în primul rând clasificarea produsului în catalog și ar trebui să fie specificată cât mai exact posibil. Este permisă trimiterea categoriilor în conformitate cu arborele de categorii FAVI sau puteți, de asemenea, să specificați propriile categorii, dacă acestea sunt suficient de detaliate. Cel mai bine este să clasificați întotdeauna întregul traseu al produsului - de exemplu, Dormitor>Cameră>Cușete. 

Arborele complet al categoriilor pentru toate țările este disponibil aici:

Catalogul FAVI va încărca automat toate produsele care sunt listate în feed-ul XML, cu condiția să includă o categorie corespunzătoare, un link valid și o imagine de dimensiuni adecvate.

Pentru fiecare produs, elementul categorie trebuie menționat o singură dată în feed-ul XML. În cazul în care produsul nu are o categorie, acesta nu se va încărca în catalog.

Următoarele categorii vor fi, de asemenea, respinse pentru import:

  • Categorii care nu se aplică în catalog;
  • Categorii foarte generale (cum ar fi reduceri, vânzări, promoții, nume de camere etc.);
  • Categorii care nu sunt în limba corespunzătoare.

Categoriile nu ar trebui să fie schimbate frecvent. Schimbarea categoriilor va elimina produsele din catalog până când categoriile nou trimise sunt aprobate din nou.

Necesar pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed

Element

Heureka/Zboží

<CATEGORYTEXT>Bedrooms > Beds</CATEGORYTEXT>

Google **

<g:google_product_category>Bedrooms> Beds</g:google_product_category>

<g:product_type>Bedrooms > Beds > single</g:product_type>

Compari/Árukereső/Pazaruvaj

<Category>Bedrooms > Beds</Category>

Ceneo

<cat>
<![CDATA[Bedrooms > Beds]]>
</cat>

Jeftinije/Ceneje

<fileUnder><![CDATA[Bedrooms > Beds]]></fileUnder>


PREȚUL PRODUSULUI (TVA INCLUS) *

Prețul total al produsului, inclusiv TVA (taxa pe valoarea adăugată). Sistemul FAVI acceptă prețurile numai în următoarele formate: 

  • 8 000
  • 8000
  • 8000,70
  • 8000.70

Vă rugăm să nu folosiți un punct pentru a separa mii și milioane. Punctul poate fi folosit doar ca separator zecimal. Sistemul FAVI rotunjește automat numărul la două zecimale.

Reducerile pentru produsele din catalogul FAVI sunt generate automat de sistem pe baza istoricului prețurilor de bază stocate. În cazul în care prețul din feed-ul XML este redus, prețul produsului din FAVI va fi, de asemenea, redus, iar valoarea reducerii va fi calculată. Prin urmare, nu primim informații privind reducerile de la nicio intrare specială din feed-ul XML. 

Necesar pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed

Element
Heureka/Zboží <PRICE_VAT>4500</PRICE_VAT>
Google 

<g:price>5500</g:price>
for product in sale: <g:sale_price>4500</g:sale_price>

Compari/Árukereső/Pazaruvaj <Price>4500</Price>
Ceneo price=“4500″
Jeftinije/Ceneje <price>659.90</price>

URL *

URL-ul specifică un link către site-ul web al magazinului dvs. electronic. Pagina de destinație a produsului trebuie să includă prețul produsului, informații specifice despre produs și un buton pentru a cumpăra sau comanda produsul. URL-ul trebuie să fie unic în cadrul feed-ului XML, în caz contrar, produsele cu același link vor fi comasate.

URL-ul trebuie să fie valid, nu sunt permise spațiile sau diacriticele, iar caracterele speciale trebuie să fie folosite într-o formă HTML specifică, în caz contrar, produsele nu vor fi încărcate în catalog.

Necesar pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží <URL>https://www.url.com/bed-merida.html#/90x200_cm</URL>
Google <g:link>https://www.url.com/bed-merida.html#/90x200_cm</g:link>
Compari/Árukereső/Pazaruvaj <Product_url>https://www.url.com/bed-merida.html#/90x200_cm</Product_url>
Ceneo

url=“https://www.url.com/bed-merida.html#/90x200_cm″

Jeftinije/Ceneje

<link><![CDATA[https://www.url.cz/merida.html#/90x200_cm]]></link>


IMAGINEA PRINCIPALĂ *

Imaginea principală a produsului, ca unul dintre cele mai importante aspecte ale feed-ului XML, trebuie să îndeplinească următoarele criterii:

1) Produsul din imaginea principală nu trebuie să fie în contradicție cu specificațiile sale - adică cu denumirea sau descrierea sa. Aceasta se aplică în special în cazurile în care imaginea produsului față de specificațiile sale este:

  • într-un decor sau culoare diferită (un scaun în decor fag nu trebuie să aibă în imagine un scaun în decor nuc),
  • într-o dimensiune diferită (un autocolant de 25 x 25 cm nu ar trebui să fie prezentat în imagine pe întregul perete etc.).
  • afișat cu mai multe produse decât este disponibil pentru prețul produsului (de exemplu, afișarea întregului set de dormitor, când prețul dat include doar un dulap; sau afișarea unui set întreg care include o masă cu scaune, când prețul dat include doar o masă; sau afișarea produsului într-o culoare diferită) Imaginea ar trebui să afișeze doar numărul de articole vândute în set (de exemplu, un set de două scaune nu ar trebui să includă mai mult de două scaune în imagine). Alternativ, va fi tolerată utilizarea unui număr pentru a indica numărul de produse identice dintr-un pachet (set) (de exemplu, este permisă afișarea unei imagini cu un scaun cu numărul "2" în colț pentru a indica faptul că setul conține două scaune). Cu toate acestea, cifrele nu trebuie să acopere produsul sau să distragă atenția în alt mod: din acest motiv, cel mai bine este să plasați numărul în colțul imaginii).

2) Produsul din imaginea principală trebuie să fie reprezentat printr-o fotografie reală: nu este permisă utilizarea unei schițe sau a unei ilustrații. 

3) Vă rugăm să trimiteți imaginile în format de fișier PNG sau JPEG.

4) Imaginea principală trebuie să fie de cel puțin 600 x 600 px. Cu toate acestea, se recomandă să trimiteți cea mai mare dimensiune posibilă, în mod ideal peste 1000 x 1000 px.

5) Produsul din imaginea principală trebuie să fie prezentat în întregime și, prin urmare, nu doar o anumită parte sau un detaliu.

6) Este permisă afișarea produsului pe un fundal alb. În cazul în care produsul este încorporat într-un decor interior, produsul trebuie să fie suficient de proeminent în imagine pentru ca clientul să știe la prima vedere despre ce produs este vorba.

7) Imaginea principală nu trebuie să conțină text suplimentar sau alte modificări grafice (pictograme, filigrane, logo-uri, marcaje 1 + 1, reduceri, arcuri etc.).

8) Atunci când se afișează variante de culoare, imaginea principală nu trebuie să fie doar un pătrat colorat. Fiecare imagine a unei variante de culoare trebuie să prezinte produsul real.

9) Nu este permisă încorporarea imaginii într-un chenar.

În cazul în care o imagine nu îndeplinește criteriile de mai sus, aceasta poate fi blocată pentru afișare. Toate imaginile suplimentare care sunt disponibile (desene, detalii, fotografii de interior și de compoziție) trebuie trimise ca imagini alternative, care vor fi afișate direct pe pagina de detalii a produsului din catalogul FAVI.

În cazul în care produsul este blocat de la afișare ca urmare a nerespectării oricăruia dintre criteriile de listare a imaginilor de mai sus, iar sistemul detectează ulterior o modificare a imaginii, imaginea va fi reevaluată, iar produsul poate fi reintrodus în catalog. Cu toate acestea, pentru a modifica imaginea, trebuie să modificați și URL-ul din feed-ul XML. O nouă imagine va fi încărcată numai dacă sistemul detectează o modificare a URL-ului. Dacă nu se face nicio modificare, imaginea originală este păstrată.

URL-ul pentru imaginea principală (și alternativă) a produsului trebuie să îndeplinească următoarele condiții:

  • URL-ul imaginii nu trebuie să conțină spații. Spațiul trebuie înlocuit manual cu semnul "%20": sistemul nostru nu îl înlocuiește automat.
  • URL-ul imaginii nu trebuie să conțină accente sau diacritice.
  • URL-ul imaginii nu trebuie să fie blocat. În cazul în care sistemul FAVI nu poate descărca imaginea din cauza unui URL blocat de server, produsul nu va fi încărcat în catalog.
  • URL-ul imaginii trebuie să fie securizat cu un certificat HTTPS

Trebuie ținut cont de faptul că, în cazul în care imaginea este actualizată pentru produsul încărcat, iar noul URL al acestuia este indisponibil (blocat, cu spații sau accente), produsul va fi dezactivat din catalog.

Necesar pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží <IMGURL>https://www.url.com/bed-merida.jpg</IMGURL>
Google <g:image_link>https://www.url.com/bed-merida.jpg</g:image_link>
Compari/Árukereső/Pazaruvaj <Image_url>https://www.url.com/bed-merida.jpg</Image_url>
Ceneo <imgs><main url=“https://www.url.com/bed-merida.jpg“/></imgs>
Jeftinije/Ceneje <mainImage><![CDATA[https://www.url.com/bed-merida.jpg]]></mainImage>

IMAGINI ALTERNATIVE

URL-ul pentru imaginile alternative ale produselor. Alte imagini furnizate sunt afișate pe pagina de detalii a produsului. Numărul maxim de imagini este de 20.

În imaginile alternative, este indicat să se furnizeze:

  • fotografii ale produsului în interiorul unei încăperi,
  • fotografii ale produsului alături de alte produse (de exemplu, din aceeași colecție),
  • produsul din diferite unghiuri,
  • imagini mai detaliate ale anumitor părți ale produsului,
  • schițe care să arate dimensiunile etc.

Recomandat pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží <IMGURL_ALTERNATIVE>https://www.url.com/bed-merida2.jpg</IMGURL_ALTERNATIVE>
Google  <g:additional_image_link>https://www.url.com/bed-merida2.jpg</g:additional_image_link>
Compari/Árukereső/Pazaruvaj <Image_url_2>https://www.url.com/bed-merida2.jpg</Image_url_2>
Ceneo

<imgs><i url=“https://www.url.com/bed-merida2.jpg“/></imgs>

Jeftinije/Ceneje

<moreImages><![CDATA[https://www.url.com/bed-merida2.jpg,https://www.url.com/bed-merida3.jpg]]
></moreImages>


PARAMETRI  

Parametrii produsului. Parametrii sunt caracteristici specifice ale unui produs individual. Cu cât închideți mai mulți parametrii, cu atât aveți șanse mai mari de succes în cadrul campaniei dumneavoastră. În special, vă rugăm să furnizați specificații ale produsului care nu sunt evident vizibile din imagine.


Parametrii foarte recomandați includ: material, formă, model, textură, culoare, decor, stil, dimensiuni și alte caracteristici specifice produsului care ar putea fi importante.

Puteți găsi mai multe informații despre parametrii și specificațiile acestora aici. Unele dintre parametrii sunt utilizați pentru sortarea produselor în filtre specifice.

Clienții care utilizează filtre sunt, în general, mai predispuși să cumpere. Pentru a evita pierderea acestor clienți, verificați starea actuală a parametrilor dumneavoastră. Pentru a lista produsele dumneavoastră în filtrul "dimensiuni", asigurați-vă că trimiteți fiecare dimensiune în parametrii separați - înălțime separat, lățime separat, adâncime separat etc. Dacă acest lucru nu este respectat, nu va fi posibil să găsiți produsul prin filtrul "dimensiuni". Dimensiunile recomandate pentru fiecare categorie pot fi găsite în lista de categorii aici.

 

Principii generale pentru parametrii

  1. Nu trimiteți valori multiple ale parametrilor decât dacă acestea se potrivesc exact cu varianta produsului, vezi exemplul (decor, alte dimensiuni și culori disponibile); imaginea principală trebuie să corespundă descrierii și parametrilor furnizați.
  2. Atunci când creați parametrii, nu este necesar să copiați exact formularea filtrelor noastre din categorii. Vom combina denumirile ușor diferite dacă le primim în acest mod de la mai mulți parteneri.
  3. Listați unitățile de măsură pentru valorile numerice (cm, mm, l, etc.).
  4. Fiecare produs ar trebui să conțină propria specificație. Nu duplicati valorile parametrilor, vezi exemplul.
  5. Valorile parametrilor precum da x nu sunt acceptate, dar valorile 0 x 1 nu sunt.
  6. Trimiteți parametrii cât mai exact posibil. Nu introduceți valori multiple pe mai multe rânduri într-o singură înregistrare.
  7. Parametrii trebuie să fie traduse în limba țării respective.
  8. Dimensiunile trebuie trimise în parametrii separați - înălțime separat, lățime separat, adâncime separat etc.

Parametrii furnizați sunt afișați într-un tabel pe pagina de detaliu a produsului. Tabelul va fi vizibil pentru clienți doar dacă trimiteți mai mult de 3 parametri diferiți.

 

Specificarea parametrilor este foarte recomandată.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží  <PARAM>
  <PARAM_NAME>Height</PARAM_NAME>
  <VAL>95 cm</VAL>
</PARAM>
Google

<g:color>brown</g:color>
<g:material>solid wood, beech</g:material>
<g:pattern>striped</g:pattern>

<g:product_detail>
   <g:section_name>Size</g:section_name>
   <g:attribute_name>Height</g:attribute_name>
   <g:attribute_value>95 cm</g:attribute_value>
</g:product_detail>

Compari/Árukereső/Pazaruvaj

<Attributes>
  <Attribute>
    <Attribute_name>Height</Attribute_name>
    <Attribute_value>95 cm</Attribute_value>
  </Attribute>
</Attributes>

Ceneo

<attrs>
   <a name=“Height“>
     <95 cm>
   </a>
</attrs>

Jeftinije/Ceneje

<attributes>
<name><![CDATA[Height]]></name>
<values>
<value><![CDATA[95 cm]]></value>
</values>
</attribute>
</attributes>


DISPONIBILITATEA PRODUSULUI*

Termenul de expediere a produsului (măsurat în zile) de la primirea plății (în cazul plății în avans) sau de la primirea comenzii (în cazul plății la livrare).

Produsele de stoc din catalog sunt produse marcate, care conțin următoarele:

  • DELIVERY_DATE valoarea 0, 1, 2 sau 3 (Heureka/Zboží)
  • Delivery_Time valoarea 0, 1, 2 sau 3 (Compari/Árukereső) 
  • Disponibilitatea elementului "in stock" sau "in_stock" (Google)
  •  Avail valoare 0, 1, 2 sau 3 (Ceneo) 

Alte valori decât acestea se vor reflecta în clasamentul total al produsului, așa că este cu siguranță recomandat să specificați o dată de livrare. Cu toate acestea, este necesar, de asemenea, ca valoarea specificată pentru termenul de livrare să corespundă termenului de livrare care este menționat în magazinul dvs. electronic, așa cum se vede după ce faceți click pe link-ul de la FAVI. 

Necesar pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží <DELIVERY_DATE>0</DELIVERY_DATE> **
Google

<g:availability>in stock</g:availability>

or

<g:availability>in_ stock</g:availability>

Compari/Árukereső/Pazaruvaj <Delivery_Time>0</Delivery_Time> **
Ceneo avail=“1″ **
Jeftinije/Ceneje <stock>in stock</stock>

** În elementele DELIVERY_DATE, Delivery_Time, o disponibilitate completează un număr, nu un interval de valori.


 OPȚIUNI DE LIVRARE 

Specificarea opțiunilor de livrare a produselor către client.

Poate exista mai mult de o metodă de livrare pentru un singur produs și este recomandat să includeți costul de transport. Acest lucru va crește scorul general al produselor.

Noi considerăm doar livrarea la domiciliu în calculul calității produsului, nu și livrarea la puncte de colectare.

Eticheta de transport gratuit va apărea pe produs dacă una dintre opțiunile de livrare valide este listată cu prețul 0.

Foarte recomandat pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží <DELIVERY>
   <DELIVERY_ID>PPL</DELIVERY_ID>
   <DELIVERY_PRICE>0</DELIVERY_PRICE>
   <DELIVERY_PRICE_COD>20</DELIVERY_PRICE_COD>
</DELIVERY>
Google  <g:shipping>
    <g:price>0 RON</g:price>
</g:shipping>
Compari/Árukereső/Pazaruvaj

<Delivery_Cost>FREE</Delivery_Cost>

sau următoarea denumire: gratuit, gratis, fara cost; ingyenes, ingyen, ingyenesen; безплатно, безплатен, безплатна.

Ceneo nespecificat
Jeftinije/Ceneje <deliveryCost>0</deliveryCost>

GTIN (EAN)

Numărul Global Trade Item (GTIN) este un număr unic atribuit unui produs specific. Dacă produsele dvs. nu au un număr GTIN, acesta poate fi obținut pe site-urile sistemului GS1.

Nu includeți niciodată identificatori numerici interni ai produsului în GTIN, sunt permise doar codurile de produs oficiale.

GTIN este recunoscut ca valid în sistemul nostru dacă îndeplinește următoarele criterii:

Includerea acestui element este foarte recomandată.

Specificațiile de feed Element

Heureka/Zboží

<EAN>6417182041488</EAN>
Google <g:gtin>6417182041488</g:gtin>
Compari/Árukereső/Pazaruvaj <EAN_code>6417182041488</EAN_code>
Jeftinije/Ceneje <EAN><![CDATA[6417182041488]]></EAN>

 

FABRICANT

Precizează producătorul produsului.

Foarte recomandat pentru fiecare produs.

Exemplele depind de feed-ul XML pe care îl utilizați în FAVI:

Specificație XML feed Element
Heureka/Zboží <MANUFACTURER>Joinery XYZ</MANUFACTURER>
Google  <g:brand>Joinery XYZ</g:brand>
Compari/Árukereső/Pazaruvaj <Manufacturer>Joinery XYZ</Manufacturer>
Ceneo <attrs>
   <a name=“Manufacturer“>
     <![CDATA[Joinery XYZ]]>
    </a>
</attrs>
Jeftinije/Ceneje <brand><![CDATA[Joinery XYZ]]></brand>

 

* indică un element obligatoriu