Introduzione
I dati dei tuoi prodotti sono il fondamento di ogni listino di qualità. Vendably offre due approcci per portare i tuoi dati prodotto nella piattaforma: collegare direttamente la tua piattaforma ecommerce per una sincronizzazione automatica e continua, oppure importare i dati da file manualmente o secondo una pianificazione. Questo articolo spiega come funzionano entrambi i metodi, come mappare i campi sui tuoi dati, e come verificare che tutto sia stato importato correttamente.
Dove trovare le funzioni di importazione
Tutte le operazioni di importazione e gestione delle sorgenti dati si trovano nella sezione DataHub della tua area Vendably. All'interno di DataHub, accedi a Sources per creare una nuova connessione o caricare un file. Da qui potrai gestire tutte le tue sorgenti dati attive, monitorare lo stato degli import e verificare i risultati.
I due metodi di importazione
Connessione diretta a una piattaforma ecommerce
Se utilizzi Shopify, WooCommerce o BigCommerce, puoi collegare la tua piattaforma direttamente a Vendably tramite OAuth. Questo metodo offre vantaggi significativi rispetto a un semplice import una tantum.
Quando colleghi una piattaforma, Vendably non importa i dati una sola volta. La connessione rimane attiva e utilizza i webhook per sincronizzare automaticamente i cambiamenti in tempo reale. Se modifichi un prezzo, aggiorni lo stock, o aggiungi un nuovo prodotto nel tuo negozio, questi cambiamenti si propagano automaticamente in Vendably senza necessità di intervento manuale. Questo assicura che i tuoi dati siano sempre coerenti tra le piattaforme.
La configurazione iniziale richiede l'autorizzazione tramite OAuth, un processo sicuro che non espone le tue credenziali. Dopo l'autorizzazione, Vendably accede ai tuoi dati e li sincronizza secondo la pianificazione configurata.
Importazione da file
Se preferisci un controllo più granulare, oppure se i tuoi dati risiedono in un sistema non direttamente supportato, puoi importare i dati da file. Vendably accetta tre formati: CSV, XML e JSON.
L'importazione da file può essere eseguita manualmente (carica il file e avvia l'import immediatamente) oppure secondo una pianificazione tramite FTP. Con la pianificazione FTP, Vendably controlla periodicamente un percorso FTP designato, scarica automaticamente i file più recenti e li importa senza intervento manuale. Questo approccio è ideale se il tuo sistema ERP o gestionale esporta dati periodicamente in un percorso FTP.
Mapping dei campi
Indipendentemente dal metodo di importazione, i tuoi dati grezzi devono essere mappati sullo schema standard di Vendably. Questo processo si chiama field mapping.
Quando importi per la prima volta da una sorgente, Vendably analizza automaticamente la struttura dei tuoi dati e tenta di rilevare i campi. Ad esempio, se il tuo CSV contiene una colonna intitolata 'price', Vendably la mapperà automaticamente al campo price dello schema Vendably. Allo stesso modo, 'product_name' potrebbe essere mappato a title, e 'sku' a id.
Tuttavia, il rilevamento automatico non è sempre perfetto. Se la tua sorgente utilizza nomi di colonna non standard (ad esempio 'prezzo_eur' invece di 'price'), o se desideri mappare un campo a un attributo diverso, puoi regolare il mapping manualmente. Questa flessibilità assicura che i tuoi dati vengano interpretati correttamente indipendentemente dalla loro struttura originale.
I campi chiave coinvolti nel mapping includono:
| Campo | Descrizione | Obbligatorio |
|---|---|---|
| id | Identificativo univoco del prodotto (SKU o codice interno) | Sì |
| title | Nome del prodotto | Sì |
| description | Descrizione completa del prodotto | No |
| price | Prezzo di vendita | Sì |
| availability | Stato di disponibilità (in stock, out of stock, etc.) | No |
| image_link | URL dell'immagine principale | No |
| brand | Marca del prodotto | No |
| condition | Condizione del prodotto (new, used, refurbished) | No |
| gtin | Codice GTIN/EAN/UPC | No |
| mpn | Numero di parte del produttore | No |
| product_type | Categoria o tipo di prodotto | No |
| item_group_id | Identificativo del gruppo (per varianti) | No |
| link | URL della pagina prodotto | No |
| google_product_category | Categoria Google (per feed di annunci) | No |
Dopo aver configurato il mapping, Vendably applica le regole di trasformazione durante l'importazione, assicurando che i dati siano conformi allo schema standard.
Fasi della pipeline di importazione
Quando avvii un import (manuale o pianificato), i tuoi dati attraversano diverse fasi elaborate:
-
Fetch (Recupero). Vendably recupera i dati dalla sorgente. Se si tratta di una connessione OAuth a Shopify, WooCommerce o BigCommerce, i dati vengono estratti via API. Se si tratta di un file, il file viene scaricato dal percorso FTP o caricato direttamente.
-
Import (Importazione). I dati grezzi vengono letti e analizzati secondo il mapping configurato. Ogni record viene elaborato e convertito nel formato standard di Vendably.
-
Post-process (Post-elaborazione). Dopo l'importazione iniziale, i dati vengono sottoposti a elaborazioni aggiuntive: pulizia, normalizzazione e applicazione di regole di trasformazione configurate.
-
Analyse (Analisi). Vendably analizza i dati importati per identificare problemi: campi mancanti, valori non validi, duplicati o incoerenze. Un rapporto di analisi viene generato e messo a tua disposizione.
-
Apply supplement overlays (Applicazione di overlay supplementari). Se hai configurato overlay di contenuto (ad esempio, descrizioni generate da IA, immagini ottimizzate, o dati da una libreria di contenuti), questi vengono applicati ai prodotti importati.
-
Complete (Completamento). L'import è terminato. I prodotti aggiornati appaiono nel Product Hub e sono pronti per l'esportazione verso i canali di distribuzione.
Ogni fase genera log dettagliati. Se qualcosa non funziona come previsto, i log ti aiutano a identificare il problema e correggerlo.
Sincronizzazione webhook e aggiornamenti in tempo reale
Una delle maggiori differenze tra una connessione diretta a una piattaforma e un import da file è il supporto per i webhook.
Quando colleghi una piattaforma tramite OAuth, Vendably registra webhook sul tuo account della piattaforma. I webhook sono notifiche automatiche che vengono inviate ogni volta che qualcosa cambia nel tuo negozio. Se un cliente acquista un articolo e lo stock diminuisce, il tuo negozio invia immediatamente un webhook a Vendably segnalando il nuovo valore di stock. Se aggiungi un nuovo prodotto, un webhook notifica Vendably della novità.
Grazie ai webhook, i tuoi dati in Vendably rimangono sempre sincronizzati con la tua piattaforma, senza ritardi e senza necessità di eseguire import manuali ripetuti. Questo è cruciale per mantenere l'accuratezza dei listini, soprattutto quando sincronizzi i dati verso molteplici canali di vendita.
Gli import da file, al contrario, non supportano i webhook. Se importi da un CSV manualmente o tramite FTP pianificato, gli aggiornamenti avvengono solo quando il file viene importato. Per mantenere i dati aggiornati, dovrai esportare regolarmente il file dalla tua sorgente e caricarlo in Vendably.
Permessi e controllo d'accesso
Le operazioni di importazione sono soggette a controlli di permessi. La tua capacità di creare, modificare o eseguire import dipende dal tuo ruolo:
| Azione | Owner | Admin | Editor | Viewer |
|---|---|---|---|---|
| Creare una nuova sorgente | Sì | Sì | No | No |
| Modificare la configurazione di una sorgente | Sì | Sì | No | No |
| Eseguire un import manuale | Sì | Sì | Sì | No |
| Visualizzare i dati importati | Sì | Sì | Sì | Sì |
| Visualizzare i log di import | Sì | Sì | Sì | Sì |
Se sei un Editor o superiore, puoi avviare un import manuale di una sorgente già configurata. Tuttavia, solo Owner e Admin possono creare nuove sorgenti o modificare il mapping e la configurazione. I Viewer possono solo consultare i dati importati nel Product Hub.
Questi controlli assicurano che i processi di importazione rimangono coerenti e che solo le persone autorizzate possono apportare modifiche strutturali.
Guida pratica: come gli esercenti utilizzano i campi di importazione
Ecco come un esercente tipicamente utilizza le funzioni di importazione:
Scenario 1: Sincronizzazione continua da Shopify
Un rivenditore con un negozio Shopify collega la sua piattaforma a Vendably tramite OAuth. Vendably importa i 5.000 prodotti esistenti e configura i webhook. Da quel momento, ogni volta che il rivenditore aggiorna un prezzo, aggiunge uno sconto, o riceve un ordine che riduce lo stock, questi cambiamenti si sincronizzano automaticamente in Vendably. Il rivenditore può quindi esportare il catalogo aggiornato verso canali come Amazon, eBay o Google Shopping, sapendo che i dati sono sempre coerenti.
Scenario 2: Import pianificato da ERP tramite FTP
Un grossista con un sistema ERP legacy non dispone di un'integrazione OAuth diretta. Tuttavia, il suo ERP può esportare quotidianamente un file CSV con i dati di inventario e prezzo verso un server FTP. Il grossista configura un import pianificato in Vendably che controlla l'FTP ogni notte alle 2 del mattino, scarica il file più recente, e lo importa automaticamente. Al mattino, il team di vendita ha a disposizione i dati aggiornati, inclusi i nuovi prezzi e i livelli di stock correnti.
Scenario 3: Importazione una tantum con mapping personalizzato
Un nuovo esercente migra da un'altra piattaforma e ha un CSV con 2.000 prodotti. Il file utilizza colonne personalizzate: 'nome_articolo' per il titolo, 'prezzo_euro' per il prezzo, e 'codice_interno' per l'ID. Carica il file in Vendably, regola il mapping manualmente per collegare questi campi ai corrispettivi standard di Vendably, e avvia l'import. Vendably elabora i dati, applica eventuali overlay di contenuto (come immagini ottimizzate dal CDN), e il catalogo è pronto per l'esportazione.
Verifica del successo dell'importazione
Dopo aver importato i dati, è essenziale verificare che tutto sia stato elaborato correttamente. Ecco cosa controllare:
-
Stato della sorgente. Nel DataHub, la tua sorgente dovrebbe mostrare uno stato di 'Connesso' (per piattaforme) o 'Importato con successo' (per file). Se lo stato è 'Errore', controlla i log per identificare il problema.
-
Mapping verificato. Accedi alla configurazione della sorgente e verifica che i campi siano mappati correttamente. Se vedi dati vuoti o inaspettati nel Product Hub, il mapping potrebbe essere errato.
-
Dati nel Product Hub. Accedi al Product Hub e verifica che i tuoi prodotti siano presenti con i dati corretti. Controlla alcuni record a campione: titoli, prezzi, disponibilità, immagini. Se i dati appaiono incompleti o corrotti, potrebbe esserci un problema nella post-elaborazione.
-
Rapporto di analisi. Vendably genera un rapporto di analisi dopo ogni import. Consulta questo rapporto per identificare eventuali problemi: campi obbligatori mancanti, valori non validi, o record duplicati. Affrontare questi problemi subito migliora la qualità del listino e riduce i problemi durante l'esportazione verso i canali.
-
Log di import. I log dettagliati registrano ogni passo del processo di importazione. Se qualcosa non funziona, i log ti aiutano a capire esattamente dove e perché.
Se i dati appaiono corretti nel Product Hub, l'importazione è riuscita. Puoi procedere con la configurazione delle regole di feed e l'esportazione verso i tuoi canali di vendita.
Ottimizzazione e best practice
Per ottenere il massimo dalle tue importazioni, considera questi suggerimenti:
-
Usa connessioni OAuth quando possibile. Se la tua piattaforma è supportata (Shopify, WooCommerce, BigCommerce), una connessione OAuth elimina la necessità di import manuali ripetuti e garantisce sincronizzazione in tempo reale.
-
Valida i tuoi dati prima dell'import. Se importi da file, assicurati che i dati siano puliti e coerenti. Rimuovi duplicati, valida i formati di prezzo e data, e verifica che i campi obbligatori siano presenti.
-
Configura il mapping una volta, con attenzione. Dedica tempo a configurare il mapping correttamente la prima volta. Un mapping errato può causare problemi cascata durante l'esportazione.
-
Utilizza overlay di contenuto per completare i dati. Se i tuoi dati di origine mancano di descrizioni dettagliate o immagini di qualità, considera l'utilizzo della libreria di contenuti o della generazione di contenuti con IA per arricchire i tuoi prodotti.
-
Monitora i webhook e gli errori di sincronizzazione. Se usi una connessione OAuth, controlla periodicamente i log per assicurarti che i webhook funzionino correttamente e che non ci siano errori di sincronizzazione.
-
Applica regole di feed per la conformità ai canali. Dopo l'importazione, usa le regole di feed per trasformare e filtrare i tuoi dati secondo i requisiti di ogni canale. Per saperne di più, consulta l'articolo su regole di feed: filtraggio e trasformazione prodotti all'esportazione.
Conclusione
L'importazione di dati prodotto è il primo passo verso un catalogo accurato e coerente. Che tu scelga una connessione diretta a una piattaforma ecommerce per la sincronizzazione in tempo reale, oppure un import da file per un controllo più granulare, Vendably offre gli strumenti e la flessibilità di cui hai bisogno.
Il mapping dei campi assicura che i tuoi dati grezzi siano trasformati correttamente nel formato standard di Vendably. La pipeline di importazione, con le sue fasi di fetch, import, post-processing, analisi e applicazione di overlay, garantisce che i tuoi dati siano elaborati in modo coerente e affidabile.
Dopo l'importazione, verifica sempre che i dati siano corretti nel Product Hub e consulta i rapporti di analisi per affrontare eventuali problemi. Con dati di qualità e ben mappati, sei pronto a esportare il tuo catalogo verso qualsiasi canale di vendita e massimizzare la tua visibilità online.