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

Dovrai assicurarti che il magazzino dati a cui ti stai collegando sia configurato come destinazione. Per assicurarti di averlo configurato correttamente:

• Assicurati che l’utente fornito a Klaviyo disponga delle autorizzazioni corrette.
• Assicurati di impostare le tabelle con i nomi appropriati, mostrati di seguito, in base al tuo magazzino dati.

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

Per aggiungere una connessione al magazzino dati a Klaviyo, vai su Advanced Klaviyo Data Platform > Gestione dei dati > Sincronizzazione.

Per aggiungere un magazzino dati, seleziona un magazzino dati supportato nella modale Seleziona un connettore.

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

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.

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

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.

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.

1. 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
2. Una volta eseguita l'autenticazione, assicurati che il tuo database segua le linee guida consigliate prima dell'importazione
3. 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 del totale delle righe 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, esegui lo script seguente per creare le tabelle klaviyo_event e klaviyo_profile.

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

• Nome: il nome del database in Redshift (si consiglia di utilizzare lo stesso nome del database in Redshift)
• URL host: l'endpoint del server Amazon Redshift (detto URL di connessione in Redshift)
• Database: Il nome per identificare la tua origine dei dati
• 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, imposta i nomi delle tabelle su klaviyo_profile e klaviyo_event.

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

• Nome: il nome leggibile dalla macchina per il database Amazon S3.
• 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 e klaviyo_event . Il tuo account Google BigQuery deve avere un profilo di pagamento affinché la procedura di connessione vada a buon fine.

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 e klaviyo_event .

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 tua password di accesso per il database Dedicated SQL Pool.
• 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:

text Copy

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:

text Copy

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

3. Esegui lo script seguente per impostare le tabelle KLAVIYO_PROFILE, KLAVIYO_EVENT e KLAVIYO_METRIC. Per completare la configurazione di seguito, devi avere i privilegi securityadmin e sysadmin. Per verificare quali ruoli hai, esegui SHOW GRANTS TO USER <your_username> e assicurati che siano elencati entrambi i ruoli. Contatta un amministratore di sistema se devi modificare il tuo ruolo.

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.
  

Dopo aver inserito le credenziali per il magazzino dati con cui stai eseguendo la sincronizzazione, scegli i dati che vuoi sincronizzare da Klaviyo.

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

Il valore impostato per il campo Cadenza di sincronizzazione periodica nella sezione denominata Seleziona con quale frequenza verranno sincronizzati i tuoi dati definisce con quale frequenza avverrà una sincronizzazione da Klaviyo al tuo magazzino dati.

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

Dopo aver connesso la tua integrazione, se la configurazione è andata a buon fine, vedrai una schermata finale che indica che la connessione è Enabled, insieme a:

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

Se la sincronizzazione non è stata connessa correttamente, visualizzerai invece lo stato Impossibile connettersi, insieme alle opzioni per riprovare la connessione o modificare le informazioni nelle credenziali.

Dopo aver collegato correttamente il tuo magazzino dati, verrai reindirizzato alla pagina principale dell’elenco Sincronizzazione dei dati. Qui vedrai:

• Destinazionedel warehouse
• Lo stato Attivato
• Eventuali errori che potrebbero essersi verificati con la sincronizzazione nelle ultime 24 ore
• L’ultima sincronizzazione eseguita, con data e ora di questo evento

Poiché potrai connettere sempre e solo 1 destinazione, in questa vista elenco vedrai riflessa solo 1 destinazione.

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 vengono 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.
  • In progress
    I dati vengono sincronizzati attivamente nel 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 è riuscita completamente anche dopo aver provato a ristabilire una connessione. Questo significa che dovrai verificare le impostazioni di configurazione o anche la configurazione del magazzino dati.
  • In pausa
    Hai messo manualmente in pausa la sincronizzazione.
  • Disattivata
    La sincronizzazione è stata disattivata perché l’integrazione stessa è stata disattivata o rimossa.
• Avviato il
  Ora di inizio della sincronizzazione.
• Terminato il
  Ora di fine della sincronizzazione.

Periodico

La scheda Periodico contiene registri che mostrano lo stato delle sincronizzazioni periodiche. Man mano che i clienti continuano a interagire con il tuo brand e vengono creati nuovi dati, questi verranno inviati regolarmente al tuo magazzino dati. Quando configuri una connessione al magazzino dati, le sincronizzazioni periodiche avverranno ogni ora.

Per ogni sincronizzazione vedrai le seguenti informazioni:

• Nome
  I dati vengono 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.
  • In progress
    I dati vengono sincronizzati attivamente nel 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 è riuscita completamente anche dopo aver provato a ristabilire una connessione. Questo significa che dovrai rivedere le impostazioni di configurazione o persino la configurazione del magazzino dati.
  • In pausa
    Hai messo in pausa la sincronizzazione manualmente.
  • Disattivata
    La sincronizzazione è stata disattivata perché l’integrazione stessa è stata disattivata o rimossa.
• Aggiornamento dei dati
  L'aggiornamento dei dati si riferisce a quanto sono aggiornati i tuoi dati. Ad esempio, se una sincronizzazione ha un aggiornamento dei dati di 2 minuti, significa che tutti i nuovi dati creati in Klaviyo negli ultimi 2 minuti non sono ancora presenti nel tuo magazzino dati.
• Pulsanti per mettere in pausa, riprendere e riattivare le singole sincronizzazioni.

Rimozione delle connessioni al magazzino dati

Per eliminare una connessione al magazzino dati dal tuo account Klaviyo, seleziona la scheda Integrazioni.

Apri il menu accanto all'integrazione del tuo magazzino dati e seleziona Rimuovi integrazione per rimuovere la connessione.

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:

• Riepilogo
  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