Come funziona la sincronizzazione del magazzino dati in Klaviyo

Cosa 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 il profilo cliente e i dati degli eventi, consentendoti di archiviare e analizzare informazioni chiave sui tuoi clienti al di fuori di Klaviyo.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Prima di iniziare

Prima di esportare i dati da Klaviyo, configura il tuo magazzino dati come destinazione:

• Assicurati che l’utente fornito a Klaviyo disponga delle autorizzazioni corrette.
• Per le destinazioni che usano tabelle, crea le tabelle con i nomi indicati nelle istruzioni di configurazione riportate di seguito.

Inoltre, assicurati di inserire nella lista consentita gli indirizzi IP del traffico in uscita del magazzino dati di Klaviyo. In questo modo, le richieste di Klaviyo non verranno bloccate dal tuo livello di sicurezza. Questi indirizzi sono rappresentati dai seguenti intervalli CIDR:

• 184.72.183.187/32
• 52.206.71.52/32
• 3.227.146.32/32
• 44.198.39.11/32
• 35.172.58.121/32
• 3.228.37.244/32
• 54.88.219.8/32
• 3.214.211.176/32

Collegati a un magazzino dati

1. Vai a Gestione dati > Sincronizzazione. Se hai già una connessione, fai clic su Crea sincronizzazione.
2. Seleziona Esporta i dati nel tuo magazzino dati.
3. Seleziona il tuo magazzino, quindi fai clic su Connetti a [warehouse name] nella relativa pagina di configurazione.

In alternativa, puoi selezionare il tuo magazzino dati dal marketplace di app di Klaviyo andando su Integrazioni > Esplora app e cercando la tua piattaforma.

L’opzione Importa dati dal tuo magazzino dati configura un’importazione diretta dal magazzino dati. Per caricare i file CSV tramite SFTP, segui la sezione successiva.

Importa i dati via SFTP

Se desideri importare i dati dal magazzino dati in Klaviyo, puoi farlo tramite SFTP. Per una connessione diretta al magazzino dati, consulta Capire l’importazione del magazzino dati in Klaviyo.

Vai a Integrazioni, apri Gestisci dati > Trasferimento dati SFTP, quindi seleziona la scheda Configurazione SFTP.

La procedura per importare i dati del magazzino in Klaviyo è la seguente:

1. Esporta i dati desiderati dal tuo magazzino dati.
2. Genera chiavi SSH sul tuo computer locale.
3. Configura il client SFTP e importa.

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.

Genera chiavi SSH sul tuo computer locale

Genera una nuova coppia di chiavi SSH sul tuo computer locale. Conserva la chiave privata per il tuo client SFTP.

1. In Configurazione SFTP, fai clic su Aggiungi chiave SSH. Inserisci un Titolo chiave e incolla la tua chiave pubblica in chiave SSH.
2. Fai clic su Aggiungi chiave.

Configura il client SFTP e importa

Dopo aver aggiunto la tua chiave pubblica a Klaviyo, configura il tuo client SFTP e carica il tuo file CSV.

1. Crea una connessione nel tuo client SFTP utilizzando il server, la porta e il nome utente mostrati in Credenziali SFTP in Configurazione SFTP. Autenticati con la chiave privata corrispondente.
2. Prima di caricare il file, assicurati che il tuo file CSV segua le linee guida di formattazione consigliate indicate nel link sopra.
3. Carica il file CSV tramite il tuo client SFTP.

Per verificare l’importazione, apri la scheda Importazione dati in Trasferimento dati SFTP. Importazioni recenti mostra:

• Stato
  In coda, In elaborazione, Completata, Non riuscita o Annullata. Un’importazione completata può comunque contenere errori.
• Righe elaborate
  Percentuale del file elaborata finora. Espandi un’importazione per controllare il conteggio delle righe elaborate e ignorate.
• 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, esegui lo script seguente per creare le tabelle klaviyo_event, klaviyo_profile e klaviyo_metric.

Fai adattare questo esempio dall’amministratore del database prima di eseguirlo: sostituisci i segnaposto, correggi il */ non abbinato vicino all’inizio ed esegui le istruzioni GRANT specifiche per le tabelle dopo aver creato le tabelle.

Una volta configurato come destinazione, collega il tuo data warehouse a Klaviyo utilizzando il seguente set di credenziali:

• Nome: Un nome per identificare questa connessione. Puoi usare lo stesso nome del database in Redshift.
• URL host: l'endpoint del server Amazon Redshift (detto URL di connessione in Redshift)
• Database: il nome del database Redshift a cui Klaviyo si collegherà
• Porta: il numero di porta utilizzato da Redshift
• Schema: lo schema del tuo 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, tieni pronti il nome del bucket, la regione del bucket e le credenziali di accesso AWS.

