Benvenuto nel Supporto Tecnico di Kelkoo

Struttura del feed e campi

 


Struttura del feed

Nella tabella sotto trovi la lista completa dei campi.

  • O sono campi Obbligatori. L’offerta non sarà visualizzata su Kelkoo se questi campi risulteranno vuoti!
  • AR si riferisce a campi Altamente Raccomandati.
  • R sono campi Raccomandati.
  • F sono campi Facoltativi.

Al fine di facilitare l’integrazione del feed, vi chiediamo di rispettare quanto segue:

  • Il nome del tag XML (4a colonna della tabella sotto).
  • L’ordine dei campi e il carattere separatore ‘Tab (t)’ all’interno di un file di testo.
  • I tipi di dato:
    • Numerico: Solo valori numerici (nessun testo o simboli), i decimali devono essere sempre separati da un punto e non da una virgola.
    • Data: Le date devono avere il seguente formato YYYY-MM-DD (es: 2016-05-29)
    • Testo: I campi testuali possono visualizzare un numero limitato di caratteri. Il codice HTML non è permesso all’interno del feed.

In caso il feed venisse rimosso o lasciato vuoto, le offerte rimarranno comunque online con l’ultimo aggiornamento valido.

Informazioni sui campi

Per alcune tipologie di prodotti, abbiamo bisogno di informazioni specifiche quali possono essere l’anno o il tipo di alimentazione di un’auto, oppure la taglia e il colore per le categorie di moda e accessori. Anche questi campi devono essere aggiunti al feed.

 

 

 

 

 

