Imparerai
Scopri come sincronizzare i dati da Klaviyo al tuo magazzino dati e importare i dati del magazzino dati in Klaviyo tramite SFTP. Puoi sincronizzare la tua profilazione clienti e i dati degli eventi, e in questo modo puoi archiviare e analizzare le informazioni chiave sui tuoi clienti anche al di fuori di Klaviyo.
Advanced KDP e Klaviyo Marketing Analytics non sono inclusi nell'applicazione di marketing standard di Klaviyoe per accedere alle relative funzionalità è necessario un abbonamento. Visita la nostra guida alla fatturazione per scoprire come acquistare questi piani.
Prima di iniziare
Dovrà assicurarsi che il data warehouse con cui si sta collegando sia configurato come destinazione. Per assicurarsi di averla impostata correttamente:
- Si assicuri che l'utente fornito a Klaviyo abbia le giuste autorizzazioni.
- Si assicuri di impostare le tabelle con i nomi appropriati, indicati di seguito, in base al suo magazzino.
Inoltre, si assicuri di inserire nell'elenco degli indirizzi IP del traffico del data warehouse in uscita di Klaviyo. Questo farà sì che le richieste di Klaviyo non vengano bloccate dal suo livello di sicurezza. Questi indirizzi sono rappresentati dai seguenti intervalli CIDR:
184.72.183.187/3252.206.71.52/323.227.146.32/3244.198.39.11/3235.172.58.121/323.228.37.244/3254.88.219.8/323.214.211.176/32
Collegarsi a un data warehouse
Per aggiungere una connessione a Klaviyo, vai su Gestione avanzata della piattaforma dati Klaviyo > > Sincronizzazione.
- Per aggiungere un data warehouse, clicchi sul pulsante Nuova connessione .
- Nella maschera Seleziona una destinazione , selezioni un data warehouse supportato da collegare a Klaviyo.
Può avere solo 1 destinazione di data warehouse per account.
In alternativa, puoi selezionare il tuo magazzino dati dalla directory di integrazione di Klaviyo, accedendo a Account > Integrazione.
Nel collegare un magazzino, puoi sia importare i dati dal magazzino dati in Klaviyo, sia impostare un magazzino come destinazione di sincronizzazione in uscita.
Importa i dati via SFTP
Se desideri importare i dati dal magazzino dati in Klaviyo, puoi farlo tramite SFTP.
Per importare i dati in Klaviyo, seleziona Importa dati quando colleghi per la prima volta una destinazione di magazzino, oppure clicca sul pulsante Importa nella pagina di sincronizzazione dei dati, se ha già stabilito una connessione.
Il processo per importare i dati del magazzino in Klaviyo è il seguente:
- Esporta i dati desiderati dal tuo magazzino dati.
- Genera chiavi SSH sul tuo computer locale.
- Configura il client SFTP e importa.
Questo è dimostrato con Snowflake, ma il processo di importazione è simile indipendentemente dall'integrazione del magazzino.
Esporta il tuo database
Per prima cosa, dovrai esportare i dati dal magazzino. Accedi al tuo magazzino ed esporta i dati che desideri importare in Klaviyo in un file CSV.
Formatta i dati esportati in base al formato CSV e alle limitazioni di dimensione.
Genera chiavi SSH sul tuo computer locale
Una volta esportati i dati desiderati dal tuo magazzino, genera una nuova chiave SSH sul tuo computer locale e aggiungila a Klaviyo selezionando il pulsante Aggiungi chiave SSH.
Quando aggiungi la chiave, assicurati che inizi con una delle seguenti opzioni:
- Ssh-ras
- Ecdsa-sha2
- Ssh-ed
- Sk-ecdsa
- sk-ssh
Configura il client SFTP e importa
Una volta che la chiave SSH è stata aggiunta con successo a Klaviyo, dovrai configurare il tuo client SFTP e importare i dati.
- Apri il client SFTP e configura una nuova connessione con le credenziali presentate in Klaviyo. Vedrai le credenziali presentate dopo aver aggiunto con successo la chiave SSH.
- Una volta eseguita l'autenticazione, assicurati che il tuo database segua le linee guida consigliate prima dell'importazione.
- Carica il file del database tramite il tuo client SFTP e rivedilo.
Vedrai anche un elenco delle tue recenti importazioni con le seguenti informazioni:
-
Stato
Completato o incompleto. -
Righe elaborate
Percentuale di righe totali elaborate finora. -
Data dell'importazione
Data di importazione. -
Importato da
Utente che ha importato i dati.
Esporta i dati nel tuo magazzino
Per configurare il tuo magazzino dati come destinazione, avrai bisogno delle seguenti informazioni e credenziali per ogni magazzino dati.
Amazon Redshift
Per configurare Amazon Redshift come destinazione, esegua il seguente script per creare le tabelle klaviyo_event e klaviyo_profile.
Una volta configurato come destinazione, colleghi il suo magazzino con Klaviyo utilizzando le seguenti credenziali:
- Nome: Il nome del suo database in Redshift (si consiglia di utilizzare lo stesso nome del database in Redshift).
- URL host: L'endpoint del server Amazon Redshift (chiamato URL di connessione in Redshift).
- Database: Il nome per identificare la sua fonte di dati
- Porta: il numero di porta utilizzato da Redshift.
- Schema: Lo schema del suo database
- Nome utente: il nome utente utilizzato per accedere a Redshift.
-
Password del database: la password utilizzata per accedere a Redshift.
Amazon S3
Per configurare Amazon S3 come destinazione, imposti i nomi delle tabelle su klaviyo_profile e klaviyo_event.
Una volta configurato come destinazione, colleghi il suo magazzino con Klaviyo utilizzando le seguenti credenziali:
- Nome: Il nome leggibile dalla macchina per il database Amazon S3.
- Bucket: Il nome del suo bucket.
- Posizione del bucket: Il nome della regione scelto al momento della creazione del bucket di archiviazione.
- ID chiave di accesso: il suo ID chiave di accesso AWS.
-
Chiave di accesso segreta: la sua chiave di accesso segreta AWS.
Google BigQuery
Per configurare Google BigQuery come destinazione, esegua il seguente script per impostare le tabelle klaviyo_profile e klaviyo_event . Il suo account Google BigQuery deve avere un profilo di pagamento affinché il processo di connessione abbia successo.
Si noti che in questo script deve sostituire il segnaposto "SERVICE ACCOUNT EMAIL" con l'e-mail del suo account di servizio BigQuery.
Una volta configurato come destinazione, colleghi il suo magazzino con Klaviyo utilizzando le seguenti credenziali:
- Nome: Un nome che la aiuti a identificare questa destinazione
- ID progetto: Questo è noto come ID del progetto e si trova nella sua console API.
- Set di dati: Conosciuto anche come schema. Questo è lo stesso nome che ha utilizzato nello script che avrebbe dovuto eseguire per la configurazione.
-
Chiave dell'account di servizio: Incolli l'intero contenuto del file JSON che ha scaricato quando ha creato il suo account di servizio in BigQuery.
Microsoft Azure Synapse Analytics
Per configurare Microsoft Azure come destinazione, esegua il seguente script per creare le tabelle klaviyo_profile e klaviyo_event .
- Nome: Si consiglia di utilizzare lo stesso nome del database in Azure.
- Spazio di lavoro: Il nome dell'area di lavoro Azure Synapse.
- Nome del database: identifica il suo database Dedicated SQL Pool.
- Nome utente: il suo nome utente di login per il suo database Dedicated SQL Pool.
- Password del database:la sua password di accesso al database di Dedicated SQL Pool.
- Nome dell'account: il suo account di archiviazione Windows Azure, o il prefisso DNS che ha creato.
- Firma di accesso: La sua stringa di firma di accesso condivisa (SAS) che prova l'accesso al contenitore Blob Storage.
-
Nome del contenitore: il nome del contenitore Azure Blob per l'area di staging temporanea per il trasferimento dei dati.
Snowflake
Per configurare Snowflake come destinazione, procedi come segue:
1. Genera una chiave privata eseguendo il seguente comando nel tuo terminale:
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt
2. Genera una chiave pubblica che faccia riferimento alla chiave privata eseguendo il seguente comando nel tuo terminale:
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
3. Esegui il seguente script per impostare le tabelle profilo, KLAVIYO_EVENT e metrica. Devi avere i privilegi di securityadmin e sysadmin per poter completare la configurazione che segue. Per verificare quali ruoli hai, esegui SHOW GRANTS TO USER <your_username> e assicurati di avere entrambi i ruoli elencati. Se hai bisogno di modificare il tuo ruolo, rivolgiti a un amministratore di sistema.
Una volta configurato come destinazione, colleghi il suo magazzino con Klaviyo utilizzando le seguenti credenziali:
- Nome: Si raccomanda di utilizzare lo stesso nome del suo database in Snowflake.
-
Nome utente: nome utente per connettersi al database. Questo dovrebbe essere lo stesso nome_utente nello script di configurazione.
-
Chiave privata: La chiave privata Snowflake generata.
- Magazzino: Il suo magazzino a Snowflake.
- Account: Il suo account in Snowflake.
- Database: Il nome del tuo database. Questo dovrebbe essere lo stesso nome del database nello script di configurazione.
-
Schema: Lo schema del tuo database. Questo dovrebbe essere lo stesso nome dello schema nello script di configurazione.
Dopo aver inserito le credenziali per il data warehouse con cui sta effettuando la sincronizzazione, scelga i dati che desidera sincronizzare da Klaviyo.
Oggetti datiOggetti dati
Nella sezione Oggetti dati può scegliere di sincronizzare tutti i dati del profilo, solo i dati di eventi specifici o entrambi i tipi di dati, selezionando la/e casella/e applicabile/i accanto a ciascuna opzione.
Klaviyo utilizza una struttura JSON annidata quando invia i dati al suo data warehouse. I profili e gli eventi vengono inviati come una singola tabella, consentendo di eseguire query su 1 tabella anziché su un gran numero di nomi di tabelle potenziali nel suo data warehouse.
La sincronizzazione di tutti i dati da Klaviyo può comportare costi aggiuntivi da parte del suo data warehouse.
Integrazioni da escludere
Nel campo Integrazioni da escludere, può selezionare l'integrazione o le integrazioni specifiche che desidera escludere nella sincronizzazione del data warehouse. Questo è utile se desidera rimuovere dalla sincronizzazione anche i dati di una specifica integrazione che potrebbe aver già collegato a Klaviyo.
L'esclusione dei dati di integrazione specifici riguarda solo i dati degli eventi e non esclude i dati del profilo.
Sincronizzazione selettiva
Nel campo Sincronizzazione selettiva , seleziona gli eventi specifici che desidera sincronizzare con il suo data warehouse da Klaviyo. Per impostazione predefinita, vengono inclusi tutti gli eventi. Quando imposta eventi specifici da sincronizzare con questo campo, solo gli eventi selezionati verranno sincronizzati.
Questo campo appare solo se seleziona l'oggetto dati Eventi .
Selezioni la frequenza di sincronizzazione dei suoi dati
Il valore impostato per il campo Cadenza di sincronizzazione periodica nella sezione denominata Seleziona la frequenza di sincronizzazione dei dati definisce la frequenza di sincronizzazione da Klaviyo al suo data warehouse.
La cadenza di sincronizzazione periodica è impostata di default su base oraria e non può essere modificata.
Selezioni la quantità di dati storici che desidera sincronizzare.
Nella sezione Selezionare la quantità di dati storici da sincronizzare , può definire la quantità di dati storici che desidera sincronizzare da Klaviyo al suo data warehouse durante la connessione iniziale. Può scegliere:
- 30 giorni
- 90 giorni
- 1 anno
- Per tutto il tempo
Può incorrere in costi aggiuntivi da parte del suo data warehouse se sincronizza una grande quantità di dati in una sola volta.
Recensione di Sync
Una volta collegata la sua integrazione, se la configurazione è andata a buon fine, vedrà una schermata finale che indica che la connessione è Abilitata, insieme a:
- Dettagli della sincronizzazione impostata.
- Quali dati vengono condivisi (profili, eventi o entrambi).
- Tutte le integrazioni escluse.
Se la sua sincronizzazione non è stata effettuata con successo, verrà visualizzato lo stato Impossibile connettersi, insieme alle opzioni per ritentare la connessione o per modificare le informazioni nelle sue credenziali.
Dopo aver collegato con successo il suo data warehouse, verrà riportato alla pagina principale dell'elenco di sincronizzazione dei dati. Qui potrà vedere il suo:
- Destinazione magazzino
- Lo stato Abilitato
- Qualsiasi errore potenziale che potrebbe essersi verificato con la sua sincronizzazione nelle ultime 24 ore.
- L'ultima sincronizzazione che si è verificata insieme a un timestamp di questo evento.
Poiché sarà in grado di collegare una sola destinazione, vedrà solo una destinazione riflessa in questa vista elenco.
Cruscotto di sincronizzazione dei datiCruscotto di sincronizzazione dei dati
Una volta che la connessione è andata a buon fine, clicchi sulla sua integrazione dalla pagina Elenco di sincronizzazione dei dati. Da qui verrà portato al cruscotto di sincronizzazione dei dati che fornisce informazioni storiche e attuali sulle sincronizzazioni dei dati eseguite.
Qui vedrà le informazioni sulla sincronizzazione suddivise in 2 schede:
- Storico
- Periodico
Storico
La scheda Storico contiene i registri che mostrano lo stato delle sincronizzazioni dei dati storici. Le sincronizzazioni storiche si riferiscono alla sincronizzazione dei suoi dati esistenti da Klaviyo al suo data warehouse quando stabilisce una connessione.
Vedrà le seguenti informazioni per ogni sincronizzazione:
-
Nome
I dati vengono inclusi nella sincronizzazione. -
Stato
Stato e potenziale progresso della sincronizzazione con una percentuale stimata o errori potenziali annotati. Questi stati possono includere:
-
Completato
I suoi dati hanno terminato la sincronizzazione per questa sincronizzazione unica. Non si risincronizzerà automaticamente. -
Programmato
Quando è prevista l'esecuzione automatica della prossima sincronizzazione. -
In corso
I dati vengono sincronizzati attivamente al suo data warehouse con una percentuale stimata di completamento. -
Errore
Si è verificato un errore, ma Klaviyo continuerà a cercare di ristabilire la connessione. A seconda dell'integrazione, questa tempistica può variare leggermente. -
Failed
La sincronizzazione è completamente fallita anche dopo aver tentato di ristabilire una connessione. Ciò significa che dovrà rivedere le impostazioni di configurazione o anche l'impostazione del data warehouse. -
Pausa
Lei ha messo in pausa la sincronizzazione manualmente. -
Disabilitato
La sincronizzazione è stata disabilitata perché l'integrazione stessa è stata disabilitata o rimossa.
-
Completato
-
Avviato il
Ora di inizio della sincronizzazione. -
Terminato su
Ora di fine della sincronizzazione.
Periodico
La scheda Periodico contiene dei registri che mostrano lo stato delle sue sincronizzazioni periodiche. Man mano che i clienti continuano a interagire con il suo marchio e vengono creati nuovi dati, questi verranno inviati di routine al suo data warehouse. Quando si imposta una connessione al data warehouse, le sincronizzazioni periodiche avverranno ogni ora.
Vedrà le seguenti informazioni per ogni sincronizzazione:
-
Nome
I dati vengono inclusi nella sincronizzazione. -
Stato
Stato e potenziale progresso della sincronizzazione con una percentuale stimata o errori potenziali annotati. Questi stati possono includere:
-
Completato
I suoi dati hanno terminato la sincronizzazione per questa sincronizzazione unica. Non si risincronizzerà automaticamente. -
Programmato
Quando è prevista l'esecuzione automatica della prossima sincronizzazione. -
In corso
I dati vengono sincronizzati attivamente al suo data warehouse con una percentuale stimata di completamento. -
Errore
Si è verificato un errore, ma Klaviyo continuerà a cercare di ristabilire la connessione. A seconda dell'integrazione, questa tempistica può variare leggermente. -
Failed
La sincronizzazione è completamente fallita anche dopo aver tentato di ristabilire una connessione. Ciò significa che dovrà rivedere le impostazioni di configurazione o anche l'impostazione del data warehouse. -
Pausa
Lei ha messo in pausa la sincronizzazione manualmente. -
Disabilitato
La sincronizzazione è stata disabilitata perché l'integrazione stessa è stata disabilitata o rimossa.
-
Completato
-
Freschezza dei dati
La freschezza dei dati si riferisce a quanto sono aggiornati i suoi dati. Ad esempio, se una sincronizzazione ha una freschezza di 2 minuti, significa che qualsiasi nuovo dato creato in Klaviyo negli ultimi 2 minuti non è ancora presente nel suo data warehouse. - Pulsanti per mettere in pausa, riprendere e riattivare le singole sincronizzazioni.
Rimozione delle connessioni al data warehouse
Per eliminare una connessione al data warehouse dal suo account Klaviyo, si rechi alla pagina Integrazioni in Klaviyo dal menu dell'account nell'angolo in basso a sinistra.
Nella pagina Integrazioni, apra il menu accanto all'integrazione del data warehouse e selezioni Rimuovi integrazione per rimuovere la connessione.
Visualizza i registri degli errori
Se si verificano problemi con la sincronizzazione dei dati tra Klaviyo e il suo data warehouse, la visualizzazione dei log di errore associati può fornire ulteriori informazioni sulla causa del problema.
Per visualizzare gli errori, faccia clic sulla destinazione del magazzino nella pagina di sincronizzazione. Sia nella scheda Storico che in quella Sincronizzazione periodica vedrà un elenco delle esportazioni e il loro stato, oltre a un indicatore che mostra se ci sono errori attivi.
Per visualizzare maggiori dettagli su un particolare errore, faccia clic sull'esportazione che presenta il guasto.
Qui vedrà una timeline delle sincronizzazioni in uscita, insieme a un messaggio di errore o di successo in base allo stato della sincronizzazione.
Facendo clic su un errore specifico, si aprirà un cassetto con le seguenti informazioni:
-
Riepilogo
Una breve descrizione dell'errore restituito dal data warehouse. -
Codice
Il codice dell'errore per l'errore. -
Messaggio esterno
Il messaggio di errore effettivo restituito dal data warehouse. -
Data
La data e l'ora dell'errore.
Risorse aggiuntive
Capire come vengono scambiate le informazioni tra Klaviyo e le app
Comprendere i tipi di informazioni scambiate tra Klaviyo e le applicazioni