1. FAVI help page
  2. Requisiti per il file XML
  3. Significati e requisiti dei singoli elementi

Significato e requisiti dei singoli elementi


NUMERO IDENTIFICATIVO (ID) *

L'ID è una designazione unica per ogni prodotto nel sistema e-shop. La designazione non può essere modificata durante il periodo di collaborazione, altrimenti la storia e la posizione del prodotto potrebbero andare perse.

Nel caso in cui più prodotti abbiano lo stesso ITEM_ID, il feed XML sarà considerato difettoso e l'aggiornamento non funzionerà.

L'elemento può contenere numeri, lettere minuscole e maiuscole senza diacritici e caratteri speciali come trattini e underscore. 

Richiesto per ogni prodotto

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML Elemento
Heureka/Zboží <ITEM_ID>abc987</ITEM_ID>
Google <g:id>abc987</g:id>
Compari/Árukereső: <Identifier>abc987</Identifier>
Ceneo id=“abc987

DESIGNAZIONE DI VARIANTI

Designazione delle varianti di gruppo di prodotti. I prodotti che sono diverse varianti di un singolo prodotto hanno un ITEM_ID unico ma lo stesso ITEMGROUP_ID.

Reccomandato per ogni prodotto

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML Elemento
Heureka/Zboží <ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
Google  <g:item_group_id>ZD563</g:item_group_id>
Compari/Árukereső: <GroupId>ZD563</GroupId>
Ceneo non specificato per Ceneo feed

NOME DI UN PRODOTTO*

Nome esatto del prodotto. Per una corretta inclusione nel catalogo, il nome del prodotto deve essere sufficientemente descrittivo. Non è opportuno indicare un nome di prodotto di una sola parola, ad esempio il nome di una collezione o di un'edizione.

I prodotti sono classificati nel nostro catalogo principalmente sulla base del nome del prodotto, cioè idealmente il nome del prodotto dovrebbe contenere le specifiche di base del prodotto, in particolare la denominazione, come ad esempio: biancheria da letto per bambini (quindi non è appropriato elencare solo la biancheria da letto, se si tratta di biancheria da letto per bambini). , sedie da giardino, sedie da pranzo, ecc.
Il nome del prodotto può contenere il nome del produttore o del marchio, ma non il nome del negozio o l'URL del negozio. Inoltre, il titolo non deve contenere informazioni come "in stock", "in vendita", "in promozione", "spedizione gratuita", ecc.

Richiesto per ogni prodotto

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML Elemento

Heureka/Zboží

<PRODUCTNAME>MERIDA double bed, 160×200 cm</PRODUCTNAME>
Google  <title>MERIDA double bed, 160×200 cm</title>
Compari/Árukereső <Name>MERIDA double bed, 160×200 cm</Name>
Ceneo <name>MERIDA double bed, 160×200 cm</name>

DESCRIZIONE PRODOTTO *

Descrizione del prodotto. La descrizione deve includere informazioni sulla specifica variante del prodotto. Accogliamo con favore l'uso di parole chiave pertinenti che aiutano a elencare i vostri prodotti in filtri. La descrizione del prodotto deve essere descrittiva e piena di informazioni che motiva i clienti a fare un acquisto.

È meglio creare una descrizione del prodotto non formattata, poiché la codifica verrà mantenuta nel catalogo FAVI. Non è consentito includere URL in un'altra pagina del tuo negozio, indirizzi e-mail e informazioni di contatto generali.

Nella scheda prodotto del catalogo FAVI è possibile verificare come deve essere descritta una determinata voce. In generale, il sistema FAVI permette solo i seguenti codici html:

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

Altri codici e formati non sono supportati. Il loro utilizzo può distruggere il testo e ridurne la qualità. Prestare attenzione anche quando si codifica un carattere speciale se necessario.  Ad esempio, il simbolo ampersand (&) deve essere codificato con la stringa ASCII &lt;li&gt se non si utilizza CDATA per l'invio di informazioni.  

Richiesto per ogni prodotto:

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML

Elemento

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 PRODOTTO *

Categoria di prodotto. La categoria determina la classificazione del prodotto nel catalogo e deve essere specificata nel modo più accurato possibile. È consentito l'invio di categorie in base all'elenco delle categorie FAVI oppure è possibile specificare le proprie categorie se sufficientemente dettagliate. È meglio categorizzare sempre l'intero percorso del prodotto - per esempio, Camera da letto>Letti. 

Liste complete delle categorie per tutti i paesi sono disponibili qui:

Il catalogo FAVI caricherà automaticamente tutti i prodotti elencati nel feed XML a condizione che includa una categoria appropriata, un link valido e un'immagine di dimensioni adeguate.

Per ciascun prodotto, l'elemento categoria deve essere menzionato una sola volta nel feed XML. Se il prodotto non ha una categoria, non verrà caricato nel catalogo.

Anche le seguenti categorie saranno respinte per l'importazione:

  • categorie non applicabili al catalogo
  • categorie molto generali (come sconti, vendite, promozioni, nomi di camere, ecc.)
  • categorie che non sono nella lingua appropriata.

