Introduzione al feed prodotti Klaviyo
Klaviyo è una piattaforma di marketing automation e gestione clienti che consente ai commercianti di sincronizzare il proprio catalogo prodotti per creare campagne email personalizzate, segmentazione basata su comportamenti di acquisto e automazioni di recupero carrello. Il feed prodotti Klaviyo funge da connettore dati centrale che collega il tuo sistema di inventario alle funzionalità di marketing della piattaforma.
A differenza di feed destinati a canali di vendita o marketplace, il feed Klaviyo serve principalmente per arricchire i dati cliente con informazioni prodotto contestuali. Questo significa che la qualità e la completezza del feed incidono direttamente sulla capacità di Klaviyo di personalizzare le comunicazioni, suggerire prodotti rilevanti e tracciare il comportamento di acquisto con precisione.
I commercianti utilizzano questa integrazione catalogo Klaviyo per automatizzare campagne post-acquisto, inviare consigli di prodotto basati su cronologia di navigazione, gestire notifiche di disponibilità e sincronizzare varianti di prodotto con dati di inventario in tempo reale.
Struttura e campi del feed Klaviyo
Il feed prodotti Klaviyo utilizza un set standardizzato di campi che mappano i dati del tuo catalogo. La configurazione feed Klaviyo richiede di compilare campi obbligatori e facoltativi per garantire che i dati siano trasmessi correttamente e che Klaviyo possa utilizzarli nelle automazioni.
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| external_id | Stringa | Sì | Identificatore univoco del prodotto nel tuo sistema. Deve rimanere stabile nel tempo e non deve cambiare tra sincronizzazioni. |
| title | Stringa | Sì | Nome del prodotto. Viene utilizzato nelle email e nei suggerimenti personalizzati. |
| description | Testo | No | Descrizione dettagliata del prodotto. Utilizzata per fornire contesto nei messaggi marketing. |
| url | URL | Sì | Link diretto al prodotto sul tuo sito e-commerce. Deve essere un URL valido e accessibile. |
| image_full_url | URL | No | URL dell'immagine principale del prodotto in alta risoluzione. Utilizzata nei template email. |
| image_thumbnail_url | URL | No | URL della versione in miniatura dell'immagine. Alternativa per rendering mobile o velocità di caricamento. |
| price | Decimale | Sì | Prezzo attuale del prodotto in formato numerico (es. 29.99). Utilizzato per visualizzare il costo nelle comunicazioni. |
| sale_price | Decimale | No | Prezzo scontato, se applicabile. Quando presente, indica un'offerta attiva. |
| brand | Stringa | No | Marchio o produttore del prodotto. Utile per segmentazione e personalizzazione. |
| categories | Stringa | No | Categoria o categorie del prodotto, separate da barra (es. "Abbigliamento/Magliette/Uomo"). Facilita la segmentazione per tipo di prodotto. |
| color | Stringa | No | Colore della variante. Rilevante per prodotti con più opzioni cromatiche. |
| size | Stringa | No | Taglia della variante (es. "M", "L", "XL"). Importante per abbigliamento e calzature. |
| gender | Stringa | No | Genere target del prodotto (es. "Uomo", "Donna", "Unisex"). Utilizzato per segmentazione demografica. |
| gtin | Stringa | No | Global Trade Item Number (codice a barre). Facilita l'identificazione univoca del prodotto. |
| item_group_id | Stringa | No | Identificatore del gruppo prodotto per varianti correlate. Consente di raggruppare varianti di colore, taglia ecc. sotto un prodotto padre. |
| inventory_quantity | Intero | No | Quantità disponibile in magazzino. Utilizzata per notifiche di disponibilità e gestione ordini. |
| inventory_policy | Stringa | No | Politica di inventario (es. "continue" per permettere ordini anche se esaurito, "deny" per bloccare). |
| published | Booleano | No | Stato di pubblicazione del prodotto (true/false). Prodotti non pubblicati non vengono inclusi nelle campagne. |
Mapping campi Klaviyo e configurazione del feed
La configurazione feed Klaviyo inizia con il mapping dei campi del tuo catalogo sorgente ai campi attesi dalla piattaforma. Questo processo garantisce che i dati siano interpretati correttamente e che la sincronizzazione inventario Klaviyo funzioni senza errori.
Identificatori univoci e external_id
L'external_id è il fondamento di qualsiasi feed Klaviyo. Questo campo deve contenere un identificatore stabile e univoco che non cambia mai tra sincronizzazioni successive. Se utilizzi SKU, assicurati che rimangano costanti anche dopo aggiornamenti di inventario o variazioni di prezzo.
Se il tuo sistema utilizza ID numerici interni, puoi utilizzarli direttamente. Se invece usi codici composti (es. "PROD-123-BLU-M" per una variante), mantieni la stessa struttura in ogni sincronizzazione. Klaviyo utilizza questo campo per riconoscere quale record aggiornare e quale è nuovo.
Un errore comune è cambiare la logica di generazione dell'external_id dopo aver già sincronizzato dati. Questo causa la creazione di duplicati e la perdita di storico di acquisto associato al vecchio ID.
Gestione prodotti e varianti
Per prodotti con varianti (colore, taglia, genere), hai due approcci:
-
Varianti come record separati: Ogni combinazione di colore e taglia riceve un external_id univoco e viene sincronizzata come prodotto distinto. Usa item_group_id per raggruppare tutte le varianti sotto lo stesso prodotto padre. Questo approccio è più granulare e consente di tracciare l'inventario per ogni variante.
-
Varianti in un singolo record: Sincronizzi un solo record per prodotto base, omettendo i campi color e size. Questo è meno preciso per l'inventario ma semplifica il feed se non hai bisogno di tracciamento per variante.
Se utilizzi il primo approccio, assicurati che item_group_id sia identico per tutte le varianti dello stesso prodotto. Klaviyo utilizzerà questo campo per raggruppare i record e visualizzarli come un'unica entità nei report e nelle automazioni.
Prezzi e sconti
Il campo price deve contenere il prezzo attuale, indipendentemente dal fatto che sia in sconto. Se il prodotto è in promozione, compila anche sale_price con il prezzo scontato. Klaviyo mostrerà entrambi nei template email, permettendo ai clienti di vedere il risparmio.
Assicurati che il prezzo sia sempre un numero decimale valido (es. "29.99", non "29,99"). Se il tuo sistema utilizza la virgola come separatore decimale, devi convertire il valore prima della sincronizzazione.
URL e immagini
I campi url, image_full_url e image_thumbnail_url devono contenere URL assoluti e completi (es. "https://esempio.it/prodotto-123", non "/prodotto-123"). Klaviyo non risolve URL relativi e non può creare link validi senza il dominio completo.
Per le immagini, fornisci sempre image_full_url per i template email desktop. image_thumbnail_url è opzionale ma consigliato per ottimizzare il caricamento su dispositivi mobili. Assicurati che entrambi gli URL puntino a immagini valide e accessibili pubblicamente. Se un URL è non raggiungibile, Klaviyo non potrà visualizzare l'immagine nei messaggi.
Categorie e segmentazione
Il campo categories consente di organizzare i prodotti in gerarchie logiche. Utilizza il formato "Categoria1/Categoria2/Categoria3" per rappresentare strutture nidificate. Ad esempio: "Abbigliamento/Uomo/Magliette/Cotone".
Klaviyo utilizza questo campo per permettere segmentazione avanzata nelle automazioni. Se desideri inviare email diverse a clienti che hanno acquistato abbigliamento rispetto a chi ha acquistato elettronica, il campo categories consente di creare regole di segmentazione precise.
Inventario e disponibilità
I campi inventory_quantity e inventory_policy controllano come Klaviyo gestisce la disponibilità del prodotto.
Se inventory_policy è impostato su "deny", Klaviyo blocca la visualizzazione del prodotto nelle campagne quando inventory_quantity è zero. Se è "continue", il prodotto rimane visibile anche se esaurito, permettendo ai clienti di effettuare pre-ordini.
Sincronizza inventory_quantity in tempo reale o almeno una volta al giorno per garantire che le notifiche di disponibilità siano accurate. Se sincronizzi raramente, i clienti potrebbero ricevere notifiche di disponibilità per prodotti già esauriti.
Stato di pubblicazione
Il campo published è un booleano (true o false) che indica se il prodotto deve essere incluso nelle campagne Klaviyo. Prodotti con published = false non appariranno nei suggerimenti personalizzati, nelle email di recupero carrello o in altre automazioni.
Utilizza questo campo per escludere prodotti in fase di sviluppo, esauriti permanentemente o non più in catalogo senza doverli eliminare completamente dal feed.
Best practice per l'ottimizzazione feed e-commerce Klaviyo
Validazione dei dati
Prima di sincronizzare il feed, valida la struttura e il contenuto dei dati:
- Verifica che ogni record abbia un external_id univoco e non vuoto.
- Controlla che i campi obbligatori (title, price, url) siano sempre compilati.
- Assicurati che i prezzi siano numeri validi senza valute o simboli.
- Valida gli URL: devono iniziare con "https://" o "http://" e essere raggiungibili.
- Verifica che le immagini siano accessibili e in formati supportati (JPG, PNG).
Frequenza di sincronizzazione
Sincronizza il feed almeno una volta al giorno, preferibilmente durante le ore di minor traffico. Se l'inventario cambia frequentemente, considera sincronizzazioni ogni 4 - 6 ore.
Una sincronizzazione troppo frequente (ogni minuto) non offre vantaggi reali e consuma risorse. Una sincronizzazione troppo rara (settimanale) causa ritardi nella visibilità di nuovi prodotti o aggiornamenti di prezzo.
Gestione dei campi facoltativi
Non riempire un campo facoltativo con valori generici o placeholder (es. "N/D", "Non disponibile"). Se non hai il dato, lascia il campo vuoto. Klaviyo ignora i campi vuoti e non li utilizza nelle automazioni.
Campi come color, size e gender sono particolarmente importanti se il tuo catalogo è ricco di varianti. Se li compili, abilita segmentazione e personalizzazione più sofisticate.
Monitoraggio e correzione errori
Dopo ogni sincronizzazione, controlla i log di Klaviyo per errori o avvisi. Errori comuni includono:
- URL non raggiungibili: correggi il percorso o il dominio.
- Prezzi non validi: assicurati che siano numeri decimali.
- external_id duplicati: verifica la logica di generazione nel tuo sistema.
- Campi obbligatori vuoti: compila title, price e url per ogni record.
Se rilevi errori, correggi i dati nel sistema sorgente e risincronizza. Non tentare di correggere i dati direttamente in Klaviyo, poiché verranno sovrascritti dalla prossima sincronizzazione.
Integrazione con altre piattaforme
Se distribuisci prodotti anche su altri canali (Google Shopping, Facebook Ads, eBay), considera di mantenere un feed master centralizzato e di mappare i campi Klaviyo a quelli richiesti da altre piattaforme. Questo riduce la complessità e garantisce coerenza dei dati.
Puoi utilizzare lo stesso feed CSV o JSON come base e applicare trasformazioni specifiche per ogni canale. Ad esempio, il campo categories di Klaviyo potrebbe essere mappato a google_product_category per Google Shopping.
Sincronizzazione inventario Klaviyo e automazioni
La sincronizzazione inventario Klaviyo è il cuore della gestione prodotti dinamica. Una volta che il feed è configurato correttamente, Klaviyo utilizza i dati per alimentare automazioni complesse.
Notifiche di disponibilità
Se un cliente visualizza un prodotto esaurito (inventory_quantity = 0), Klaviyo può inviare una notifica quando il prodotto torna disponibile. Questo funziona solo se sincronizzi inventory_quantity regolarmente e se il campo published rimane true.
Recupero carrello
Le automazioni di recupero carrello utilizzano i dati del feed per mostrare immagini, prezzi e link corretti ai prodotti abbandonati. Se il prezzo o l'immagine non sono sincronizzati, l'email risulterà datata e meno efficace.
Consigli personalizzati
Klaviyo utilizza i campi brand, categories e color per suggerire prodotti correlati a clienti. Se questi campi non sono compilati, i consigli saranno generici e meno rilevanti.
Segmentazione dinamica
Puoi creare segmenti basati su categorie di prodotto acquistati, fasce di prezzo, marchi preferiti. Tutto dipende dalla qualità e completezza del mapping campi Klaviyo.
Riepilogo e checklist di implementazione
Per implementare correttamente il feed prodotti Klaviyo, segui questa checklist:
- Genera un external_id univoco e stabile per ogni prodotto e variante.
- Compila i campi obbligatori: title, price, url per ogni record.
- Fornisci image_full_url per migliorare l'aspetto delle email.
- Mappa le categorie del tuo catalogo nel campo categories con formato gerarchico.
- Se hai varianti, utilizza item_group_id per raggrupparle.
- Sincronizza inventory_quantity e inventory_policy per gestire la disponibilità.
- Valida il feed prima della sincronizzazione: controlla URL, prezzi, ID univoci.
- Sincronizza almeno una volta al giorno, più frequentemente se l'inventario cambia rapidamente.
- Monitora i log di sincronizzazione e correggi gli errori nel sistema sorgente.
- Testa le automazioni (recupero carrello, notifiche di disponibilità) per verificare che i dati siano utilizzati correttamente.
Una volta che il feed è stabile, potrai sfruttare appieno le capacità di personalizzazione di Klaviyo e creare campagne email altamente rilevanti basate su dati di inventario e catalogo sempre aggiornati.