Destinations

Feed XML personalizzati: configurazione, struttura e mappatura campi

Guida completa alla creazione e gestione di feed XML personalizzati, con istruzioni su schema, validazione e mapping dei dati per l'integrazione con canali di distribuzione.

8 min read Updated 4 Lug 2026

Also in: EN DE IT ES FR

Introduzione ai feed XML personalizzati

I feed XML personalizzati consentono ai commercianti di definire una struttura dati completamente adattata alle proprie esigenze operative e ai requisiti dei canali di distribuzione specifici. A differenza dei feed predefiniti, una configurazione XML personalizzata offre il controllo totale su elementi, attributi, nomi di campo e gerarchia dei dati. Questo articolo spiega come progettare, configurare e implementare un feed XML personalizzato efficace, garantendo che i dati dei prodotti raggiungano i canali di destinazione in formato corretto e completo.

Struttura XML personalizzata e schema di validazione

La base di ogni feed XML personalizzato è la definizione della struttura. Un feed XML ben formato inizia con una dichiarazione XML e un elemento radice che contiene tutti i record dei prodotti. Ogni prodotto è rappresentato da un elemento contenitore (ad esempio <product>) con sottoelementi che mappano ai campi dati richiesti.

La validazione dello schema XML garantisce che il feed rispetti le regole definite prima dell'invio ai canali. Uno schema XSD (XML Schema Definition) specifica il tipo di dato, la cardinalità (obbligatorio o opzionale) e i vincoli per ogni elemento. Ad esempio, uno schema potrebbe richiedere che il campo price contenga un numero decimale con al massimo due cifre dopo la virgola, oppure che availability sia limitato a un elenco di valori predefiniti come 'in_stock', 'out_of_stock' o 'preorder'.

La mancata conformità allo schema causa rifiuti del feed a livello di piattaforma. I messaggi di errore di validazione indicano esattamente quale elemento è non conforme e perché, consentendo correzioni rapide. Una pratica consigliata è testare il feed XML rispetto allo schema localmente prima di caricarlo nei sistemi di distribuzione.

Mapping dati e trasformazione XML

Il mapping dati stabilisce la corrispondenza tra i campi del sistema di origine (database, ERP, gestionale) e gli elementi del feed XML personalizzato. Questa operazione è fondamentale per garantire che le informazioni corrette finiscano nei campi giusti del feed.

Un mapping tipico potrebbe apparire così:

Campo origine	Elemento XML	Tipo dato	Obbligatorio	Note
product_id	`<id>`	Stringa	Sì	Identificatore univoco del prodotto
product_name	`<title>`	Stringa	Sì	Titolo del prodotto, max 150 caratteri
product_description	`<description>`	Stringa	No	Descrizione dettagliata
selling_price	`<price>`	Numero decimale	Sì	Prezzo in valuta di base
stock_quantity	`<quantity>`	Intero	Sì	Unità disponibili in magazzino
product_url	`<link>`	URL	Sì	URL della pagina prodotto
product_image	`<image_link>`	URL	Sì	URL immagine principale
category_path	`<google_product_category>`	Stringa	No	Categoria Google Merchant Center
sku_code	`<mpn>`	Stringa	No	Codice produttore o SKU
brand_name	`<brand>`	Stringa	No	Marchio del prodotto
product_condition	`<condition>`	Enumerazione	No	new, refurbished, used
gtin_code	`<gtin>`	Stringa	No	GTIN/EAN/UPC
item_group_id	`<item_group_id>`	Stringa	No	Raggruppa varianti dello stesso prodotto
product_type	`<product_type>`	Stringa	No	Tipo di prodotto personalizzato
availability_status	`<availability>`	Enumerazione	No	in_stock, out_of_stock, preorder

La trasformazione dei dati durante il mapping può includere operazioni come concatenazione di stringhe, formattazione di date, conversione di unità di misura, o applicazione di regole di business. Ad esempio, se il sistema di origine memorizza il prezzo in euro con tre cifre decimali, la trasformazione XML deve arrotondare a due decimali per conformarsi agli standard di e-commerce.

Configurazione e gestione delle sorgenti dati XML

Una sorgente dati XML personalizzata è definita da parametri di connessione e opzioni di elaborazione. Questi parametri controllano come il sistema legge, valida e elabora il file XML.

I parametri di configurazione comuni includono:

URL o percorso file: il percorso da cui recuperare il feed XML (HTTP/HTTPS, FTP, o percorso locale).
Frequenza di aggiornamento: quanto spesso il sistema sincronizza i dati (giornaliero, orario, in tempo reale).
Encoding caratteri: il set di caratteri del file (UTF-8 è lo standard consigliato).
Elemento radice: il nome dell'elemento contenitore principale (ad esempio <products>).
Elemento prodotto: il nome dell'elemento che rappresenta un singolo prodotto (ad esempio <product>).
Timeout connessione: il tempo massimo per recuperare il file prima di interrompere l'operazione.
Gestione errori: se il feed fallisce la validazione, continuare con i record validi o rifiutare l'intero caricamento.

La configurazione corretta di questi parametri assicura che il sistema interpreti correttamente la struttura XML e applichi le regole di validazione appropriate.

Parsing XML avanzato e attributi personalizzati

