Destinations

Feed Connexity: guida tecnica ai campi e all'ottimizzazione

Guida completa ai campi del feed Connexity, loro significato e impatto sulla visibilità dei prodotti. Scopri come configurare e ottimizzare ogni campo per migliorare le prestazioni.

14 min di lettura 39 visualizzazioni Aggiornato il 3 Lug 2026

Nessun risultato trovato

Provi parole chiave diverse o sfogli tutti gli articoli della guida.

    Che cos'è il feed Connexity e perché è importante

    Connexity è una piattaforma di distribuzione di feed prodotto che consente ai merchant di inviare i dati dei loro cataloghi a una rete ampia di partner e canali di vendita. A differenza di piattaforme specifiche come Google Shopping, Connexity agisce come aggregatore e distributore, permettendo ai merchant di raggiungere molteplici endpoint commerciali (marketplace, affiliate network, comparison shopping engine) attraverso un'unica integrazione.

    I merchant utilizzano Connexity per:

    • Sincronizzare il catalogo prodotto con partner commerciali multipli in modo centralizzato
    • Ridurre il tempo di integrazione manuale con singoli canali
    • Mantenere coerenza nei dati prodotto su tutti i touchpoint
    • Aumentare la visibilità dei prodotti presso nuovi clienti attraverso una rete di distribuzione già consolidata
    • Monitorare e ottimizzare le performance dei prodotti su canali diversi

    La qualità del feed Connexity influisce direttamente sulla capacità dei tuoi prodotti di essere approvati, indicizzati e visualizzati correttamente presso i partner della rete.

    Campi obbligatori e facoltativi del feed

    Campo Tipo Obbligatorio Descrizione e impatto
    id Identificativo univoco Identificatore unico e stabile per ogni prodotto. Deve rimanere costante nel tempo. È essenziale per tracciare le variazioni di prezzo e disponibilità. Senza un id coerente, i partner non riescono a aggiornare i dati del tuo prodotto.
    title Testo Nome del prodotto. Deve essere descrittivo, conciso e contenere le parole chiave rilevanti. Un titolo chiaro migliora la ricercabilità e il tasso di click sui partner. Evita caratteri speciali eccessivi e ripetizioni di keyword.
    description Testo Descrizione dettagliata del prodotto. Fornisce contesto ai partner e ai clienti finali. Una descrizione completa e accurata riduce i resi e migliora la fiducia. Includi materiali, dimensioni, caratteristiche distintive e usi previsti.
    category Testo Categoria di appartenenza del prodotto secondo la tassonomia Connexity. La categorizzazione corretta è fondamentale per il routing verso i partner appropriati e per la visibilità nelle ricerche per categoria.
    link URL URL della pagina prodotto sul tuo sito. Deve essere un link diretto e funzionante. I partner lo utilizzano per indirizzare il traffico verso il tuo e-commerce. URL non funzionanti causano perdita di conversioni.
    image_link URL URL dell'immagine principale del prodotto. Deve essere un file immagine valido (JPG, PNG). Un'immagine di qualità alta e ben centrata migliora il tasso di click. Assicurati che l'immagine sia accessibile e caricata rapidamente.
    price Prezzo Prezzo attuale del prodotto nel formato valuta (ad esempio, 29.99 EUR). Deve corrispondere al prezzo visualizzato sul tuo sito. Errori di prezzo causano disapprovazioni e perdita di fiducia. Aggiorna il prezzo in tempo reale per evitivi stock-out pagati.
    brand Testo Marca o produttore del prodotto. Essenziale per il filtraggio e la ricerca per brand. Deve essere il nome ufficiale della marca.
    gtin Codice No Global Trade Item Number (codice EAN/UPC). Facilita l'identificazione univoca del prodotto e la riconciliazione con database di terze parti. Migliora la qualità dei dati presso i partner. Se disponibile, includerlo aumenta l'approvazione.
    mpn Codice No Manufacturer Part Number. Identificativo del produttore. Utile per prodotti tecnici e brand-name. Insieme a brand e gtin, rafforza l'identificazione del prodotto.
    availability Stato Stato della disponibilità (in stock, out of stock, preorder). Critico per evitare ordini di prodotti non disponibili. Deve essere aggiornato in tempo reale. Disponibilità errata causa disapprovazioni e reclami.
    condition Stato Condizione del prodotto (new, refurbished, used). Obbligatorio per trasparenza legale e fiducia. Prodotti usati o ricondizionati richiedono etichettatura corretta.
    original_price Prezzo No Prezzo originale o di listino. Utilizzato per calcolare lo sconto percentuale. Aiuta i partner a mostrare il valore della promozione. Deve essere maggiore o uguale al prezzo corrente.
    additional_image_url URL No URL di immagini aggiuntive del prodotto. Migliora la fiducia e la conversione. I partner con supporto multi-immagine le utilizzeranno per mostrare il prodotto da angolazioni diverse.
    item_group_id Identificativo No Identificatore del gruppo di varianti (es. stesso prodotto in colori diversi). Essenziale per prodotti con varianti. Consente ai partner di raggruppare correttamente le varianti e migliorare la navigazione.
    color Testo No Colore del prodotto. Critico per il filtraggio e la ricerca. Utilizza colori standard (rosso, blu, verde) e non descrizioni soggettive.
    size Testo No Taglia del prodotto (XS, S, M, L, ecc. per abbigliamento; cm o pollici per altri prodotti). Fondamentale per abbigliamento e calzature. Deve essere coerente con lo standard di settore.
    gender Testo No Genere a cui è rivolto il prodotto (male, female, unisex). Aiuta il filtraggio e la ricerca. Importante per abbigliamento e accessori.
    age_group Testo No Fascia d'età (newborn, infant, toddler, kids, adult). Critico per prodotti per bambini per conformità legale e sicurezza.
    material Testo No Materiale principale del prodotto. Importante per moda, arredamento e articoli sportivi. Aiuta i clienti a valutare qualità e compatibilità.
    pattern Testo No Motivo o pattern (solido, a righe, floreale, ecc.). Utile per il filtraggio visivo su partner con supporto avanzato.
    shipping_cost Prezzo No Costo di spedizione. Se fornito, i partner possono mostrarlo nei risultati di ricerca. Migliora la trasparenza e riduce le sorprese al checkout.
    shipping_weight Peso No Peso del prodotto per il calcolo delle spese di spedizione. Essenziale per partner che calcolano dinamicamente i costi di spedizione.
    adult Booleano No Indica se il prodotto è riservato a un pubblico adulto (true/false). Obbligatorio per prodotti soggetti a restrizioni di età.

    Struttura e formato del feed

    Connexity accetta feed in formato XML o CSV. Il file deve contenere un'intestazione con i nomi dei campi e una riga per ogni prodotto. Ogni campo deve essere mappato correttamente secondo la specifica Connexity.

    Requisiti tecnici

    • Formato file: XML o CSV
    • Codifica: UTF-8
    • Dimensione massima: Dipende dal partner; generalmente fino a 1 GB
    • Frequenza di aggiornamento: Giornaliera consigliata; minimo settimanale
    • Timeout di connessione: Generalmente 30 minuti per file grandi
    • Validazione: Il feed deve essere ben formato e privo di errori di sintassi

    Esempio di struttura XML

    <?xml version="1.0" encoding="UTF-8"?>
    <feed>
      <product>
        <id>PROD-001</id>
        <title>Maglietta Cotone Premium Uomo</title>
        <description>Maglietta in cotone 100% biologico, morbida e traspirante. Disponibile in vari colori.</description>
        <category>Abbigliamento > Uomo > Magliette</category>
        <link>https://www.tuosito.it/prodotto/maglietta-001</link>
        <image_link>https://www.tuosito.it/img/maglietta-001.jpg</image_link>
        <price>24.99 EUR</price>
        <brand>TuoBrand</brand>
        <gtin>1234567890123</gtin>
        <availability>in stock</availability>
        <condition>new</condition>
        <color>Nero</color>
        <size>M</size>
        <gender>male</gender>
        <material>Cotone</material>
      </product>
    </feed>
    

    Ottimizzazione dei campi per migliorare le prestazioni

    Titoli efficaci

    Il titolo è il primo elemento che vede un potenziale cliente. Un titolo ottimizzato migliora il tasso di click e la visibilità nei risultati di ricerca dei partner.

    Linee guida:

    • Inserisci le parole chiave più importanti all'inizio (marca, tipo di prodotto, caratteristica distintiva)
    • Mantieni una lunghezza tra 40 e 70 caratteri per visibilità ottimale
    • Evita maiuscole eccessive, caratteri speciali ripetuti o spam di keyword
    • Includi dettagli rilevanti come colore, taglia o materiale se pertinenti
    • Non ripetere la stessa parola più volte

    Esempio non ottimizzato: "Maglietta maglietta maglietta cotone nero"
    Esempio ottimizzato: "Maglietta Cotone Nero Premium Uomo Taglia M"

    Descrizioni complete e accurate

    La descrizione fornisce il contesto necessario ai partner e ai clienti finali. Una descrizione incompleta o vaga causa disapprovazioni e riduce le conversioni.

    Linee guida:

    • Descrivi le caratteristiche principali (materiale, dimensioni, peso, colore)
    • Includi i vantaggi e gli usi previsti
    • Segnala eventuali limitazioni o requisiti speciali
    • Utilizza un linguaggio chiaro e professionale
    • Evita claim non supportati o esagerati
    • Se il prodotto ha varianti, menziona quali sono disponibili

    Categorizzazione corretta

    La categoria determina dove il tuo prodotto appare nella navigazione dei partner e quale pubblico lo vede.

    Linee guida:

    • Utilizza la tassonomia Connexity ufficiale (non creare categorie personalizzate)
    • Scegli la categoria più specifica possibile, non una categoria generica
    • Se il prodotto rientra in più categorie, scegli quella primaria
    • Verifica che la categoria corrisponda effettivamente al prodotto

    Immagini di alta qualità

    L'immagine principale è il fattore visivo più importante. Un'immagine di scarsa qualità riduce drasticamente il tasso di click.

    Linee guida:

    • Utilizza immagini ad alta risoluzione (almeno 500 x 500 pixel, preferibilmente 1000 x 1000 o superiore)
    • Assicurati che il prodotto sia ben visibile e centrato nell'immagine
    • Usa uno sfondo neutro o bianco per coerenza
    • Evita watermark o sovrapposizioni di testo
    • Includi immagini aggiuntive che mostrino il prodotto da angolazioni diverse
    • Verifica che l'URL sia accessibile e non scada

    Prezzi e disponibilità in tempo reale

    I prezzi e la disponibilità devono essere sempre sincronizzati con il tuo inventario. Errori causano ordini non evadibili e disapprovazioni.

    Linee guida:

    • Aggiorna il feed almeno una volta al giorno
    • Sincronizza il prezzo del feed con il prezzo visualizzato sul tuo sito
    • Aggiorna lo stato di disponibilità in tempo reale se possibile
    • Se un prodotto è esaurito, contrassegnalo come 'out of stock' immediatamente
    • Non mostrare prezzi scorretti per attirare traffico (causa disapprovazioni)

    Identificatori univoci (GTIN e MPN)

    GTIN e MPN permettono ai partner di riconciliare i tuoi dati con database globali e identificare univocamente i prodotti.

    Linee guida:

    • Includi il GTIN (EAN) se il prodotto lo possiede (è stampato sulla confezione)
    • Includi l'MPN per prodotti tecnici o brand-name
    • Assicurati che GTIN e MPN siano corretti e verificati
    • Se il prodotto non ha GTIN, non lasciare il campo vuoto con un valore fittizio

    Varianti di prodotto (item_group_id)

    Per prodotti con varianti (colori, taglie, ecc.), utilizza item_group_id per raggrupparli logicamente.

    Linee guida:

    • Assegna lo stesso item_group_id a tutte le varianti dello stesso prodotto
    • Crea una riga separata per ogni variante con un id univoco
    • Includi il colore, la taglia e altre caratteristiche distintive in ogni riga
    • I partner utilizzeranno item_group_id per mostrare le varianti come un unico prodotto con selezioni

    Esempio:

    id: MAGLIETTA-001-NERO-M, item_group_id: MAGLIETTA-001, color: Nero, size: M
    id: MAGLIETTA-001-NERO-L, item_group_id: MAGLIETTA-001, color: Nero, size: L
    id: MAGLIETTA-001-ROSSO-M, item_group_id: MAGLIETTA-001, color: Rosso, size: M
    

    Attributi specifici per categoria

    Alcuni partner richiedono attributi specifici per determinate categorie (ad esempio, genere e fascia d'età per abbigliamento per bambini, materiale per arredamento).

    Linee guida:

    • Identifica gli attributi obbligatori per la tua categoria
    • Compila tutti gli attributi richiesti con precisione
    • Utilizza valori standard (non personalizzati) per i campi di selezione
    • Per prodotti per bambini, includi sempre age_group per conformità legale

    Convalida e monitoraggio del feed

    Errori comuni da evitare

    Errore Causa Impatto Soluzione
    ID duplicati Stesso id assegnato a prodotti diversi Confusione nell'aggiornamento dati, perdita di tracciamento Assicurati che ogni prodotto abbia un id univoco e stabile
    URL non funzionanti Link a pagine eliminate o non accessibili Perdita di traffico e conversioni Testa tutti gli URL prima di caricare il feed
    Immagini mancanti URL immagine non valido o scaduto Prodotto non visualizzato correttamente Verifica che gli URL immagine siano accessibili e permanenti
    Prezzi errati Sincronizzazione non aggiornata Ordini non evadibili, disapprovazioni Aggiorna il feed quotidianamente
    Disponibilità non aggiornata Prodotto segnato come in stock ma esaurito Clienti delusi, reclami Sincronizza in tempo reale con l'inventario
    Categorie non valide Categoria non presente nella tassonomia Connexity Prodotto non approvato o routing errato Consulta la tassonomia ufficiale Connexity
    Descrizioni incomplete Campi obbligatori mancanti o vuoti Disapprovazione del prodotto Compila tutti i campi obbligatori con dati accurati
    GTIN non valido Codice errato o formato scorretto Riconciliazione fallita con database partner Verifica il GTIN sulla confezione del prodotto

    Processo di validazione

    1. Validazione sintattica: Verifica che il file XML/CSV sia ben formato e privo di errori di sintassi.
    2. Validazione dei campi obbligatori: Assicurati che tutti i campi obbligatori siano presenti e non vuoti.
    3. Validazione dei dati: Verifica che i dati siano nel formato corretto (prezzo come numero, URL valide, ecc.).
    4. Validazione della coerenza: Controlla che i dati siano coerenti (titolo, descrizione e categoria corrispondono al prodotto).
    5. Test di upload: Carica il feed e monitora i messaggi di errore o avviso.
    6. Monitoraggio post-upload: Verifica che i prodotti siano approvati e indicizzati correttamente dai partner.

    Integrazione con il tuo sistema

    Per mantenere il feed Connexity aggiornato e accurato, è necessario automatizzare la generazione e l'upload del feed.

    Opzioni di integrazione

    1. Upload manuale: Scarica il feed dal tuo sistema e caricalo manualmente su Connexity. Metodo semplice ma non scalabile.
    2. FTP/SFTP automatico: Configura un processo che carica il feed automaticamente su un server FTP/SFTP fornito da Connexity a intervalli regolari.
    3. API Connexity: Utilizza l'API di Connexity per inviare i dati dei prodotti direttamente. Metodo più flessibile e scalabile.
    4. Piattaforma di gestione feed: Utilizza una piattaforma specializzata (come quella di cui stai leggendo la documentazione) che gestisce la mappatura dei campi, la validazione e l'upload automatico.

    Frequenza di aggiornamento consigliata

    • Prezzi e disponibilità: Giornaliera (preferibilmente più volte al giorno)
    • Nuovi prodotti: Giornaliera
    • Descrizioni e categorie: Settimanale o quando cambiano
    • Immagini: Settimanale o quando vengono aggiornate

    Risoluzione dei problemi comuni

    Prodotti non approvati

    Cause possibili:

    • Campi obbligatori mancanti o incompleti
    • Categoria non valida o non presente nella tassonomia Connexity
    • Immagine non accessibile o di scarsa qualità
    • URL del prodotto non funzionante
    • Descrizione incompleta o poco chiara

    Azioni correttive:

    1. Verifica il messaggio di errore specifico fornito da Connexity
    2. Correggi i dati nel feed secondo le linee guida
    3. Ricarica il feed e monitora l'approvazione

    Prodotti disapprovati dopo l'approvazione iniziale

    Cause possibili:

    • Prezzo o disponibilità non aggiornati
    • URL del prodotto cambiato o non più funzionante
    • Immagine rimossa o non più accessibile
    • Violazione delle policy di Connexity o dei partner

    Azioni correttive:

    1. Verifica che il feed sia aggiornato e sincronizzato
    2. Controlla che tutti gli URL siano funzionanti
    3. Rivedi le policy di Connexity per eventuali violazioni
    4. Contatta il supporto Connexity se il problema persiste

    Performance basse

    Cause possibili:

    • Titoli o descrizioni poco ottimizzati
    • Immagini di scarsa qualità
    • Prezzi non competitivi
    • Categoria non appropriata
    • Prodotto non rilevante per il pubblico dei partner

    Azioni correttive:

    1. Migliora i titoli seguendo le linee guida di ottimizzazione
    2. Aggiorna le immagini con versioni di alta qualità
    3. Rivedi i prezzi rispetto ai competitor
    4. Verifica che la categoria sia appropriata
    5. Monitora le metriche di performance su Connexity e adatta la strategia

    Confronto con altre piattaforme di distribuzione

    Connexity differisce da piattaforme specifiche come Google Shopping per il suo approccio multi-canale. Mentre Google Shopping è focalizzato su un singolo canale, Connexity distribuisce i tuoi prodotti a una rete di partner. Questo offre una copertura più ampia ma richiede una maggiore attenzione alla qualità dei dati per soddisfare i requisiti di più partner simultaneamente.

    Se utilizzi anche altre piattaforme di distribuzione, assicurati che i dati del feed siano coerenti su tutti i canali. Discrepanze nei prezzi, nelle descrizioni o nella disponibilità possono causare confusione e perdita di fiducia.

    Riepilogo e best practice

    Per ottimizzare il tuo feed Connexity:

    1. Compila tutti i campi obbligatori con dati accurati e completi.
    2. Utilizza la tassonomia ufficiale per le categorie.
    3. Ottimizza i titoli con parole chiave rilevanti e lunghezza appropriata.
    4. Fornisci descrizioni dettagliate che descrivono caratteristiche, vantaggi e usi.
    5. Includi immagini di alta qualità ben centrate e ben illuminate.
    6. Mantieni prezzi e disponibilità aggiornati con sincronizzazione giornaliera o più frequente.
    7. Utilizza identificatori univoci (GTIN, MPN) quando disponibili.
    8. Raggruppa le varianti con item_group_id.
    9. Includi attributi specifici per categoria (genere, fascia d'età, materiale, ecc.).
    10. Monitora i messaggi di errore e le performance e adatta continuamente il feed.
    11. Automatizza il processo di aggiornamento per ridurre errori manuali.
    12. Testa il feed regolarmente per assicurare coerenza e accuratezza.

    Il feed Connexity è uno strumento potente per raggiungere nuovi clienti attraverso una rete di partner consolidata. Investire nella qualità e nell'ottimizzazione del feed produce risultati tangibili in termini di visibilità, traffico e conversioni.