Cod. Fevad (solo per FR) TAG XML TIPO DESCRIZIONE
135 O   offer-id testo L’identificativo di ogni articolo deve essere univoco all’interno del tuo account. Non può essere riutilizzato da un feed all’altro per lo stesso paese e la stessa lingua. Se si hanno diversi feed per un paese, anche gli identificativi degli articoli nei vari feed devono essere univoci.
Se i codici appaiono solo una volta nel vostro catalogo e sono conformi ai requisiti elencati di seguito, vi consigliamo di utilizzare tali codici.
ATTENZIONE: Dopo aver inviato un articolo, non cambiarne l’identificativo durante il successivo aggiornamento del datafeed
ATTENZIONE: Dopo aver inviato un articolo, non utilizzare il suo identificativo per designare un diverso prodotto in seguito
1 O   title testo Il nome del modello è limitato a 80 caratteri. Può capitare che per motivi di impaginazione il titolo non venga visualizzato per intero nei risultati delle ricerche. Il contenuto del campo viene comunque completamente salvato nell’indice e non inficia i risultati. Valori di esempio: “EOS 400D” o “Maglione 100% lana”…
ATTENZIONE: è vietato lasciare il campo title vuoto, poichè tali offerte verranno escluse dal processo.
2 O   product-url testo Link all’offerta
URL alla pagina del prodotto del vostro sito. L’url deve iniziare con “http://” oppure con “https://”.
ATTENZIONE: La vostra offerta non verrà visualizzata su Kelkoo se la vostra URL non comincia con http:// o https://
Inoltre ricordiamo che, ove possibile, Kelkoo andrà ad aggiungere alcuni parametri alle vostre URL per aiutarvi nel tracciamento delle leads, tra cui il nostro “&from=kelkoo” e i parametri di Google Analytics (se non già presenti): “&utm_source=kelkooit&utm_medium=cpc&utm_campaign=kelkooclick&utm_term=…”.
136 O   landing-page-url testo Link all’offerta
URL alla pagina del prodotto del vostro sito. L’url deve iniziare con “http://” oppure con “https://”.
ATTENZIONE: La landing-page-url differisce dal campo product-url per le seguenti ragioni:
– la Landing-page-url non può includere tracking – per esempio: Lengow, Beezup, ShoppingFeed….
– la Landing-page-url deve essere la url finale mostrata all’utente ed utilizzare il dominio del vostro negozio.
3 O   price numerico Prezzo netto finale (IVA inclusa) per vendita a privato.
Non deve tenere conto di possibili riduzioni provenienti da codici sconto (vedere sotto il campo voucher-title)
4 O   brand testo Marca del prodotto
5 O   description testo Descrizione: Specifiche del prodotto. Questo è un testo libero, con un limite di 300 caratteri (non usare l’html). Può capitare che per motivi di impaginazione la descrizione non venga visualizzata per intero nei risultati delle ricerche. Il contenuto del campo viene comunque completamente salvato nell’indice e non inficia i risultati.
6 O   image-url testo Link all’immagine dell’offerta. Inserire l’immagine più grande disponibile sul vostro sito. Le immagini non dovrebbero contenere watermark o loghi d’alcun tipo. E’ consigliabile fornire immagini jpg, png o gif con sfondo bianco. I formati bmp e tiff non sono supportati.
Dimensione minima richiesta: 300 x 300 px.
Dimensione massima 6 600 000 pixels. Esempi:
* immagine 1024 x 768 = 786 432 pixel = OK
* immagine 1600 x 1200 = 1 920 000 pixel = OK
* immagine 1518 x 5908 = 8 968 344 pixel = NON OK
ATTENZIONE: La vostra immagine non verrà visualizzata su Kelkoo se l’URL non inizia con http://
7 O   ean testo Codice EAN del prodotto, vi garantisce una buona categorizzazione a livello di prodotto. Accettiamo i seguenti formati:
* UPC-E (6 cifre) UPC-E
* EAN-8/UCC-8/GTIN-8 (8 cifre)
* UPC-A/GTIN-12 (12 cifre)
* EAN-13/UCC-13/GTIN-13 (13 cifre)
* ISBN-13 (13 cifre per i libri)
* EAN-14/UCC-14/GTIN-14 (14 cifre)
8 O   merchant-category testo Categoria
Utilizzare un nome significativo, poichè questo campo è usato dal nostro processo di categorizzazione. Per esempio, “Accessori” potrebbe in qualche modo creare confusione al processo, mentre con “Accessori auto”, “TV / Accessori” o “Accessori modding” abbiamo molte più possibilità di riempire la categoria appropriata.
9 AR   availability numerico Disponibilità del prodotto. Accettiamo i seguenti valori:
1 = Disponibile
2 = In arrivo
3 = Vedere sito
4 = Pre-ordine
5 = Su ordinazione
6 = Non disponibile
Potete, nel caso non foste in grado di inserire i valori numerici da 1 a 6, indicare i valori corrispondenti, ovvero: disponibile, non disponibile, etc.
10 AR   delivery-cost numerico Fornire il costo esatto inerente la spedizione del prodotto. Applicabile solo per spedizioni a domicilio, non per spedizioni in negozio o in altri tipi di strutture dove poter ritirare il prodotto. Si riferiscono a pagamento con carta di credito e spedizione mezzo corriere espresso o equipollente (PaccoCelere3 ad esempio)
11 AR   delivery-time testo Tempo di consegna del prodotto dal momento dell’ordine alla ricezione. Esempi:
* x – y giorni
* x giorni
* x – y ore
* y ore
* x – y settimane
* y settimane
12 F   condition numerico Stato del prodotto. Chiediamo questi valori:
0 = nuovo (considerato come valore di default)
1 = usato
2 = ricondizionato
3 = scatola aperta
4 = restituito
5 = danneggiato
6 = avanzo di magazzino
7 = in liquidazione
8 = sconosciuto
9 = scaricabile (per prodotti digitali)
10 = offerte per aziende
13 F   ecotax numerico Valori accettati in questo campo (numerico):
* Offerta non influenzata da tasse ambientali, indicare ‘0’
* Offerta soggetta ad ecotax ma non inclusa nel prezzo, specificare l’ammontare della tassa
* Offerta soggetta ad ecotax e già inclusa nel prezzo, inserire ‘0’
14 F   warranty testo Garanzia applicata all’offerta. Normalmente i valori sono:
* x anni + informazioni aggiuntive
* x mesi + informazioni aggiuntive
* controllare sito
Ex.: 2 anni garanzia del produttore, 6 mesi online
15 F   mobile-url testo URL al vostro “sito mobile” contenente i dettagli dei prodotti e il bottone “compra” del prodotto corrispondente
16 F   kelkoo-category-id numerico Codice univoco per la categoria su Kelkoo. Per esempio, nella categoria Climatizzatori e Condizionatori, indicate catkkid 144801
17 O   mpn testo Codice MPN (manufacturer part number) del prodotto. Questo codice ci aiuta nella fase di integrazione del vostro prodotto.
18 F   sku testo Codice SKU del prodotto. Questo codice ci aiuta nella fase di integrazione del vostro prodotto.
19 F   color testo Colore dell’articolo. Se il prodotto è disponibile in vari colori, puoi specificare più colori usando il separatore “;” per separare ogni valore.
20 F   unit-price testo Prezzo unitario. Es.: 14.56 EUR/kg, 0.14 ? per 100 ml, per 100ml = 14.56
137 F   unit-price-measure testo Si tratta della capacità del prodotto venduto. Ad esempio 300 ml se la bottiglia contiene 300 ml, 0.75 l se si tratta della capacità di una bottiglia standard
138 F   unit-price-base-measure testo Si tratta della capacità base corrispondente al prezzo unitario. Es. 100 ml se si vuole indicare 5.60 EUR / 100 ml, 0.75 l se si vuole indicare 12.90 EUR / 0.75 l, ecc.
21 F   offer-type testo Tipo di offerta. Principalmente vi sono 2 possibilà: “singola” o “bundle”.
22 F   merchant-info testo Questo campo vi permette di associare al negozio (e non al prodotto) alcune informazioni aggiuntive. Es.: presentazione dell’azienda, punti vendita, spedizione (limitato a 150 caratteri, inclusi gli spazi).
23 F   currency testo Es.: EUR, GBP, DKK etc.
24 AR   image-url-2 testo Link ad un’immagine alternativa dell’offerta. Inserire l’immagine più grande che avete disponibile sul vostro sito.
25 AR   image-url-3 testo Link ad un’immagine alternativa dell’offerta. Inserire l’immagine più grande che avete disponibile sul vostro sito.
26 AR   image-url-4 testo Link ad un’immagine alternativa dell’offerta. Inserire l’immagine più grande che avete disponibile sul vostro sito.
Specifiche del prodotto
27 R   green-product testo Prodotto ecologico. Indicare se il prodotto può essere considerato ecologico (verde). Indicare 1 se è ecologico, altrimenti 0 (o campo vuoto) se non lo è:
1 = sì
0 = no (o vuoto = valore di default)
28 R   green-label testo Prodotto Eco-etichettato. Es.: NF Environment, FSC, Fair Trade…
29 F   sales-rank numerico La classificazione di questo prodotto in termini di vendite per il commerciante. I numeri più bassi indicano che sono prodotti venduti più frequentemente.
30 F   unit-quantity numerico La quantità dei contenuti. Es.: il pacco contiene 8 tubetti di dentifricio.
31 R   made-in testo Il paese in cui è stato realizzato il prodotto.
32 R   efficiency-class testo Classe di efficienza del prodotto (A+++, A++, A+, A, B, C, D, E, F, G). Questo campo è altamente raccomandato solo in caso di pneumatici o automobili.
Metodi di spedizione
33 F   shipping-method testo Metodo di spedizione. Es.: Ufficio postale, UPS, DHL, Bartolini…
34 F   delivery-cost-2 numerico Spese di spedizione alternative.
35 F   shipping-method-2 testo Metodo di spedizione. Es.: Ufficio postale, UPS, DHL, Bartolini…
36 F   delivery-cost-3 numerico Spese di spedizione alternative.
37 F   shipping-method-3 testo Metodo di spedizione. Es.: Ufficio postale, UPS, DHL, Bartolini…
38 F   delivery-cost-4 numerico Spese di spedizione alternative.
39 F   shipping-method-4 testo Metodo di spedizione. Es.: Ufficio postale, UPS, DHL, Bartolini…
40 F   zip-code numerico Codice postale del negozio. Specifico per gli Stati Uniti, ma comunque necessario per tutti i paesi che permettono la geolocalizzazione.
41 F   stock-quantity numerico Numero di prodotti a magazzino.
42 F   shipping-weight numerico Peso dell’oggetto per la spedizione.
43 F   payment-methods testo Elenco dei metodi di pagamento accettati (Visa, Paypal…).
Voucher
44 F   voucher-title testo Titolo del voucher. Limite di 50 caratteri inclusi gli spazi. Per l’implementazione rivolgersi al vostro account commerciale.
45 F   voucher-description testo Descrizione del voucher. Limite di 180 caratteri inclusi gli spazi.
Campo non disponibile per l’Italia
46 F   voucher-url testo URL del voucher. Link alla vostra pagina del voucher se disponibile, o altrimenti alla vostra home page (Limite di 20 caratteri inclusi gli spazi).
Campo non disponibile per l’Italia
47 F   voucher-code testo Codice del voucher. Il codice che gli utenti devono digitare per beneficiare del vostro voucher. Limite di 20 caratteri inclusi gli spazi.
Campo non disponibile per l’Italia
48 F   voucher-start-date data Data d’inizio del voucher, con la seguente struttura YYYY-MM-DD (es: 2016-01-29).
Campo non disponibile per l’Italia
49 F   voucher-end-date data Data conclusiva del voucher, con la seguente struttura YYYY-MM-DD (es: 2016-11-29).
Campo non disponibile per l’Italia
Sconti / Prodotti in offerta
50 F   price-no-rebate numerico Prezzo barrato. Prezzo della vostra offerta a priori dello sconto poi applicato. Verrà mostrato barrato, accanto al prezzo effettivo durante i periodi promozionali. Un campo strettamente numerico (nessun carattere alfanumerico o simboli), con un punto come carattere separatore dei decimali (non la virgola).
51 F   percentage-promo numerico Percentuale di sconto. Lasciare questo campo vuoto, Kelkoo effettuerà il calcolo per voi.
52 F   occasion testo Campo usato per evidenziare le offerte che fanno parte di eventi speciali come il Natale, San Valentino e così via.
53 F   promo-start-date data Data di inizio della promozione. Utilizzare la seguente struttura YYYY-MM-DD (es.: 2016-01-29).
54 F   promo-end-date data Data conclusiva della promozione. Utilizzare la seguente struttura YYYY-MM-DD (es.: 2016-11-29)
Valutazione utenti
55 F   user-rating numerico Note riguardo all’utente. Come l’utente ha valutato il prodotto sul sito del cliente, da 1 a 5, dove 5 è il miglior punteggio.
56 F   nb-reviews numerico Numero di giudizi. Il numero di giudizi utente, presenti sul sito del cliente, riguardanti il prodotto.
57 F   user-review-link testo L’URL per accedere ai giudizi utente sul sito del cliente.
58 F   video-link testo L’URL al video del prodotto.
59 F   video-title testo Il titolo del video.
Moda e accessori
60 R   fashion-type testo Tipo di prodotto (maglione, scarpe, giacca, etc..).
61 R   fashion-gender testo Genere (uomo, donna, bambino, unisex).
62 AR   fashion-size testo La taglia del prodotto. Se l’articolo è disponibile con più taglie, ti chiediamo ove possibile di fornire una singola offerta con tutte le taglie separate tramite “;”.
19 F   color testo Il colore del prodotto. Se l’articolo è disponibile con più colori, ti chiediamo ove possibile di fornire una singola offerta con tutti i colori separati tramite “;”.
Giochi e console
63 R   software-platform testo Piattaforma (PC, Xbox, Wii, PS3, etc.).
Servizi immobiliari (extra)
64 R   property-type testo Valori:
* Vendita
* Affitto
* Appartamento in condivisione
* Vitalizio
* Investimento
65 R   property-source testo Fonte. Valori:
* Privato
* Professionale
66 R   propery-garage-parking testo Valori:
* Con box auto
* Con box auto e parcheggio
* Con parcheggio
* Senza box auto e parcheggio
67 R   property-city testo Nome della città.
68 R   property-zip-code numerico  
69 R   property-number-rooms numerico Numero di camere da letto (es: 1, 2, 3…).
70 R   property-surface numerico Superficie.
71 R   property-publication-date data Data di pubblicazione. Formato YYYY-MM-DD.
72 R   property-tenure testo Possesso.
Film (extra)
73 R   movie-director testo Nome del regista (Steven Spielberg, Stanley Kubrick, etc.).
74 R   movie-actors testo Attori principali (Kevin Spacey, Dustin Hoffman, etc.).
75 R   movie-format testo Formato del film (VHS, DVD, Blu-Ray).
76 F   movie-region testo Codice regionale (1 (USA), 2 (Europe), etc.).
77 F   movie-languages testo Lingue disponibili.
78 F   movie-release-date data Data di pubblicazione. Formato YYYY-MM-DD.
79 F   movie-media-rating testo Pubblico. Es.: vietato ai minori di 18 anni.
Musica (extra)
80 R   music-artist testo L’artista, il gruppo, la lista dei cantanti, etc. Per la musica classica, il direttore d’orchestra.
81 R   music-media testo Supporto (CD, vinile, audiocassetta, ecc.).
82 F   music-genre testo Genere musicale (Country, Blues, Pop, Rock, Rap, ecc.).
83 F   music-format testo Formato: album, singolo, ecc.
84 R   music-record-label testo Etichetta discografica.
85 F   music-language testo Lingua.
86 F   music-release-date data Data di pubblicazione. Formato YYYY-MM-DD.
Libri (extra)
87 AR   book-author testo L’autore o il gruppo di autori.
88 R   book-format testo Formato (brossura, copertina rigida, ebook…).
89 F   book-edition testo Edizione del libro.
90 R   book-publisher testo L’editore del libro.
91 F   book-genre testo Il genere del libro (romanzo, poliziesco, storico…).
92 F   book-language testo La lingua in cui è scritto il libro (Italiano, Francese, Inglese…).
93 F   book-release-date data Data di pubblicazione. Formato YYYY-MM-DD.
94 F   book-audience testo A chi è rivolto il libro (adulti, bambini…).
95 F   book-number-of-pages testo Numero di pagine nel libro.
Vini e Champagne (extra)
96 R   wine-country testo La nazione in cui viene prodotto il vino (Italia, Francia, Cile, Stati Uniti, ecc…).
97 R   wine-year numerico L’anno di vendemmia del vino.
98 F   wine-domain testo  
99 R   wine-zone testo La regione in cui viene prodotto il vino (Lombardia, Sicilia, Toscana, Piemonte, ecc…).
100 F   wine-number-bottles numerico Numero di bottiglie.
101 F   wine-capacity testo Capacità di ogni bottiglia.
Pneumatici (extra)
102 AR   tyre-wet-grip testo Classe di aderenza degli pneumatici sul bagnato (A, B, C, D, E) determinata in base allo spazio di frenata necessario di un’auto che viaggia a 80Km/h.
103 AR   tyre-noise-class numerico Rumorosità degli pneumatici misurata in decibel. Ad esempio: 72dB.
Cellulari prepagati (extra)
104 R   mobilephone-network testo  
105 R   mobilephone-contract-type testo  
106 R   mobilephone-contract-length testo  
107 R   mobilephone-contract-total-cost numerico  
108 R   mobilephone-tariff numerico  
109 R   mobilephone-monthly-hours testo  
Auto (extra)
110 R   vehicle-year numerico Anno del veicolo. Data di immatricolazione (es.: 2016).
111 R   vehicle-mileage numerico Chilometraggio del veicolo.
112 R   vehicle-vendor-type testo Origine. Valori consentiti:
* Concessionario
* Privato
113 R   vehicle-city testo Città in cui il veicolo sarà visionabile/venduto.
114 R   vehicle-zip-code numerico Codice postale della città dove il veicolo sarà visionabile/venduto.
115 R   vehicle-doors numerico Numero di porte del veicolo.
116 R   vehicle-chassis testo Carrozzeria (es.: coupé, berlina, 4X4…).
117 R   vehicle-engine-size numerico Cilindrata del motore (in cc).
118 R   vehicle-transmission testo Tipo di trasmissione. Valori consigliati:
* Manuale
* Automatica
* Sequenziale
119 R   vehicle-fuel-type testo  
120 R   vehicle-bonus-malus testo Bonus-malus.
121 R   vehicle-all-fuel-types testo Valori:
* Benzina
* Diesel
* Gas
* Elettricità
* Elettricità+Benzina
* Elettricità+Diesel
* Gas+Benzina
* Gas+Diesel
122 R   vehicle-consumption-highway numerico Litri per 100km. Es.: 4
123 R   vehicle-consumption-city numerico Litri per 100km. Es.: 5
124 R   vehicle-consumption-mixed numerico Litri per 100km. Es.: 6
125 R   vehicle-electric-consumption-highway numerico KW per ora. Es.: 53 kW
126 R   vehicle-electric-consumption-city numerico KW per ora. Es.: 53 kW
127 R   vehicle-electric-consumption-mixed numerico KW per ora. Es.: 53 kW
128 R   vehicle-co2-emmission numerico Emissione massa CO2 (combinata) (g/km).
Ticketing (extra)
129 R   event-zip-code numerico  
130 R   event-city testo  
131 R   event-location testo  
132 R   event-start-date data Formato YYYY-MM-DD.
133 F   event-end-date data Formato YYYY-MM-DD.
134 R   event-genre testo  