Una volta configurato come destinazione, collega il tuo data warehouse a Klaviyo utilizzando il seguente set di credenziali:

• Nome: un nome per identificare questa connessione.
• Contenitore: il nome del tuo contenitore.
• Posizione del bucket: il nome della regione scelto al momento della creazione del bucket di archiviazione.
• ID della chiave di accesso: Il tuo ID della chiave di accesso AWS.
• Chiave di accesso segreta: La tua chiave di accesso segreta AWS.
  

Google BigQuery

Per configurare Google BigQuery come destinazione, esegui lo script seguente per impostare le tabelle klaviyo_profile, klaviyo_event e klaviyo_metric. Per completare correttamente la procedura di connessione, il tuo account Google BigQuery deve avere un profilo di pagamento.

Tieni presente che in questo script devi sostituire il segnaposto "SERVICE ACCOUNT EMAIL" con l'e-mail dell'account di servizio BigQuery.

Una volta configurato come destinazione, collega il tuo data warehouse a Klaviyo utilizzando il seguente set di credenziali:

• Nome: Un nome che ti aiuti a identificare questa destinazione
• ID progetto: Puoi trovare l’ID del progetto nella tua console API.
• Set di dati: conosciuto anche come schema. Questo è lo stesso nome utilizzato nello script che avrebbe dovuto essere eseguito per la configurazione.
• Chiave dell'account di servizio: Incolla l'intero contenuto del file JSON che hai scaricato quando hai creato il tuo account di servizio in BigQuery.
  

Microsoft Azure Synapse Analytics

Per configurare Microsoft Azure come destinazione, esegui il seguente script per creare le tabelle klaviyo_profile, klaviyo_event e klaviyo_metric. Fai adattare l’esempio dal tuo amministratore di database prima di eseguirlo: inizia con istruzioni DROP TABLE, inclusa un’istruzione DROP TABLE klaviyo_profile duplicata. Rimuovi le istruzioni DROP TABLE quando crei nuove tabelle o se devi preservare i dati esistenti.

Una volta configurato come destinazione, collega il tuo data warehouse a Klaviyo utilizzando il seguente set di credenziali:

• Nome: È consigliabile usare lo stesso nome del database in Azure.
• Workspace: il nome dello spazio di lavoro Azure Synapse.
• Nome database: Identifica il tuo database Dedicated SQL Pool.
• Nome utente: Il tuo nome utente di accesso per il database del tuo Dedicated SQL Pool.
• Password del database: la password di accesso per il database del pool SQL dedicato.
• Nome account: il tuo account di archiviazione Windows Azure o il prefisso DNS che hai creato.
• Firma di accesso: La stringa della firma di accesso condiviso (SAS) che dimostra l'accesso al contenitore di Archiviazione Blob.
• Nome contenitore: Il nome del contenitore Azure Blob per l'area di staging temporanea per il trasferimento dei dati.
  

Snowflake

Per configurare Snowflake come destinazione, segui questi passaggi:

1. Genera una chiave privata eseguendo il seguente comando nel tuo terminale:

textCopy

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 terminale:

textCopy

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

3. Esegui lo script seguente per configurare le tabelle KLAVIYO_PROFILE, KLAVIYO_EVENT e KLAVIYO_METRIC. Devi avere i privilegi securityadmin e sysadmin per completare la configurazione seguente. Per verificare quali ruoli hai, esegui SHOW GRANTS TO USER <your_username> e assicurati che entrambi i ruoli siano elencati. Contatta un amministratore di sistema se devi modificare il tuo ruolo. Prima di eseguire lo script, sostituisci i segnaposto SET_ con i tuoi valori e GENERATE_PUBLIC_KEY con la chiave pubblica che hai generato. Lo script utilizza CREATE OR REPLACE TABLE, che sostituisce eventuali tabelle esistenti con quei nomi. Usa un nuovo database oppure chiedi al tuo amministratore di adattare queste istruzioni se devi conservare i dati esistenti.

Una volta configurato come destinazione, collega il tuo data warehouse a Klaviyo utilizzando il seguente set di credenziali:

• Nome: Ti consigliamo di utilizzare lo stesso nome del database in Snowflake.
• Nome utente: Nome utente per connetterti al tuo database. Dovrebbe corrispondere a user_name nello script di configurazione.
  
• Chiave privata: La chiave privata Snowflake generata.
  
• Magazzino:  Il tuo magazzino in Snowflake.
• Account: Il tuo account in Snowflake.
• Database: Il nome del tuo database. Dovrebbe essere lo stesso di database_name nello script di configurazione.
• Schema: Lo schema del tuo database. Dovrebbe essere lo stesso di schema_name nello script di configurazione.
  

Databricks