Il parsing XML avanzato consente di estrarre dati da strutture XML complesse, inclusi attributi di elemento, elementi nidificati e contenuto misto. Un elemento XML può contenere attributi (coppie chiave-valore associate all'elemento stesso) e sottoelementi (contenuto nidificato).

Esempio di struttura con attributi:

<product id="12345" sku="SKU-789" condition="new">
  <title>Laptop professionali 15 pollici</title>
  <price currency="EUR">899.99</price>
  <availability status="in_stock" last_updated="2024-01-15"/>
</product>

Il parsing deve estrarre sia gli attributi (id, sku, condition, currency, status, last_updated) che gli elementi (title, price, availability). Questa flessibilità consente di rappresentare metadati e informazioni strutturate in modo più compatto rispetto a una gerarchia puramente basata su elementi.

Le varianti di prodotto possono essere rappresentate tramite nidificazione o tramite raggruppamento con item_group_id. Una struttura nidificata potrebbe apparire così:

<product>
  <id>parent-123</id>
  <title>Maglietta T-Shirt</title>
  <variants>
    <variant>
      <id>variant-123-red-m</id>
      <color>Rosso</color>
      <size>M</size>
      <price>29.99</price>
      <availability>in_stock</availability>
    </variant>
    <variant>
      <id>variant-123-blue-l</id>
      <color>Blu</color>
      <size>L</size>
      <price>29.99</price>
      <availability>out_of_stock</availability>
    </variant>
  </variants>
</product>

In alternativa, ogni variante può essere un record separato con lo stesso item_group_id per indicare l'appartenenza allo stesso gruppo.

Integrazione dati XML e sincronizzazione con canali

L'integrazione di un feed XML personalizzato con canali di distribuzione richiede che il feed sia accessibile tramite un URL stabile e che il canale sia configurato per recuperare e elaborare il feed secondo una pianificazione definita. La maggior parte dei canali di distribuzione (marketplace, reti pubblicitarie, affiliate network) fornisce interfacce di configurazione per specificare l'URL del feed e le opzioni di sincronizzazione.

Durante la sincronizzazione, il canale scarica il file XML, valida la struttura rispetto ai propri requisiti, mappa gli elementi XML ai campi interni del canale e carica i dati nel database del catalogo. Se la validazione fallisce, il canale rifiuta il feed e notifica l'errore al commerciante. Se ha successo, i prodotti diventano disponibili per la pubblicazione e la visibilità nel canale.

La qualità dei dati nel feed XML direttamente influenza l'approvazione dei prodotti e la loro visibilità. Campi come title, description, price, image_link e availability sono critici per l'approvazione. Un titolo incompleto, un'immagine mancante o un prezzo non valido causano il rifiuto del prodotto a livello di canale.

La sincronizzazione periodica (ad esempio giornaliera) garantisce che le variazioni di prezzo, disponibilità e inventario siano riflesse nel canale in modo tempestivo. I campi come availability e quantity devono essere aggiornati frequentemente per evitare vendite di prodotti non disponibili.

Repository XML personalizzato e versioning

Un repository XML personalizzato è una posizione centralizzata dove risiedono i feed XML e dove vengono gestite le versioni. Mantenere la cronologia delle versioni consente di ripristinare rapidamente una versione precedente se una nuova versione contiene errori.

Le pratiche di versioning includono:

Naming convention: nominare i file con timestamp o numeri di versione (ad esempio feed_products_v1.2_20240115.xml).
Backup automatici: conservare copie di versioni precedenti per un periodo definito.
Change log: documentare quali campi sono stati modificati in ogni versione e perché.
Testing prima della pubblicazione: validare ogni nuova versione rispetto allo schema e ai requisiti del canale prima di renderla disponibile ai sistemi di distribuzione.

Un repository ben gestito riduce il rischio di distribuire dati non corretti e facilita la troubleshooting quando un canale segnala problemi con il feed.

Guida pratica all'implementazione

Per implementare un feed XML personalizzato, i commercianti devono seguire questi passaggi:

Definire lo schema: creare un documento XSD che specifica la struttura attesa del feed, i tipi di dato, i vincoli e la cardinalità di ogni elemento.
Mappare i campi: documentare come ogni campo del sistema di origine si trasforma in un elemento XML nel feed personalizzato.
Generare il feed: configurare il sistema di origine (database, ERP, piattaforma e-commerce) per esportare i dati in formato XML secondo la struttura definita.
Validare localmente: testare il feed XML generato rispetto allo schema XSD utilizzando strumenti di validazione XML (online validator, editor XML, o script di validazione).
Caricare nel repository: salvare il feed XML in una posizione accessibile via URL stabile (server web, CDN, servizio di hosting).
Configurare i canali: specificare l'URL del feed nei sistemi di configurazione di ogni canale di distribuzione e impostare la frequenza di sincronizzazione.
Monitorare la sincronizzazione: controllare regolarmente i log di sincronizzazione e gli avvisi del canale per identificare e risolvere rapidamente i problemi.
Aggiornare il feed: quando i dati cambiano nel sistema di origine, rigenerare il feed XML, validarlo e renderlo disponibile ai canali entro il tempo previsto.

I commercianti che distribuiscono su canali specifici come Amazon, Connexity, Awin o AdRoll possono fare riferimento alle guide tecniche dedicate per comprendere i requisiti specifici di ciascun canale e come adattare il feed XML personalizzato di conseguenza.

Riepilogo

I feed XML personalizzati offrono la massima flessibilità nella struttura e nel mapping dei dati, ma richiedono una pianificazione attenta, una validazione rigorosa e una gestione continua. Una struttura XML ben definita, uno schema di validazione preciso e un mapping dei dati accurato sono i fondamenti di un feed che supporta l'approvazione dei prodotti e la sincronizzazione affidabile con i canali di distribuzione. La configurazione corretta della sorgente dati, il parsing avanzato di elementi e attributi, e l'integrazione sistematica con i canali garantiscono che i dati dei prodotti raggiungano il pubblico target in modo tempestivo e accurato.