Le categorie non devono essere cambiate frequentemente. La modifica delle categorie rimuoverà i prodotti dal catalogo fino a quando le categorie appena presentate non saranno nuovamente approvate.

Richiesto per ogni prodotto:

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML

Elemento

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>


PREZZO PRODOTTO (VAT INCLUSO) *

Prezzo totale del prodotto IVA inclusa (IVA). Il sistema FAVI accetta i prezzi solo nei seguenti formati: 

  • 8 000
  • 8000
  • 8000,70
  • 8000.70

Non usare un punto per separare migliaia e milioni. Il punto può essere usato solo come separatore decimale. Il sistema FAVI arrotonda automaticamente il numero a due cifre decimali.

Gli sconti per i prodotti del catalogo FAVI vengono generati automaticamente dal sistema in base alla cronologia dei prezzi base memorizzati. Se il prezzo nel feed XML viene ridotto, anche il prezzo del prodotto su FAVI verrà ridotto e verrà calcolato l'importo dello sconto. Pertanto, non riceviamo informazioni sugli sconti da alcuna voce speciale nel feed XML. 

Richiesto per ogni prodotto:

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML

Elemento 
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 *

L'URL specifica un link al sito web del prodotto del tuo e-shop. La pagina di destinazione del prodotto deve includere il prezzo del prodotto, informazioni specifiche sul prodotto e un pulsante per acquistare o ordinare il prodotto. L'URL deve essere univoco all'interno del feed XML, altrimenti i prodotti con lo stesso link verranno uniti.

L'URL deve essere valido, non sono consentiti spazi o segni diacritici e devono essere utilizzati caratteri speciali in un modulo HTML specifico, altrimenti i prodotti non verranno caricati nel catalogo.

Richiesto per ogni prodotti:

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML Elemento
Heureka/Zboží <URL>https://www.url.com/bed-merida.html#/90x200_cm</URL>
Google <link>https://www.url.com/bed-merida.html#/90x200_cm</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″


IMMAGINE PRINCIPALE *

L'immagine principale del prodotto, come uno degli aspetti più importanti del feed XML, deve soddisfare i seguenti criteri:

1) Il prodotto nella figura principale non deve essere in conflitto con la sua specifica - cioè con il suo nome o descrizione. Ciò vale in particolare nei casi in cui l'immagine del prodotto rispetto la sua specifica è:

  • in un arredamento diverso o colore (una sedia in arredamento di faggio non dovrebbe avere una sedia in arredamento di noce nella foto),
  • in una dimensione diversa (un adesivo di 25 x 25 cm non dovrebbe essere mostrato nella foto su tutta la parete, ecc.)
  • visualizzato con più prodotti di quello disponibile per il prezzo del prodotto (ad es. visualizzare l'intero set camera da letto quando il prezzo indicato include solo un armadio; o visualizzare un intero set compreso un tavolo con sedie quando il prezzo indicato include solo un tavolo; o visualizzare il prodotto in un colore diverso) L'immagine dovrebbe mostrare solo il numero di articoli venduti nel set (ad es. un set di due sedie non dovrebbe includere più di due sedie nell'immagine). In alternativa, sarà tollerato l'uso di un numero per indicare il numero di prodotti identici in una confezione (set) (ad es. è consentito visualizzare un'immagine con una sedia con il numero '2' nell'angolo per indicare che il set contiene due sedie). Tuttavia, le cifre non devono coprire il prodotto o essere altrimenti distraenti: per questo motivo, è meglio posizionare il numero nell'angolo dell'immagine).

2) Il prodotto nel l'immagine principale deve essere rappresentato da una fotografia reale: non è consentito utilizzare uno schizzo o un'illustrazione. 

3) Inviare le immagini in formato PNG o JPEG.

4) L'immagine principale deve essere almeno 600 x 600 px. Tuttavia, si consiglia di inviare la dimensione più grande possibile, idealmente oltre 1000 x 1000 px.

5) Il prodotto nel l'immagine principale deve essere mostrato nella sua interezza e quindi non solo in una parte o in un dettaglio.

6) È consentito esporre il prodotto su fondo bianco. Se il prodotto è incorporato in un ambiente interno, il prodotto deve essere abbastanza prominente nell'immagine in modo che il cliente sappia a prima vista quale prodotto è.

7) L'immagine principale non deve contenere alcun testo aggiuntivo o altre modifiche grafiche (icone, filigrane, loghi, marcature 1 + 1, sconti, archi ecc.).

8) Quando si visualizzano varianti di colore, l'immagine principale non deve essere solo un quadrato colorato. Ogni immagine di una variante di colore deve visualizzare il prodotto effettivo.

9) Non è consentito incorporare l'immagine in un bordo.

Se un'immagine non soddisfa i criteri di cui sopra, può essere bloccata dalla visualizzazione. Tutte le immagini aggiuntive disponibili (disegni, dettagli, foto di interni e di composizione) devono essere inviate come immagini alternative, che verranno visualizzate direttamente nella pagina di dettaglio del prodotto nel catalogo FAVI.

