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

Required elements:

NUMĂRUL DE IDENTIFICARE (ID)*  |  DENUMIREA UNUI PRODUS* | DESCRIEREA PRODUSULUI* | CATEGORIA DE PRODUSE*  | PREȚUL PRODUSULUI* |  URL* |  IMAGINEA PRINCIPALĂ* |  DISPONIBILITATEA PRODUSULUI*

Recommended elements:

DENUMIREA VARIANTELOR |  IMAGINI ALTERNATIVE |  PARAMETRI  | OPȚIUNI DE LIVRARE  |  FABRICANT


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ő: <Identifier>abc987</Identifier>
Ceneo id=“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ő: <GroupId>ZD563</GroupId>
Ceneo not specified in Ceneo specification

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ő <Name>MERIDA double bed, 160×200 cm</Name>
Ceneo <name>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ő

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

Ceneo

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


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ő

<Category>Bedrooms > Beds</Category>

Ceneo

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


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ő: <Price>4500</Price>
Ceneo price=“4500″

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ő: <Product_url>https://www.url.com/bed-merida.html#/90x200_cm</Product_url>
Ceneo

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


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.

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ő: <Image_url>https://www.url.com/bed-merida.jpg</Image_url>
Ceneo <imgs><main url=“https://www.url.com/bed-merida.jpg“/></imgs>

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ő: <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>


PARAMETRI  

Parametrii produsului. Informațiile furnizate sub formă de parametri sunt prezentate în tabelul de pe pagina de detalii a produsului. Dacă trimiteți mai mulți parametri pentru produsele dvs., campania dvs. va avea probabil mai mult succes. În special, vă rugăm să furnizați specificațiile produsului care nu sunt vizibile în mod evident din imagine.

Parametrii foarte recomandați includ:

  • material,
  • forma,
  • model,
  • textura,
  • culoarea, 
  • decor, 
  • stil, 
  • dimensiuni,
  • alte caracteristici specifice produsului care ar putea fi importante.

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ő:

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

Ceneo

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


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ő: <Delivery_Time>0</Delivery_Time> **
Ceneo avail=“1″ **

** Î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 CZK</g:price>
</g:shipping>
Compari/Árukereső:

<Delivery_Cost>FREE</Delivery_Cost>

sau următoarea denumire: gratuit, gratis, fara cost, ingyenes; ingyen, ingyenesen.

Ceneo nespecificat

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ő: <Manufacturer>Joinery XYZ</Manufacturer>
Ceneo <attrs>
   <a name=“Manufacturer“>
     <![CDATA[Joinery XYZ]]>
    </a>
</attrs>

 

* indică un element obligatoriu