Capire la sincronizzazione del data warehouse in Klaviyo

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. 

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/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

Collegarsi a un data warehouse 

Per aggiungere una connessione al data warehouse in Klaviyo, si rechi in Gestione dati > Sincronizzazione.

1. Per aggiungere un data warehouse, clicchi sul pulsante Nuova connessione . 
2. Nella maschera Seleziona una destinazione , selezioni un data warehouse supportato da collegare a Klaviyo.

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:

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

Dopo aver inserito le credenziali per il data warehouse con cui sta effettuando la sincronizzazione, scelga i dati che desidera sincronizzare da Klaviyo. 

Oggetti 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.

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.

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. 

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. 

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 

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