Integrazione Klaviyo

I motori di raccomandazione e automazione di Klaviyo funzionano solo se dispongono di un'immagine aggiornata del tuo catalogo. Una volta sincronizzato il catalogo, Klaviyo combina i dati dei tuoi prodotti con il comportamento sul sito e nelle email (prodotti visualizzati, aggiunte al carrello, avvio del checkout e cronologia degli acquisti) per creare blocchi di raccomandazione personalizzati, attivare notifiche di riassortimento quando le scorte vengono rifornite e popolare le email di carrello abbandonato e di navigazione abbandonata con i prodotti esatti visualizzati dall'acquirente. Klaviyo precisa che i prodotti privi di dati chiave, come un'immagine, vengono automaticamente esclusi dalle raccomandazioni e che gli articoli già acquistati o esauriti vengono filtrati dai blocchi di suggerimenti; pertanto, la completezza e l'accuratezza del feed determinano direttamente l'efficacia di questi flussi.

Una volta sincronizzato un catalogo personalizzato, Klaviyo consente ai marketer di trascinare un blocco prodotto in un flusso o in un'email di campagna e popolarlo dinamicamente, senza dover scrivere codice HTML, poiché la documentazione di Klaviyo specifica che "i blocchi prodotto non supportano alcun codice HTML personalizzato". Questi blocchi possono includere prodotti visualizzati di recente (in base alla metrica "Prodotti visualizzati"), articoli simili a quelli visualizzati o ordinati da un cliente, prodotti aggiunti al carrello (dagli eventi "Aggiunto al carrello" o "Avvio del checkout") o le classiche liste dei bestseller e statiche. Per casi d'uso più avanzati, come un motore di raccomandazione proprietario, Klaviyo supporta anche i tag di ricerca del catalogo che fanno riferimento a articoli specifici tramite il loro ID univoco all'interno dei modelli. Tutto ciò dipende dal fatto che il feed del catalogo contenga record di articoli puliti e completi con gli identificatori corretti.

Klaviyo supporta due modalità per la sincronizzazione di un catalogo esterno: un feed di catalogo personalizzato ospitato su server esterni oppure l'integrazione diretta tramite l'API Cataloghi.