Se il prodotto viene bloccato dalla visualizzazione a causa della non conformità con uno qualsiasi dei criteri di elenco delle immagini di cui sopra e il sistema rileva successivamente una modifica dell'immagine, l'immagine verrà nuovamente valutata e il prodotto può essere restituito al catalogo. Tuttavia, per modificare l'immagine, è necessario modificare l'URL nel feed XML.  Una nuova immagine verrà caricata solo se il sistema rileva una modifica dell'URL. Se non viene apportata alcuna modifica, l'immagine originale viene mantenuta.

L'URL dell'immagine principale (e alternativa) del prodotto deve soddisfare le seguenti condizioni:

  • L'URL dell'immagine non deve contenere spazi. Lo spazio deve essere sostituito manualmente dal segno "%20": il nostro sistema non lo sostituisce automaticamente.
  • L'URL dell'immagine non deve contenere accenti o segni diacritici.
  • L'URL dell'immagine non deve essere bloccato.  Se il sistema FAVI non è autorizzato a scaricare l'immagine a causa di un blocco URL da parte del server, il prodotto non verrà caricato nel catalogo.

Si tenga conto che se l'immagine viene aggiornata per il prodotto caricato e il suo nuovo URL non è disponibile (bloccato, con spazi o accenti), il prodotto verrà disattivato all'interno del catalogo.

Richiesto per ogni prodotti:

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML Elemento
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>

IMMAGINI ALTERNATIVE

L'URL per immagini alternative del prodotto.  Altre immagini fornite sono mostrate nella pagina dei dettagli del prodotto. Il numero massimo di immagini è 20. 

In immagini alternative, è opportuno fornire:

  • foto del prodotto all'interno di una stanza,
  • foto del prodotto accanto ad altri prodotti (ad es. della stessa collezione),
  • il prodotto da diverse angolazioni,
  • immagini più dettagliate di parti particolari del prodotto,
  • schizzi che mostrano le dimensioni, ecc.

Reccomandato per ogni prodotto.

Gli esempi dipendono dal feed XML utilizzato su FAVI:

Specificazione feed XML Elemento
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

Parametri del prodotto. Le informazioni fornite sotto forma di parametri sono mostrate nella tabella nella pagina di dettaglio del prodotto. Se invii più parametri per i tuoi prodotti, la tua campagna avrà probabilmente più successo. In particolare, si prega di fornire le specifiche del prodotto che non sono ovviamente visibili dall'immagine.

I parametri altamente raccomandati includono: 

  • materiale,
  • forma,
  • modella,
  • consistenza,
  • colore, 
  • decorazione, 
  • stile, 
  • dimensione,
  • altre caratteristiche specifiche del prodotto che potrebbero essere importanti.

Si consiglia vivamente di specificare i parametri.

Gli esempi dipendono da quale feed XML utilizzi su FAVI:

Specificazione feed XML Elemento
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>


DISPONIBILITÀ PRODOTTI *

Tempistica della spedizione del prodotto (misurata in giorni) dal ricevimento del pagamento (in caso di pagamento anticipato), o dal ricevimento dell'ordine (in caso di pagamento alla consegna).

I prodotti di scorta nel catalogo sono prodotti contrassegnati, che contengono i seguenti:

  • DELIVERY_DATE valore 0, 1, 2 o 3 (Heureka/Zboží)
  • Delivery_Time valore 0, 1, 2 o 3 (Compari/Árukereső) 
  • “in stock” o "in_stock" elemento disponibilità (Google)
  •  disp valore 0, 1, 2 o 3 (Ceneo) 

Valori diversi da questi si rifletteranno nella classifica totale del prodotto, quindi è sicuramente consigliabile specificare una data di consegna. Tuttavia, è anche necessario che il valore specificato per il tempo di consegna corrisponda al tempo di consegna indicato nel tuo e-shop, come si vede dopo aver cliccato sul link di FAVI. 

Richiesto per ogni elemento.

Gli esempi dipendono da quale feed XML utilizzi su FAVI:

Specificazione feed XML Elemento
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″ **

** Negli elementi DELIVERY_DATE, Delivery_Time e avail riempire un numero non un intervallo di valori.


OPZIONI DI SPEDIZIONE

Specifica delle opzioni per la consegna dei prodotti al cliente.

Ci può essere più di un metodo di consegna per un singolo prodotto ed è consigliabile includere il costo di spedizione. Questo aumenterà il punteggio complessivo del prodotto.

Consideriamo solo la consegna a domicilio nel punteggio di qualità del prodotto, non la consegna ai punti di raccolta.

L'etichetta di spedizione gratuita apparirà sul prodotto se una delle opzioni di spedizione valide è elencata con un prezzo di 0.

Altamente raccomandato per ogni prodotto.

Gli esempi dipendono da quale feed XML utilizzi su FAVI:

Specificazione feed XML Elemento
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>

or the following designation: gratuit, gratis, fara cost, ingyenes; ingyen, ingyenesen.

Ceneo not specified

PRODUTTORE

Specifica il produttore del prodotto.

Altamente raccomandato per ogni prodotto.

Examples depend on which XML feed which you use on FAVI:

Specificazione feed XML Elemento
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>

 

* indica un elemento richiesto