Le immagini prima di comparire la prima volta su Kelkoo passano attraverso un processo di resizing per mezzo del quale vengono riadattate alle dimensioni da noi utilizzate online. Ecco perchè possono passare da poche ore a qualche giorno prima che siano visualizzate sul nostro motore. L’intervallo di tempo varia in funzione della coda di immagini presenti sul server che gestisce quest’operazione. Sia chiaro che le immagini che sono già state ridimensionate non devono più passare per tale processo.
Se vorrete togliere intere macro categorie di prodotti è buona cosa che ci avvisiate. Infatti la nostra piattaforma è dotata di un sistema di sicurezza che evita cancellazioni erronee nel database dovute al malfunzionamento degli script di import. Per cui se un merchant decide di eliminare dal feed tutti i prodotti appartenenti ad una macro categoria il sistema interpreta questo cambiamento come una situazione critica e gli articoli in questione non vengono cancellati dal database. Un elenco di macro categorie può essere indicativamente questo: libri, cd, computer, dvd, elettrodomestici e prodotti di climatizzazione, console giochi e accessori, abbigliamento, gastronomia, prodotti di elettronica, memory card, car hi-fi, palmari e accessori, gps e accessori, stampanti, scanner, monitor, articoli sportivi, software, orologi, videogame.
Il consiglio è quello comunque di avvisarci qualora facciate dei grossi cambiamenti al catalogo.