|
|
 |
Home
> Area Esercenti - Istruzioni per il feed prodotti
Istruzioni per il feed prodotti
Per inserire le tue offerte su CercaVino, i passi da compiere sono due:
- Generare un feed prodotti sul tuo sito.
- Registrarti come nuovo Esercente su CercaVino e inserire i dati del tuo negozio online (compreso l'URL del tuo feed prodotti).
Dopo che il tuo negozio sarà stato approvato (leggi i nostri Termini e condizioni), il crawler di CercaVino leggerà il tuo feed prodotti direttamente dal tuo sito, indicizzando le tue offerte a cadenza giornaliera.
Formato del feed prodotti
Il feed prodotti è un file di testo contenente i dati di ciascuna offerta su una riga separata. I singoli campi sono delimitati dal carattere Pipe (|, ASCII 124). I record (uno per ciascuna offerta) sono terminati da Carriage Return (carattere a capo, ASCII 013).
L'estensione del file è irrilevante: puoi generare manualmente il feed e salvarlo sul tuo server con estensione .txt, .csv ecc., oppure puoi generarlo dinamicamente sul sito con estensione .asp, .php ecc., o anche senza alcuna estensione. Importante: il file generato deve essere in formato testo, e non in HTML o altri formati (es. Word, Excel, PDF ecc.).
Per ciascuna offerta, il feed deve contenere i seguenti campi, nel seguente ordine:
Legenda:
- ID prodotto (*)
- Una stringa alfanumerica che identifica univocamente il prodotto sul tuo sito (es., il codice prodotto o l'ID prodotto nel tuo database). Importante: l'ID prodotto deve essere unico per ciascuno dei prodotti sul tuo sito.
Produttore
- Il nome (abbreviato) dell'azienda o cantina produttrice (es., Antinori).
Nome prodotto (*)
- Il nome del vino (es., Pèppoli).
Tipologia
- Il colore o tipologia del vino (es., Rossi, Bianchi, Rosati, Dolci, Spumanti, Champagne, ecc.); in alternativa puoi usare anche espressioni diverse (es., rosso, vini rossi, vino bianco, rosé, dessert, vino dolce, ecc.).
Regione
- La regione di origine del vino (es., Toscana, oppure Italia - Toscana, Toscana (Italia), ma anche vini toscani, vino toscano, ecc.).
Denominazione
- La denominazione o indicazione geografica completa del vino (es., Chianti Classico DOCG, Champagne AOC, Toscana IGT). Per i vini privi di denominazione o indicazione geografica utilizza n/a oppure lascia vuoto questo campo.
Annata
- L'anno di vendemmia del vino, espresso come anno a 4 cifre (es., 2003). Per i vini privi di annata (come ad es. alcuni spumanti e champagne) utilizza n/v (non-vintage) oppure lascia vuoto questo campo.
Formato
- Il formato della bottiglia, possibilmente espresso in centilitri (es., 37,5 cl, 75 cl, 150 cl, 300 cl, ecc.); in alternativa puoi usare anche i litri o i millilitri (es., 1.5 litri, 750 ml, ecc.) e le espressioni standard per i formati delle bottiglie (es., Magnum, Jeroboam, ecc.).
Descrizione
- La descrizione del prodotto, così come appare sulla pagina del prodotto all'URL specificato nel campo URL prodotto (vedi sotto).Importante: non includere caratteri a capo o tag HTML nella descrizione del prodotto, né frasi promozionali (es., Acquistalo subito!) o comunque estranee alla descrizione del prodotto presente sul tuo sito.
Prezzo unitario (*)
- Il prezzo di un'unità del prodotto, in Euro, IVA inclusa. Importante: utilizza il punto (.) come separatore decimale, e nessun separatore delle migliaia (es., formati corretti: 1234.50, 1234.5, 1234; formati errati: 1234,50, 1.234,50, 1,234.50).
URL prodotto (*)
- L'URL assoluto (incluso http:// iniziale) della pagina del prodotto sul tuo sito (es., http://www.example.com/products.php?product_id=12345).
URL immagine
- L'URL assoluto dell'immagine del prodotto sul tuo sito (es., http://www.example.com/images/products/12345.jpg). Importante: usa sempre l'URL dell'immagine più grande disponibile sul tuo sito (provvederemo noi a ridimensionarla automaticamente); se il prodotto non dispone di un'immagine sul tuo sito, lascia vuoto questo campo (non inserire l'URL di un'immagine segnaposto o del tuo logo).
Note:
- I campi ID prodotto, Nome prodotto, Prezzo unitario e URL prodotto, contrassegnati con asterisco (*), sono obbligatori; tutti gli altri campi sono facoltativi e possono essere lasciati vuoti. Importante: se uno o più campi facoltativi (es. URL immagine o Descrizione) non sono disponibili per un determinato prodotto, lascia vuoto il campo, senza tuttavia omettere il carattere delimitatore (|).
- Il feed prodotti non deve contenere:
- Pipe (carattere |) o Carriage Return (carattere a capo) in eccesso: se questi caratteri appaiono all'interno di un campo nel tuo feed prodotti, il prodotto corrispondente non potrà essere indicizzato.
- Tag, commenti o sequenze di escape HTML: proveremo a rimuovere automaticamente tag e entità HTML dal tuo feed prodotti; tuttavia, per ottenere i migliori risultati ti raccomandiamo di non includere alcun codice HTML nel tuo feed prodotti.
- Importante: tutti i prodotti inclusi nel tuo feed prodotti devono risultare immediatamente disponibili per l'acquisto online sul tuo sito; non includere nel feed prodotti esauriti o "in arrivo".
Esempio:
|