Per configurare Databricks come destinazione, incluso lo script di configurazione, le autorizzazioni richieste e le credenziali di connessione, segui i passaggi in Come esportare i dati di Klaviyo in Databricks.

Se il modulo di connessione mostra una sezione Blob store, usala per configurare l’archiviazione per l’esportazione. Per le destinazioni di warehouse, questa archiviazione prepara i dati prima di caricarli nel warehouse. Per Amazon S3, è la destinazione dell’esportazione.

1. Per usare uno store salvato, seleziona Usa una configurazione blob se visualizzato, quindi scegli uno Store blob compatibile. Se lasci Usa una configurazione blob non selezionato, continua con i dettagli di connessione elencati sopra. Se Klaviyo richiede uno store blob, selezionane uno prima di continuare.
2. Per aggiungere un archivio, scegli Crea nel menu a discesa Archivio BLOB. Se richiesto, seleziona un Provider, inserisci i suoi dettagli di connessione, quindi fai clic su Crea.
3. Se viene visualizzato un campo Nome configurazione di archiviazione, inserisci il nome della configurazione di archiviazione che hai creato nel tuo data warehouse.
4. Per una destinazione Amazon S3, scegli un Formato file e se Comprimere i file esportati se questi controlli sono disponibili.

Dopo aver inserito i dettagli di connessione, fai clic su Avanti. Quindi scegli i dati e la pianificazione per l’esportazione.

Oggetti dei dati

Nella sezione Oggetti dati puoi scegliere di sincronizzare tutti i dati del profilo, solo dati di eventi specifici o entrambi i tipi di dati selezionando la/le casella/e applicabile/i accanto a ciascuna opzione.

Integrazioni da escludere

Nel campo Integrazioni da escludere, puoi selezionare le integrazioni specifiche che vuoi escludere dalla sincronizzazione del magazzino dati. Questo è utile se vuoi impedire anche la sincronizzazione di dati di un'integrazione specifica che potresti aver già collegato a Klaviyo.

Sincronizzazione selettiva

Nel campo Sincronizzazione selettiva , selezioni gli eventi specifici che desideri sincronizzare nel tuo magazzino dati da Klaviyo. Per impostazione predefinita, tutti gli eventi sono inclusi. Quando imposti eventi specifici da sincronizzare con questo campo, verranno sincronizzati solo gli eventi selezionati.

Seleziona la frequenza di sincronizzazione dei dati

In Seleziona la frequenza di sincronizzazione dei dati, scegli un intervallo in Ogni: 1, 2, 4, 6, 12 o 24 ore. Imposta Data di inizio, Ora di inizio e Fuso orario per la pianificazione.

Seleziona la quantità di dati storici che desideri sincronizzare

Nella sezione Seleziona la quantità di storico dei dati da sincronizzare , puoi definire quanto storico dei dati vuoi sincronizzare da Klaviyo al tuo magazzino dati durante la connessione iniziale. Puoi scegliere:

• 30 giorni
• 90 giorni
• 1 anno
• Per tutto il tempo

Sincronizza recensione

Fai clic su Avanti per aprire Revisione. Controlla i dettagli della connessione e le impostazioni di esportazione, tra cui:

• Dettagli della sincronizzazione che hai configurato
• Quali dati vengono condivisi (profili, eventi o entrambi)
• Eventuali integrazioni escluse

Fai clic su Connetti per salvare la connessione e avviare le sincronizzazioni in base alla pianificazione impostata.

Se Klaviyo mostra Impossibile connettersi, fai clic su Modifica credenziali per correggere i dettagli della connessione, poi torna a Verifica e fai clic di nuovo su Connetti.

Dopo aver salvato la connessione, Klaviyo ti riporta a Sincronizzazione dei dati. La tabella delle connessioni mostra:

• Magazzino
• Tipo: importa o esporta
• Creato il

Le destinazioni di esportazione e le connessioni di importazione diretta vengono visualizzate nella stessa tabella. Controlla Tipo per distinguerle.

Pannello di controllo della sincronizzazione dei dati

Una volta stabilita correttamente la connessione, fai clic sulla tua integrazioni dalla pagina dell’elenco Sincronizzazione dei dati. Da qui passerai al pannello di controllo della sincronizzazione dei dati, che fornisce informazioni storiche e correnti sulle sincronizzazioni dei dati eseguite.

Qui vedrai le informazioni di sincronizzazione suddivise in 2 schede:

• Storico
• Periodico

Storico

La scheda Historical contiene i log che mostrano lo stato delle sincronizzazioni del tuo storico dei dati. Le sincronizzazioni storiche si riferiscono alla sincronizzazione dei dati esistenti da Klaviyo al tuo magazzino dati quando stabilisci una connessione.

Per ogni sincronizzazione vedrai le seguenti informazioni:

• Nome
  I dati inclusi nella sincronizzazione.
• Stato
  Lo stato e il potenziale avanzamento della sincronizzazione, con una percentuale stimata o eventuali errori indicati. Questi stati possono includere:
  
  
  • Completato
    La sincronizzazione dei dati per questa sincronizzazione una tantum è terminata. Non verrà sincronizzato di nuovo automaticamente.
  • Programmato
    Quando è programmata l'esecuzione automatica della prossima sincronizzazione.
  • Sincronizzazione
    I dati si stanno sincronizzando attivamente con il tuo magazzino dati con una percentuale di completamento stimata.
  • Errore
    Si è verificato un errore, ma Klaviyo continuerà a tentare di ristabilire una connessione. A seconda dell’integrazione, questa tempistica potrebbe variare leggermente.
  • Non riuscito
    La sincronizzazione non è andata a buon fine neanche dopo aver provato a ristabilire una connessione. Ciò significa che dovrai rivedere le impostazioni di configurazione o persino la configurazione del magazzino dati. Dopo aver risolto il problema, fai clic su Riabilita per la sincronizzazione.
  • In pausa
    Hai messo manualmente in pausa la sincronizzazione.
  • Annullata
    La sincronizzazione è stata annullata e non è più pianificata.
• Avviato il
  Ora di inizio della sincronizzazione.
• Terminato il
  Ora di fine della sincronizzazione.

Periodico

La scheda Periodico mostra lo stato delle sincronizzazioni in corso. Man mano che i clienti continuano a interagire con il tuo brand e vengono creati nuovi dati, questi vengono inviati al tuo magazzino dati secondo la pianificazione che hai selezionato. Al termine di ogni esecuzione, Klaviyo pianifica l’esecuzione successiva.

Per ogni sincronizzazione vedrai le seguenti informazioni:

• Nome
  I dati inclusi nella sincronizzazione.
• Stato
  Lo stato attuale della sincronizzazione ed eventuali errori. Questi stati potrebbero includere:
  • Pianificata
    La sincronizzazione è in attesa della prossima esecuzione pianificata.
  • Sincronizzazione
    I dati si stanno sincronizzando attivamente nel tuo magazzino dati.
  • Errore
    Si è verificato un errore, ma Klaviyo continuerà a tentare di ristabilire una connessione. A seconda dell’integrazione, questa tempistica potrebbe variare leggermente.
  • Non riuscito
    La sincronizzazione non è riuscita completamente anche dopo aver provato a ristabilire una connessione. Ciò significa che dovrai rivedere le impostazioni di configurazione o persino la configurazione del magazzino dati. Dopo aver risolto il problema, fai clic su Riattiva per la sincronizzazione.
  • In pausa
    Hai messo in pausa la sincronizzazione manualmente.
  • Annullata
    La sincronizzazione è stata annullata e non è più pianificata.
• Aggiornamento dei dati
  L’aggiornamento dei dati indica quanto sono aggiornati i tuoi dati. Ad esempio, un aggiornamento di 2 minuti indica che la sincronizzazione ha elaborato i dati fino a circa 2 minuti fa. I dati più recenti potrebbero essere ancora in attesa di sincronizzazione.
• Pulsanti per mettere in pausa, riprendere e riattivare le singole sincronizzazioni.

Rimozione delle connessioni al magazzino dati

1. Vai su Integrazioni.
2. Apri il menu accanto all’integrazione del magazzino dati e seleziona Rimuovi integrazione. Nella finestra di dialogo di conferma, fai clic su Rimuovi integrazione di nuovo.

Visualizza i registri degli errori

Se riscontri problemi con la sincronizzazione dei dati tra Klaviyo e il tuo magazzino dati, la visualizzazione dei log degli errori associati può fornire ulteriori informazioni sulla causa del problema.

Per visualizzare gli errori, fai clic sulla destinazione del tuo magazzino nella pagina Sincronizzazione. In entrambe le schede di sincronizzazione Storica e Periodica vedrai un elenco delle esportazioni e il relativo stato, insieme a un indicatore che mostra se ci sono errori attivi.

Per visualizzare maggiori dettagli su un errore specifico, fai clic sull’esportazione in cui si sta verificando il problema.

Qui vedrai una cronologia delle sincronizzazioni in uscita, insieme a un messaggio di errore o di esito positivo in base allo stato della sincronizzazione.

Facendo clic su un errore specifico si aprirà un pannello con le seguenti informazioni:

• Descrizione
  Una breve descrizione dell’errore restituito dal magazzino dati
• Codice
  Il codice di errore per l'errore
• Messaggio esterno
  L'effettivo messaggio di errore restituito dal magazzino dati
• Data
  La data e l'ora dell'errore

Risorse aggiuntive