Informazioni sull'importazione del magazzino dati in Klaviyo
Advanced Klaviyo Data Platform non è incluso nell'applicazione di marketing standard di Klaviyo e per accedere alle funzionalità associate è necessario un abbonamento. Visita la nostra guida alla fatturazione per scoprire come acquistare questo piano.
Introduzione
L’importazione del magazzino dati consente a Klaviyo di connettersi direttamente al tuo magazzino dati Snowflake, BigQuery, Redshift o Databricks e configurare sincronizzazioni di importazione per tabelle (o viste) di dati di profilo ed evento.
Come funziona l'importazione del magazzino dati in Klaviyo?
Dopo aver stabilito una connessione al tuo data warehouse, puoi selezionare un set di dati (ad es. una tabella o una vista) da sincronizzare.
La tabella o la vista deve includere una colonna con timestamp che registri quando ogni riga è stata aggiunta o aggiornata, ad esempio updated_at o modified_at. Seleziona questa colonna in Rilevamento modifiche quando configuri la sincronizzazione. Aggiorna il suo valore ogni volta che una riga cambia e non riportarlo indietro a un orario precedente.
Per una sincronizzazione del profilo, includi almeno 1 identificatore del profilo, ad esempio un indirizzo e-mail, un numero di telefono o un ID esterno. Associa le colonne di dati alle Proprietà del profilo che vuoi aggiornare, incluse le proprietà personalizzate.
Per una sincronizzazione degli eventi, mappa un timestamp dell'evento e almeno 1 identificatore del profilo. Scegli un singolo tipo di evento per la sincronizzazione oppure mappa una colonna contenente un tipo di evento per ogni riga. Usa una colonna separata per il rilevamento delle modifiche, in modo che le date storiche degli eventi non determinino quando le righe vengono incluse per l'importazione.
Le sincronizzazioni pianificate importano i dati esistenti e continuano a importare nuove righe o righe aggiornate all’intervallo che scegli (ad esempio, ogni ora o ogni giorno), usando il timestamp di rilevamento delle modifiche per identificare i cambiamenti. Le sincronizzazioni dei profili creano o aggiornano i profili; le sincronizzazioni degli eventi aggiungono eventi.
Puoi anche scegliere una sincronizzazione manuale, che viene eseguita quando selezioni Esegui sincronizzazione.
Se non hai un set di dati completamente unito con tutti i campi che vuoi sincronizzare, puoi creare più sincronizzazioni con diverse mappature dei campi (ad esempio, informazioni di contatto, saldi fedeltà e segmenti personalizzati).
Quando utilizzi più sincronizzazioni del profilo, usa identificatori coerenti tra le tue tabelle per aiutare ad associare le righe allo stesso profilo. Ogni Proprietà del profilo non identificativa può essere mappata da una sola origine; gli identificatori possono essere riutilizzati tra le origini.
Il consenso per e-mail e messaggistica di testo utilizza gli stessi valori e formati validi dei caricamenti di file o SFTP. Per i campi di consenso e le indicazioni sulla formattazione, consulta Come importare iscritti in una lista.
Casi d'uso comuni
Gestione del profilo
- Crea nuovi profili in Klaviyo che hanno origine in sistemi non integrati direttamente con Klaviyo (es. sistemi POS, di prenotazione o di gestione degli ordini).
- Aggiorna le informazioni del profilo in Klaviyo da origini offline disponibili in magazzino.
Potenziamento del profilo
- Sincronizza i saldi del programma fedeltà in una proprietà personalizzata Loyalty_Balance.
- Sincronizza punteggi o categorie da modelli personalizzati in esecuzione nel data warehouse (ad es. punteggi di intent per eventi del ciclo di vita su misura, categorie di affinità, rischio di churn (tasso di abbandono) o metriche LTV).
- Sincronizza i dati di arricchimento demografici o comportamentali di terze parti nelle proprietà personalizzate del profilo.
- Sincronizza i touch point di assistenza o servizio in campi profilo personalizzati per rappresentare se il cliente ha richieste di assistenza aperte, i giorni trascorsi dall’ultima visita di assistenza o la categoria più recente dell’interazione con l’assistenza.
Segmentazione personalizzata
- Esegui una segmentazione complessa nel warehouse e sincronizza i nomi dei segmenti con le Proprietà del profilo da usare come criteri nei segmenti o nei flussi.
- Esegui la segmentazione in-warehouse basata su dati sensibili, riservati o regolamentati e sincronizza le assegnazioni ai gruppi di segmenti o i flag del profilo con nomi sanitizzati (ad esempio, Gruppo A, Gruppo B) come Proprietà del profilo personalizzata.
Guida alla configurazione
Stabilire una connessione
Questi articoli forniscono istruzioni dettagliate per configurare l'importazione del magazzino dati.
Connessione tra Klaviyo e Redshift
Connessione di Klaviyo e Databricks
Crea una sincronizzazione di importazione del profilo
Dopo aver preparato il magazzino e aver convalidato la connessione, crea una sincronizzazione dell'importazione del profilo in Klaviyo:
- Vai a Avanzate > Gestione dati > Sincronizzazione, quindi seleziona la connessione del tuo magazzino.
- Clicca su Aggiungi fonte. Inserisci un nome univoco per la sincronizzazione nel campo Nome e seleziona la tabella o la vista in Origine dati.
- Seleziona Profili in Tipi di oggetti dati.
- In Cadence, scegli Pianifica esecuzione e imposta l’intervallo, la data di inizio, l’ora di inizio e il fuso orario. Scegli Manuale se vuoi avviare tu ogni esecuzione.
- Clicca su Avanti. In Rilevamento delle modifiche, seleziona la colonna del timestamp in Rilevamento nuove righe. Mappa almeno 1 identificatore del profilo e le altre Proprietà del profilo che vuoi importare.
- Fai clic su Fine per salvare la sincronizzazione.
Se hai scelto Manuale, apri la sincronizzazione salvata e seleziona Esegui sincronizzazione per iniziare l’importazione.
Importazione dei dati dell'evento
Per i campi specifici dell’evento e le istruzioni di configurazione, consulta Comprendere l’importazione di eventi dal magazzino dati in Klaviyo.
Risoluzione dei problemi di sincronizzazione
Se una sincronizzazione non importa i dati che ti aspetti, controllane lo stato e i dettagli dell'errore prima di testare i dati del tuo profilo con un caricamento CSV.
- Vai su Avanzate > Gestione dati > Sincronizzazione, seleziona la connessione del magazzino, quindi fai clic sul nome della sincronizzazione.
- Nella scheda Runs, controlla i conteggi Ingested e Failed. Uno stato Completato può comunque includere righe non riuscite.
- Per un’esecuzione completata con righe non riuscite, apri il menu dell’esecuzione e seleziona Scarica file degli errori se l’opzione è disponibile.
- Apri la scheda Registri e controlla i registri Periodici o Cronologici per i dettagli sulla sincronizzazione interessata.
Convalida i dati del profilo con un'importazione CSV
Un’importazione CSV può aiutarti a identificare i problemi di formattazione dei dati del profilo, soprattutto con i valori di consenso e i timestamp. Non testa la connessione al tuo magazzino né la configurazione del rilevamento delle modifiche della sincronizzazione. Per la procedura di caricamento completa, vedi Come importare iscritti in un elenco.
Usa un elenco di test separato senza flussi attivati dall’elenco. L’importazione continua a creare o aggiornare i profili nel tuo account e applica eventuali valori di consenso che mappi dal file.
- Esporta la tabella o la vista del tuo profilo in un file CSV.
- Vai su Pubblico > Elenchi e segmenti in Klaviyo.
- Seleziona un elenco di test separato oppure crea un nuovo elenco per i test.
- Seleziona Importa contatti nel menu Gestisci lista in alto a destra.
- Carica il file CSV dal passaggio 1.
- Associa le colonne che vuoi testare alle stesse Proprietà del profilo di Klaviyo e agli stessi tipi di dati usati dalla sincronizzazione del tuo data warehouse.
- Se dopo la mappatura visualizzi Avanti, fai clic su di esso, quindi seleziona No nella schermata di conferma del consenso per evitare di aggiungere il consenso in blocco. I valori di consenso mappati dal file si applicano comunque.
- Clicca su Importa. Al termine dell’elaborazione, controlla i dettagli dell’importazione e, se disponibile, seleziona Scarica file degli errori per vedere le righe saltate e i relativi errori.
Correggi eventuali errori nei dati del tuo magazzino e aggiorna i timestamp di rilevamento delle modifiche delle righe interessate per riflettere quando li hai corretti, in modo che una successiva sincronizzazione incrementale possa importarli.