La sincronizzazione del catalogo è il cuore di Lexiik: il tuo negozio e-commerce e Lexiik comunicano in tempo reale per garantire dati sempre aggiornati. Scopri come funzionano l'import iniziale, la sincronizzazione bidirezionale e l'export dei dati ottimizzati.
Modulo Bridge consigliato
Per una sincronizzazione ottimale, usa il modulo Bridge invece dell'API REST. Il modulo è 10x più performante e gestisce automaticamente gli aggiornamenti incrementali.
Import iniziale del catalogo
Alla tua prima connessione a Lexiik, devi importare l'intero catalogo prodotti. Questa operazione si effettua una sola volta e può richiedere da alcuni minuti a diverse ore in base alle dimensioni del tuo negozio.
Requisiti tecnici
Prima di avviare l'import, assicurati che:
- Il modulo Bridge sia installato: Disponibile per Shopify, WooCommerce, PrestaShop e Magento 2
- I permessi di scrittura siano attivati: Lexiik deve poter modificare le schede prodotto
- Il tuo negozio sia accessibile: Nessuna manutenzione programmata durante l'import
- Le chiavi API siano valide: Verifica nelle impostazioni di connessione
Negozi di grandi dimensioni
Per cataloghi con più di 10.000 prodotti, l'import iniziale può richiedere 2-4 ore. Non chiudere il browser durante questo periodo (il processo continua in background, ma perdi la vista in tempo reale).
Fasi dell'import iniziale
- Connessione al tuo negozio: Seleziona la tua piattaforma (Shopify, WooCommerce, ecc.) e inserisci le tue credenziali API.
- Configurazione dei parametri:
- Selezione delle categorie da importare (o tutto il catalogo)
- Scelta delle lingue da sincronizzare (per i negozi multilingue)
- Attivazione/disattivazione dell'import delle varianti prodotto
- Import delle immagini (fino a 10 immagini per prodotto)
- Validazione e avvio: Lexiik mostra un riepilogo (numero di prodotti, peso totale, durata stimata).
- Elaborazione in background: Una barra di avanzamento mostra il progresso in tempo reale.
- Verifica post-import: Lexiik genera un report con i prodotti importati, gli errori riscontrati e gli avvisi (prodotti senza immagine, prezzi mancanti, ecc.).
Dati importati automaticamente
Durante l'import iniziale, Lexiik recupera:
| Dati | Utilizzo in Lexiik |
|---|---|
| Titolo prodotto | Generazione di title tag e H1 |
| Descrizione breve/lunga | Analisi semantica e arricchimento IA |
| Immagini (URL + ALT esistente) | Computer vision per tag ALT + CDN Lexiik |
| Prezzi (IVA inclusa/esclusa, promozioni) | Dati strutturati schema.org Product |
| Categorie e tag | Breadcrumb e link interni |
| Stock e disponibilità | Schema.org availability (InStock, OutOfStock) |
| SKU e riferimenti | Identificazione univoca e tracciamento delle modifiche |
| Varianti (taglia, colore) | Descrizioni differenziate per variante |
| Recensioni clienti (valutazione media) | Rich snippet con stelle su Google |
Sincronizzazione in tempo reale
Una volta completato l'import iniziale, il modulo Bridge mantiene una sincronizzazione bidirezionale tra il tuo negozio e Lexiik. Ciò significa che le modifiche vengono propagate in entrambe le direzioni, automaticamente e in tempo reale.
Dal tuo negozio a Lexiik (Upstream)
Quando modifichi un prodotto nel tuo back-office (Shopify Admin, WooCommerce, ecc.), il modulo Bridge invia automaticamente le modifiche a Lexiik:
- Nuovo prodotto creato: Aggiunto in Lexiik in meno di 30 secondi
- Prezzo modificato: Aggiornamento dei dati strutturati e del punteggio SEO
- Stock esaurito: Lexiik aggiusta automaticamente lo schema.org (OutOfStock)
- Immagine aggiunta: Analizzata dall'IA per la generazione del tag ALT
- Prodotto eliminato: Rimosso da Lexiik (con conservazione dei dati storici per analytics)
Latenza minima
Il modulo Bridge usa webhooks per rilevare le modifiche istantaneamente. La latenza media è di 5-15 secondi tra una modifica nel tuo negozio e la sua presa in carico in Lexiik.
Da Lexiik al tuo negozio (Downstream)
Al contrario, quando applichi ottimizzazioni in Lexiik (tramite IA o manualmente), le modifiche vengono automaticamente reiniettate nel tuo negozio:
- Meta description ottimizzata: Sostituisce la vecchia descrizione nel SEO della tua scheda prodotto
- Tag ALT generato: Applicato direttamente sull'immagine (attributo alt del tag img)
- Title tag ottimizzato: Aggiornamento del campo SEO Title nel tuo CMS
- Descrizione arricchita: Sostituisce o integra la descrizione lunga esistente
- Dati strutturati: Iniezione automatica del codice JSON-LD nell'HEAD della pagina
Modalità sicura (Piani Expert+)
I piani Expert ed Enterprise hanno accesso alla modalità di validazione manuale: le ottimizzazioni sono salvate in Lexiik ma vengono applicate nel tuo negozio solo dopo validazione umana.
Frequenza di sincronizzazione
| Piano | Sincronizzazione Upstream | Sincronizzazione Downstream |
|---|---|---|
| Gratuito | Ogni 6 ore (cron) | Solo manuale |
| Pro | Tempo reale (webhooks) | Tempo reale (webhooks) |
| Expert/Enterprise | Tempo reale (webhooks) | Tempo reale + Modalità validazione |
Export dei dati ottimizzati
Lexiik permette di esportare i tuoi dati ottimizzati in diversi formati, utile per:
- Migrazione verso un'altra piattaforma (es: WooCommerce → Shopify)
- Backup di sicurezza prima di un'ottimizzazione massiva
- Analisi esterna (import in Excel, Google Sheets, Power BI)
- Integrazione con strumenti terzi (Google Merchant Center, Amazon Seller Central)
Formati di export disponibili
- CSV: Formato universale, compatibile con tutti gli strumenti di analisi
- XML: Standard e-commerce, usato da Google Shopping e marketplace
- JSON: Formato tecnico per integrazioni API avanzate
- Excel (XLSX): Con formattazione, grafici e tabelle pivot (piani Expert+)
Campi esportabili
Puoi selezionare i campi da esportare:
- Dati di base del prodotto (titolo, SKU, prezzo, categorie)
- Metadati SEO (title tag, meta description, tag ALT)
- Punteggi SEO (globale, per pilastro, storico)
- KPI analytics (traffico organico, posizionamento, tasso di conversione)
- Storico delle modifiche (Time Machine)
- Dati strutturati (codice JSON-LD generato)
Export incrementale
Per cataloghi voluminosi (>5000 prodotti), usa l'export incrementale: vengono inclusi solo i prodotti modificati dall'ultimo export (risparmio di tempo e banda).
Automazione degli export
I piani Expert ed Enterprise possono programmare export automatici:
- Frequenza: Giornaliera, settimanale o mensile
- Destinazione: Email, FTP/SFTP, Dropbox, Google Drive, AWS S3
- Formato: CSV, XML o JSON
- Filtri: Per categoria, per punteggio SEO, per data di modifica
Gestione degli errori di sincronizzazione
Errori frequenti e soluzioni
| Errore | Causa probabile | Soluzione |
|---|---|---|
| Errore 403 Forbidden | Permessi di scrittura insufficienti | Verificare i permessi API nel tuo negozio |
| Errore 500 Server Error | Server del negozio non raggiungibile | Verificare lo stato del server, riprovare tra 5-10 min |
| Timeout sincronizzazione | Catalogo troppo voluminoso | Attivare la sincronizzazione a lotti (batch processing) |
| Prodotto duplicato | Collisione di SKU | Unire o rinominare gli SKU duplicati |
| Immagine non caricata | URL non valido o server lento | Verificare l'URL, ottimizzare le immagini (peso < 2 MB) |
Log dettagliati
In caso di errore persistente, consulta i log di sincronizzazione in Impostazioni → Connessioni. Ogni errore è marcato con data/ora, codice HTTP e messaggio dettagliato.
Risincronizzazione manuale
Se la sincronizzazione automatica fallisce, puoi forzare una risincronizzazione completa:
- Accedi a Impostazioni → Connessioni
- Clicca su "Forza la risincronizzazione"
- Seleziona i dati da risincronizzare (prodotti, immagini, prezzi, stock)
- Avvia il processo (durata: 2-30 minuti in base alle dimensioni del catalogo)
Risincronizzazione intelligente
La risincronizzazione manuale usa un algoritmo di diff: vengono elaborati solo i prodotti realmente modificati, il che riduce considerevolmente il tempo di elaborazione.
Casi d'uso e scenari reali
Scenario 1: Migrazione di piattaforma
Stai migrando da WooCommerce a Shopify e vuoi conservare tutte le tue ottimizzazioni SEO:
- Export da Lexiik: Scarica il tuo catalogo ottimizzato in formato CSV
- Import in Shopify: Usa lo strumento nativo di import di Shopify
- Riconnessione a Lexiik: Installa il modulo Bridge Shopify
- Verifica delle corrispondenze: Lexiik abbina automaticamente i prodotti per SKU
- Sincronizzazione finale: Le ottimizzazioni vengono riapplicate sulla nuova piattaforma
Risultato: Migrazione senza perdita di dati SEO, nessun calo del traffico organico.
Scenario 2: Negozio multilingue
Gestisci un negozio in francese, inglese e tedesco. L'import/export di Lexiik gestisce nativamente il multilingue:
- Import iniziale in francese (lingua predefinita)
- Aggiunta manuale delle traduzioni in inglese e tedesco in Lexiik
- Generazione IA di descrizioni localizzate (non traduzione letterale, ma adattamento culturale)
- Export in formato XML multilingue per Google Merchant Center
Scenario 3: Distribuzione sui marketplace
Vuoi pubblicare i tuoi prodotti ottimizzati su Amazon, eBay e Google Shopping:
- Ottimizzazione in Lexiik: Genera descrizioni e tag ALT ottimizzati
- Export in formato XML: Compatibile con i feed di dati dei marketplace
- Import in Google Merchant Center: Tramite upload del feed o API
- Pubblicazione su Amazon Seller Central: Import del file CSV con descrizioni arricchite
Funzione Premium
I piani Enterprise includono connettori nativi per Google Shopping, Amazon ed eBay: la sincronizzazione è automatica e bidirezionale.
Buone pratiche
Prima dell'import iniziale
- Pulisci il tuo catalogo: Elimina i prodotti obsoleti, unisci i duplicati
- Standardizza gli SKU: Usa un formato coerente (es: PROD-001, PROD-002)
- Ottimizza le immagini: Ridimensiona e comprimi (peso target: 200-500 KB per immagine)
- Verifica i dati obbligatori: Prezzo, stock, categoria (altrimenti l'import fallirà)
Durante la sincronizzazione
- Evita modifiche simultanee: Non modificare un prodotto contemporaneamente nel tuo negozio e in Lexiik
- Monitora i log: Controlla regolarmente gli errori di sincronizzazione
- Testa su un campione: Prima di un'ottimizzazione massiva, testa su 10-20 prodotti
Dopo l'export
- Valida l'integrità dei dati: Apri il file CSV/XML e verifica alcune righe
- Conserva una copia locale: Backup di sicurezza in caso di problemi
- Documenta le modifiche: Annota i parametri di export per riprodurre l'operazione
Pronto a sincronizzare il tuo catalogo?
L'import/export e la sincronizzazione in tempo reale sono inclusi in tutti i piani Lexiik, anche nel piano gratuito.
Inizia gratuitamente →