Per un feed ospitato, Klaviyo accetta JSON o XML ; il formato CSV non è supportato. Il feed deve essere accessibile pubblicamente tramite HTTPS e Klaviyo lo scarica a intervalli fissi, non su richiesta. La guida di Klaviyo specifica che i dati nel feed devono essere "a un solo livello di profondità, non annidati in JSON o XML" (l'unica eccezione documentata sono i feed di Google Merchant Center), che il primo elemento del feed deve contenere tutti i campi che si intendono mappare affinché Klaviyo possa rilevare lo schema e che nessun campo obbligatorio deve essere lasciato vuoto: Klaviyo consiglia di utilizzare "0" per i numeri non disponibili e "n/d" per il testo non disponibile, anziché omettere il campo. I file del feed possono raggiungere i 100 MB, sebbene Klaviyo raccomandi di rimanere al di sotto dei 50 MB per un'elaborazione affidabile, e i cataloghi più grandi possono essere suddivisi in più file che confluiscono in un unico catalogo.

In alternativa, i sistemi che necessitano di aggiornamenti in tempo reale o basati su eventi possono inviare elementi direttamente tramite l'API Cataloghi di Klaviyo, che utilizza un formato ID risorsa di {integration_type}:::{catalog_type}:::{external_id} - Per esempio $custom:::$default:::3829918373-TShirt-1. Klaviyo attualmente supporta solo il $custom tipo di integrazione abbinato con $default tipo di catalogo.

Feedance genera il feed di catalogo JSON o XML ospitato che Klaviyo si aspetta, mappato campo per campo allo schema di Klaviyo, in modo che tu non debba creare manualmente un feed piatto a nodo singolo o gestire un'integrazione API personalizzata.

1. In Feedance, crea un nuovo feed e seleziona Klaviyo come modello di destinazione.
2. Associa i dati del tuo prodotto ai campi obbligatori di Klaviyo ($id, $title, $description, $link, $image_link) e aggiungi i campi opzionali che desideri utilizzare, come $price, $inventory_quantity, $inventory_policy e le categorie.
3. Pubblica il feed per ottenere da Feedance un URL pubblico ospitato su HTTPS.
4. In Klaviyo, vai su Contenuti > Prodotti > Gestisci fonti di catalogo personalizzate, fai clic su Aggiungi nuova fonte e incolla l'URL del feed di Feedance.
5. Configura la mappatura dei campi nella pagina Origini personalizzate di Klaviyo per verificare che ogni attributo sia allineato correttamente, quindi contatta l'assistenza di Klaviyo fornendo i nomi delle metriche pertinenti e i nomi delle proprietà ID articolo, in modo che il loro team possa finalizzare il catalogo per la produzione, come richiesto dal flusso di configurazione di Klaviyo.
6. Una volta che Klaviyo conferma che il catalogo è attivo, monitora la prima sincronizzazione in Feedance e in Klaviyo per individuare eventuali problemi di mappatura prima che i blocchi di raccomandazione o i flussi "Torna a magazzino" vengano pubblicati.

Klaviyo scarica i feed di catalogo personalizzati con un ciclo fisso di 6 ore . Se il tuo feed si trova dietro un livello di caching, la documentazione di Klaviyo avverte che è necessario disabilitare la cache o aggiornarla manualmente quando i dati sottostanti cambiano, altrimenti Klaviyo continuerà a scaricare dati obsoleti dalla cache anche dopo gli aggiornamenti della fonte. Oltre alla sincronizzazione del feed, i modelli di raccomandazione di Klaviyo necessitano di un proprio periodo di addestramento: la piattaforma afferma che in genere occorrono da 2 giorni a una settimana affinché i suoi sistemi si addestrino su un nuovo catalogo e che i modelli di raccomandazione vengono generalmente riaddestrati ogni 2-7 giorni a seconda dell'utilizzo. Feedance aggiorna il tuo feed in modo affidabile con la cadenza di 6 ore di Klaviyo, garantendo che le modifiche a prezzi, inventario e nuovi prodotti continuino a confluire nel ciclo di addestramento il più rapidamente possibile, compatibilmente con l'architettura di Klaviyo.

La documentazione di Klaviyo relativa alla sincronizzazione e alla risoluzione dei problemi elenca diverse cause ricorrenti di errori di sincronizzazione del catalogo:

• Feed non accessibile: Klaviyo non riesce a raggiungere l'URL di origine, in genere perché è protetto da password o bloccato da un altro livello di sicurezza.
• Dati memorizzati nella cache non aggiornati: Un livello di caching davanti all'URL del feed fornisce a Klaviyo una vecchia versione del file, quindi gli aggiornamenti non vengono visualizzati finché la cache non viene svuotata o aggiornata.
• Strutture dati annidate: Il parser di Klaviyo si aspetta dati "a un solo livello di profondità", quindi i JSON o XML annidati (al di fuori dell'eccezione del feed di Google Merchant) non verranno mappati correttamente.
• Primo elemento incompleto: Poiché Klaviyo utilizza il primo elemento del feed per rilevare lo schema, un elemento privo di campi che compaiono successivamente nel file può causare l'eliminazione di tali campi per l'intero catalogo.
• Identificativi duplicati o mancanti: Klaviyo offre un articolo dedicato alla risoluzione dei problemi relativi agli errori di identificatori duplicati o mancanti e, per quanto riguarda l'API Cataloghi, il tentativo di creare un elemento con un external_id già esistente restituisce un errore 409 Conflict; gli errori di elaborazione in blocco elencano il campo specifico e la causa in un array di errori nella risposta dell'API.
• Immagini mancanti: Gli elementi privi di URL dell'immagine vengono esclusi dal motore di raccomandazione di Klaviyo, anche se il resto della scheda è valido.

Mantieni stabile l'ID articolo a ogni sincronizzazione: Klaviyo abbina gli articoli in base a questo valore, quindi un ID variabile fa sì che Klaviyo tratti un prodotto esistente come nuovo e reimposti qualsiasi raccomandazione accumulata e la cronologia dell'inventario per esso. Compila tutti i campi opzionali che Klaviyo può utilizzare per l'automazione, in particolare $price e $inventory_quantity, poiché i dati di inventario sono necessari per attivare i flussi "Torna in stock" e i dati sui prezzi alimentano le campagne di riduzione dei prezzi. Assicurati che ogni articolo abbia un URL immagine HTTPS valido, poiché Klaviyo rimuove silenziosamente i prodotti senza immagine dai blocchi di raccomandazione anziché generare un errore. Se gestisci più di circa 50 MB di dati di catalogo, suddividili in più file di feed che puntano allo stesso catalogo anziché inviare un unico file di grandi dimensioni. Inoltre, se il tuo catalogo si avvicina ai limiti documentati da Klaviyo di 250,000 articoli, 500,000 varianti o 2,500 categorie, o se il tuo feed supererà 1 milione di articoli, pianifica di contattare l'assistenza Klaviyo prima della configurazione, seguendo le loro indicazioni.

Klaviyo accetta feed CSV?
No. La sincronizzazione del feed del catalogo personalizzato di Klaviyo accetta solo JSON o XML; il formato CSV non è supportato.

In che modo un feed di catalogo personalizzato si differenzia dall'API Cataloghi?
Un feed di catalogo personalizzato è un file ospitato che Klaviyo scarica autonomamente ogni 6 ore. L'API Cataloghi consente di inviare direttamente le creazioni, gli aggiornamenti e le eliminazioni degli articoli, una soluzione ideale per i commercianti che necessitano di aggiornamenti più rapidi o basati su eventi rispetto a quanto offerto da un feed a polling.

Perché il mio catalogo non si aggiorna in Klaviyo?
Le cause più comuni documentate da Klaviyo sono un livello di caching che fornisce dati obsoleti, un URL del feed diventato inaccessibile o protetto, oppure una struttura del feed malformata/annidata che non soddisfa il requisito di Klaviyo di un singolo nodo.

Di cosa ho bisogno nel mio feed per attivare le notifiche di ritorno in magazzino?
La guida "Torna in stock" di Klaviyo richiede che il campo $inventory_quantity sia presente su ogni articolo del feed del catalogo personalizzato; senza di esso, Klaviyo non riceve alcun segnale di disponibilità per attivare una notifica di riassortimento.

Posso utilizzare codice HTML personalizzato nei blocchi di raccomandazione dei prodotti di Klaviyo?
No. La documentazione di Klaviyo afferma che i blocchi prodotto non supportano HTML personalizzato; la formattazione avanzata richiede invece l'utilizzo dell'opzione Sorgente in un blocco di testo o dei tag di ricerca del catalogo.