Introduzione al feed prodotti Klaviyo
Klaviyo è una piattaforma di email marketing e automazione che consente ai merchant di sincronizzare il catalogo prodotti con le loro campagne. Il feed prodotti Klaviyo funge da ponte tra il tuo sistema di e-commerce e la piattaforma di comunicazione, permettendo di inviare raccomandazioni personalizzate, notifiche di carrello abbandonato e offerte mirate basate su dati di inventario in tempo reale.
I merchant utilizzano il feed Klaviyo per tre ragioni principali: mantenere i dati prodotto sincronizzati e aggiornati, garantire che le informazioni visualizzate nei messaggi email rispecchino lo stato reale del catalogo, e abilitare segmentazione avanzata basata su attributi prodotto come categoria, prezzo e disponibilità.
Struttura e campi del feed
Il feed Klaviyo accetta i seguenti campi:
| Campo | Tipo | Obbligatorio | Descrizione | Impatto |
|---|---|---|---|---|
| external_id | Stringa | Sì | Identificatore univoco del prodotto nel tuo sistema | Necessario per la sincronizzazione e l'abbinamento dei record |
| title | Stringa | Sì | Nome del prodotto | Visualizzato nei messaggi email e nelle raccomandazioni |
| description | Stringa | No | Descrizione dettagliata del prodotto | Fornisce contesto nei messaggi personalizzati |
| url | Stringa (URL) | Sì | URL della pagina prodotto | Consente ai clienti di raggiungere il prodotto dal messaggio |
| image_full_url | Stringa (URL) | Consigliato | URL dell'immagine principale del prodotto | Visualizzata nei template email e blocchi di raccomandazione |
| image_thumbnail_url | Stringa (URL) | No | URL dell'immagine in miniatura | Alternativa per contesti con spazio limitato |
| price | Numero decimale | Sì | Prezzo standard del prodotto in centesimi | Visualizzato nei messaggi e utilizzato per logica di filtro |
| sale_price | Numero decimale | No | Prezzo promozionale in centesimi | Consente di evidenziare sconti nei messaggi |
| categories | Array di stringhe | No | Categorie di appartenenza del prodotto | Abilita segmentazione e filtri nelle campagne |
| inventory_quantity | Numero intero | No | Quantità disponibile in magazzino | Controlla la visualizzazione del prodotto nelle raccomandazioni |
| inventory_policy | Stringa | No | Politica di gestione dell'inventario (es. "allow", "deny") | Determina se il prodotto può essere promosso quando esaurito |
| published | Booleano | No | Indica se il prodotto è pubblicato e visibile | Prodotti non pubblicati non vengono inclusi nelle campagne |
| brand | Stringa | No | Marca del prodotto | Utilizzata per segmentazione e personalizzazione |
| color | Stringa | No | Colore disponibile | Abilita filtri e segmentazione per variante |
| size | Stringa | No | Taglia disponibile | Abilita filtri e segmentazione per variante |
| gender | Stringa | No | Categoria di genere (es. "male", "female", "unisex") | Consente targeting mirato per categorie specifiche |
| gtin | Stringa | No | Codice EAN, UPC o ISBN del prodotto | Migliora la tracciabilità e l'integrazione con sistemi terzi |
| item_group_id | Stringa | No | Identificatore del gruppo di varianti | Raggruppa varianti dello stesso prodotto base |
Campi critici e loro funzioni
external_id: l'ancoraggio della sincronizzazione
Il campo external_id è l'identificatore univoco che Klaviyo utilizza per abbinare i record nel feed ai prodotti già presenti nel catalogo. Ogni volta che il feed viene aggiornato, Klaviyo cerca il record con lo stesso external_id per aggiornare i dati.
Se l'external_id non è coerente tra gli aggiornamenti, Klaviyo creerà duplicati di prodotto nel catalogo. Questo causa errori nelle campagne, messaggi con dati incoerenti e difficoltà nella manutenzione del catalogo. Utilizza sempre lo stesso valore di external_id per lo stesso prodotto, indipendentemente dagli aggiornamenti successivi.
title e description: leggibilità e contesto
Il campo title deve contenere il nome del prodotto esatto e riconoscibile. Evita abbreviazioni eccessive o codici interni. Il title è visualizzato direttamente nei template email, quindi una descrizione chiara e accurata migliora il tasso di clic.
Il campo description fornisce contesto aggiuntivo che può essere utilizzato nei blocchi di raccomandazione dinamici. Una descrizione ben strutturata, concisa e focalizzata sui benefici del prodotto aumenta la probabilità che il cliente completi l'acquisto.
url: il collegamento al prodotto
L'url deve puntare direttamente alla pagina prodotto e deve essere un URL assoluto completo (es. https://www.tuo-negozio.it/prodotto/nome-prodotto). URL relativi o malformati causano errori di tracciamento e impediscono ai clienti di raggiungere il prodotto.
Garanti che l'URL sia stabile nel tempo. Se modifichi la struttura degli URL del tuo sito, devi aggiornare il feed Klaviyo contemporaneamente per evitare link non funzionanti.
price e sale_price: logica commerciale
Il campo price deve contenere il prezzo standard del prodotto espresso in centesimi (es. 2999 per 29,99 euro). Il campo sale_price contiene il prezzo promozionale, se applicabile.
Klaviyo utilizza questi campi per logica condizionale nelle campagne: puoi mostrare il badge "In offerta" solo quando sale_price è inferiore a price, oppure escludere prodotti sopra una certa fascia di prezzo dalle raccomandazioni. Assicurati che i prezzi siano sempre numerici e coerenti con la valuta utilizzata nel tuo account Klaviyo.
categories: segmentazione e filtri
Il campo categories deve contenere un array di stringhe che rappresentano le categorie di appartenenza del prodotto. Utilizza una gerarchia coerente (es. ["Abbigliamento", "Abbigliamento.Uomo", "Abbigliamento.Uomo.Magliette"]).
Le categorie abilita segmentazione avanzata: puoi creare campagne specifiche per clienti interessati a categorie particolari, escludere categorie specifiche dalle raccomandazioni, o personalizzare il contenuto in base alle preferenze storiche del cliente. Una struttura di categorie ben organizzata è fondamentale per campagne mirate.
inventory_quantity e inventory_policy: controllo della visibilità
Il campo inventory_quantity deve contenere la quantità disponibile in magazzino. Klaviyo utilizza questo valore per decidere se mostrare il prodotto nelle raccomandazioni dinamiche: un prodotto con inventory_quantity pari a 0 non viene solitamente incluso.
Il campo inventory_policy controlla il comportamento quando l'inventario è esaurito. Se impostato a "deny", il prodotto non viene promosso quando non disponibile. Se impostato a "allow", il prodotto può essere promosso anche se esaurito (utile per preordini o prodotti a breve disponibilità).
Aggiorna questi campi con frequenza almeno giornaliera per evitare di promuovere prodotti non disponibili, il che causa frustrazione nei clienti e riduce la fiducia nel tuo brand.
image_full_url: l'elemento visivo critico
L'image_full_url deve puntare a un'immagine di alta qualità del prodotto. Utilizza URL assoluti e assicurati che l'immagine sia accessibile pubblicamente (non protetta da autenticazione).
Le immagini sono l'elemento più impattante nei template email e nei blocchi di raccomandazione. Un'immagine mancante o non caricata riduce significativamente il tasso di clic. Testa regolarmente che gli URL delle immagini siano validi e che le immagini si carichino correttamente nei client email.
published: il controllo di visibilità globale
Il campo published è un booleano che controlla se il prodotto è visibile nelle campagne Klaviyo. Se impostato a false, il prodotto non viene incluso in alcuna raccomandazione dinamica, indipendentemente da altri fattori.
Utilizza questo campo per escludere rapidamente prodotti dal catalogo attivo senza eliminarli dal feed. Questo è utile per prodotti stagionali, articoli in fase di discontinuazione o prodotti in manutenzione.
color, size, gender: attributi di variante
Questi campi descrivono varianti specifiche del prodotto. Se il tuo feed contiene varianti separate (es. una riga per ogni combinazione di colore e taglia), popola questi campi di conseguenza.
Gli attributi di variante abilitano filtri granulari nelle campagne: puoi escludere taglie specifiche dalle raccomandazioni, oppure personalizzare il messaggio in base alla preferenza storica del cliente per un colore particolare.
gtin e item_group_id: organizzazione strutturale
Il campo gtin deve contenere il codice EAN, UPC o ISBN del prodotto. Questo codice è utilizzato per tracciabilità, conformità normativa e integrazione con marketplace e sistemi di terzi.
Il campo item_group_id raggruppa tutte le varianti di uno stesso prodotto base. Se hai tre varianti dello stesso maglietta (colori diversi), assegna loro lo stesso item_group_id. Questo consente a Klaviyo di comprendere la relazione tra varianti e di applicare logica di raccomandazione più intelligente.
Configurazione e sincronizzazione del feed
Formato e frequenza di aggiornamento
Klaviyo accetta feed in formato JSON o CSV. Il formato JSON è consigliato per integrazioni API, mentre CSV è appropriato per upload manuali o sincronizzazioni batch.
Configura la frequenza di aggiornamento in base alla volatilità dei tuoi dati. Se i prezzi e l'inventario cambiano frequentemente, sincronizza il feed almeno una volta al giorno. Se i dati cambiano raramente, una sincronizzazione settimanale è sufficiente.
Validazione dei dati
Prima di inviare il feed a Klaviyo, valida i dati secondo questi criteri:
- Tutti i campi obbligatori (external_id, title, url, price) sono presenti e non vuoti.
- Gli URL sono assoluti e ben formati (iniziano con http:// o https://).
- I prezzi sono numeri interi positivi (in centesimi).
- Gli external_id sono univoci all'interno del feed.
- Le immagini sono accessibili pubblicamente e in formato standard (JPG, PNG).
- I booleani (published) sono rappresentati come true/false, non come stringhe.
Errori di validazione causano fallimenti di sincronizzazione o importazioni parziali che lasciano il catalogo in uno stato incoerente.
Gestione dei duplicati e degli aggiornamenti
Quando invii un feed aggiornato, Klaviyo abbina i record in base all'external_id. Se un external_id non esiste nel catalogo, il prodotto viene creato. Se esiste, i campi vengono aggiornati.
Non rimuovere prodotti dal feed semplicemente omettendoli. Se desideri disattivare un prodotto, imposta published a false. Se desideri eliminarlo completamente, utilizza l'API Klaviyo per eliminare il record.
I duplicati causati da external_id incoerenti creano confusione nelle campagne e complicano l'analisi dei dati. Implementa un processo di validazione robusto prima dell'invio.
Strategie di ottimizzazione
Completezza dei dati
Ogni campo aggiuntivo che popoli aumenta la qualità complessiva del feed. Completa almeno image_full_url, categories e brand per ogni prodotto. Questi campi abilitano logica di raccomandazione più sofisticata e migliorano la rilevanza delle campagne.
I feed incompleti limitano le opzioni di segmentazione disponibili e riducono il potenziale delle campagne personalizzate.
Coerenza tra sistemi
Assicurati che i dati nel feed Klaviyo corrispondano sempre ai dati nel tuo e-commerce. Se un prodotto è esaurito nel tuo negozio, deve essere esaurito anche nel feed. Se il prezzo cambia, aggiorna il feed entro poche ore.
Le incoerenze tra sistemi causano esperienze frustranti per i clienti: ricevono un'email che promuove un prodotto, lo cliccano, scoprono che è esaurito.
Descrizioni e titoli ottimizzati
Scrivi title e description focalizzandoti su chiarezza e benefici. Evita jargon interno, acronimi non spiegati e descrizioni generiche. Un title come "Maglietta blu in cotone 100%" è più efficace di "SKU-12345-BLU".
Le descrizioni ben scritte aumentano il tasso di conversione perché forniscono ai clienti le informazioni necessarie per prendere una decisione d'acquisto senza dover visitare la pagina prodotto.
Monitoraggio e manutenzione
Implementa un processo di controllo qualità regolare sul feed. Estrai campioni casuali di prodotti dal catalogo Klaviyo e verifica che i dati siano accurati e aggiornati.
Monitora il numero di errori di sincronizzazione nel tempo. Un aumento improvviso di errori indica un problema nella generazione del feed che deve essere indagato.
Crea avvisi per situazioni critiche: prodotti con image_full_url mancante, inventory_quantity negativo, o price pari a zero. Questi problemi riducono significativamente l'efficacia delle campagne.
Integrazione con le campagne
Una volta sincronizzato il feed, i dati prodotto diventano disponibili nei template email e nei blocchi di raccomandazione dinamici. Puoi utilizzare i campi del feed per:
- Personalizzare il contenuto in base alla categoria di interesse del cliente.
- Mostrare il prezzo e l'etichetta "In offerta" quando sale_price è presente.
- Escludere prodotti esauriti dalle raccomandazioni utilizzando inventory_quantity.
- Filtrare prodotti in base a brand, colore o altri attributi per creare segmenti specifici.
- Visualizzare immagini di alta qualità nei template email.
La qualità dei dati nel feed determina direttamente la qualità e la rilevanza delle campagne Klaviyo.
Conclusione
Il feed prodotti Klaviyo è lo strumento fondamentale per sincronizzare il catalogo con la piattaforma di email marketing. Una gestione accurata dei campi, una sincronizzazione regolare e il monitoraggio continuo della qualità dei dati garantiscono che le tue campagne siano sempre basate su informazioni accurate e aggiornate.
Investi tempo nella configurazione corretta del feed e nella validazione dei dati. I benefici, in termini di tasso di conversione e soddisfazione del cliente, compensano ampiamente lo sforzo iniziale.