Feed

Specifiche per il feed prodotti

Per inserire le tue offerte su Winescanner è necessario predisporre sul tuo sito un feed prodotti che Winescanner scaricherà, indicizzando le relative offerte, i prodotti  e i prezzi. I prodotti collegati al feed verranno aggiornati almeno ogni 24 ore, mentre i prezzi dei ogni ora,  possibilmente in modo automatizzato, recuperando i dati dei prodotti (inclusi prezzo e disponibilità) direttamente dal relativo database, in modo da presentare informazioni sempre aggiornate ed attendibili.

Formato e struttura del feed

Il feed prodotti è un file di testo contenente i dati di ciascuna offerta su una riga separata. I singoli campi sono separati dal carattere Pipe (|, ASCII 124). I record (uno per ciascuna offerta) sono terminati da Carriage Return (carattere a capo, ASCII 013).

La codifica (charset) consigliata per il file è UTF-8.

L'estensione del file è irrilevante: puoi generare il feed e salvarlo sul tuo server con estensione .txt, .csv ecc., oppure puoi generarlo dinamicamente sul sito con estensione .asp, .php ecc., od 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:

ID prodotto|Produttore|Nome prodotto|Tipologia|Regione|Denominazione|Annata|Formato|Descrizione|Prezzo unitario|URL prodotto|URL immagine

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 nel feed.
  • Produttore Il nome breve dell'azienda o cantina produttrice (es., Antinori).
  • Nome prodotto (*) Il nome commerciale del vino (es., Tignanello). Importante: non includere in questo campo informazioni estranee al nome del vino, quali il nome del produttore, l'annata o la denominazione.
  • 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 di origine o indicazione geografica completa del vino (es., Chianti Classico DOCG, Champagne AOC, Toscana IGT). Per i vini privi di denominazione di origine o indicazione geografica, utilizza n/a oppure lascia vuoto questo campo. Importante: non includere in questo campo informazioni relative al vitigno o all'uvaggio; puoi inserire tali informazioni nel campo "Descrizione".
  • 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, Jéroboam, 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., Sconto 10% o Acquistalo subito!) o comunque estranee alla descrizione del prodotto presente sul tuo sito.
  • Prezzo unitario (*) Il prezzo del prodotto, in Euro, IVA inclusa. Importante: il prezzo deve corrispondere esattamente a quello riportato sulla scheda del prodotto, inclusi eventuali sconti. Utilizza il punto (.) come separatore decimale, e nessun separatore delle migliaia; attieniti alle regole di arrotondamento dell'Euro, utilizzando non più di due cifre dopo il punto decimale (es., formati corretti: 1234.50, 1234.5, 1234; formati errati: 1234,50, 1.234,50, 1,234.50, 1234.500).
  • URL prodotto (*) L'URL assoluto (incluso http:// iniziale) della pagina del prodotto sul tuo sito (es., http://www.example.com/product-123.html). Se il tuo sito utilizza Google Analytics od altro strumento di web analysis, ti consigliamo di appendere all'URL di ciascun prodotto i parametri di tracking rilevanti, in modo da permettere il corretto tracciamento del traffico proveniente da Winescanner (es.,http://www.example.com/product-123.html?utm_source=winescanner&utm_medium=cpc&utm_campaign=winescanner_it).URL immagineL'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

  1. 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 (ma ti consigliamo di compilarli, laddove possibile, per permettere una migliore indicizzazione delle tue offerte). 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 separatore (|).
  2. Il feed prodotti non deve contenere:
    • Prodotti non ammessi (definiti nei nostri Termini e Condizioni);
    • 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 ed entità HTML dal tuo feed prodotti; tuttavia, per ottenere i migliori risultati ti raccomandiamo di non includere alcun codice HTML nel tuo feed prodotti.
  3. 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".

Se hai domande sul feed o hai bisogno di assistenza per la configurazione

Non esitare a contattarci

Accedi

Registrati

Recupera Password