Informazioni sull'importazione degli eventi del magazzino dati in Klaviyo

Cosa imparerai

Scopri come utilizzare l'importazione degli eventi del magazzino dati per sincronizzare i dati degli eventi dal tuo magazzino dati in Klaviyo, in modo da poter potenziare segmenti, flussi e reportistica con comportamenti che hanno origine al di fuori delle integrazioni native di Klaviyo (ad esempio, sistemi POS, piattaforme di assistenza o applicazioni personalizzate).

Cos'è l'importazione degli eventi del magazzino dati?

L'importazione degli eventi del magazzino dati consente a Klaviyo di connettersi direttamente al tuo magazzino dati e di configurare le sincronizzazioni delle importazioni dalle tabelle o dalle visualizzazioni del magazzino dati che contengono i dati degli eventi.

Ogni riga della tua tabella di origine viene trattata come un singolo evento in Klaviyo:

• Le marche temporali, il nome della metrica e gli identificatori della riga definiscono cosa è successo, quando e per chi.
• Le colonne aggiuntive diventano proprietà dell'evento che puoi utilizzare nella segmentazione, nei flussi e nei dati analitici.

L'importazione degli eventi si basa sulla stessa infrastruttura di importazione del magazzino dati dell'importazione dei profili, ma ha come target la pipeline di acquisizione degli eventi di Klaviyo invece dei profili.

Come funziona l'importazione degli eventi del magazzino dati?

Dopo aver collegato Klaviyo al tuo magazzino e aver configurato la sincronizzazione degli eventi:

1. Klaviyo richiede al tuo magazzino dati per la tabella o la vista configurata.
2. La prima importazione legge la cronologia disponibile nella tua origine. Le esecuzioni successive riprendono dai progressi salvati usando il timestamp di rilevamento delle modifiche, quindi Klaviyo non rielabora l’intera tabella.
3. Ogni riga viene quindi elaborata come segue:
   • Klaviyo determina il nome della metrica (tipo di evento) a partire da una metrica API esistente che selezioni oppure dal valore di una colonna designata per il nome della metrica in ogni riga.
   • Il timestamp dell’evento, gli identificatori del profilo e l’ID univoco e il valore facoltativi vengono impostati in base alle mappature dei campi configurate durante la configurazione della sincronizzazione.
   • Tutte le colonne rimanenti vengono acquisite come proprietà dell’evento, utilizzando i nomi delle colonne come nomi delle proprietà. I nomi delle colonne con 3 underscore (ad esempio parent___child1, parent___child2) possono essere utilizzati per creare una proprietà dell’evento (parent) con proprietà figlie.
4. Klaviyo carica gli eventi risultanti nel tuo account, dove si comportano come altre metriche API personalizzate in segmentazione, flussi e dati analitici.

Puoi programmare importazioni ricorrenti (es., ogni ora) oppure scegliere Manual per eseguire le importazioni quando necessario.

Prima di iniziare

Assicurati che i seguenti requisiti siano soddisfatti prima di creare una sincronizzazione dell'importazione degli eventi:

• Il tuo account ha accesso ad Advanced KDP e all'importazione del magazzino dati.
• Prepara le credenziali e gli schemi dell’account di servizio richiesti per il tuo warehouse. Consulta le guide di connessione in Comprendere l’importazione del magazzino dati in Klaviyo.
• La tua tabella o vista di origine contiene le colonne obbligatorie riportate di seguito.
• Nel tuo magazzino hai privilegi sufficienti per mostrare le tabelle/viste necessarie all'utente del servizio di Klaviyo.

Struttura della tabella di origine per gli eventi

Per garantire che i dati dell'evento possano essere importati correttamente, la tabella o la vista di origine deve soddisfare i campi e la struttura richiesti da Klaviyo.

Campi obbligatori

Per l'importazione di eventi nel magazzino dati sono necessarie le seguenti colonne:

Campi opzionali

Questi campi sono consigliati quando applicabili, ma non strettamente richiesti:

Proprietà dell'evento

Tutte le altre colonne della tua tabella vengono trattate come proprietà dell'evento:

• I nomi delle colonne diventano nomi di proprietà di primo livello, a meno che non contengano 3 caratteri di sottolineatura (___), che creano proprietà figlie annidate come descritto sopra.
• Non è necessario mappare esplicitamente ogni proprietà; le colonne non mappate saranno incluse come proprietà dell'evento.
• Il JSON nidificato può essere memorizzato all'interno di un singolo valore di proprietà, se necessario (ad esempio, un oggetto JSON di elementi riga), ma il nome della proprietà stesso proviene da una colonna di primo livello.

Klaviyo esegue l'analisi del tipo di operazione consigliata per le proprietà dell'evento e non fornisce la logica di trasformazione per campo come parte della configurazione dell'importazione dell'evento.

Casi d'uso comuni

I clienti in genere utilizzano l'importazione degli eventi del magazzino dati per:

1) Importazione di eventi offline o POS

Inserisci gli eventi in negozio o offline (ad esempio, acquisti POS, resi o appuntamenti) dal tuo magazzino, in modo che si comportino come altri eventi e metriche di Klaviyo.

Esempi:

• In-Store Purchase eventi con totali degli ordini, posizione del negozio e tipo di pagamento
• Appointment Completed eventi con membro dello staff, tipo di servizio e durata

2) Interazioni con l'assistenza

Sincronizza gli eventi di assistenza e supporto come la creazione, la risoluzione o i resi dei ticket per arricchire le tempistiche dei tuoi clienti e potenziare la messaggistica in base alla cronologia dell'assistenza.

Esempi:

• Support Ticket Created e Support Ticket Resolved
• Order Returned con codici motivo e importi di rimborso

3) Eventi modellati o derivati

Converti i comportamenti basati sul magazzino in eventi più facili da usare in Klaviyo.

Esempi:

• High Churn Risk eventi generati da un modello nel tuo data warehouse
• Lifecycle Milestone Reached eventi quando un cliente passa da una fase all’altra in un modello personalizzato del ciclo di vita

Configura la sincronizzazione dell'importazione degli eventi del magazzino dati

1) Collega il tuo magazzino dati

Se il tuo magazzino è già collegato, passa al passaggio 2. In caso contrario:

1. In Klaviyo, vai su Advanced KDP > Gestione dei dati > Sincronizzazione.
2. Fai clic su Crea sincronizzazione se hai già delle sincronizzazioni configurate. Seleziona Importa dati dal tuo magazzino dati, quindi seleziona il connettore del tuo magazzino.
3. Completa i passaggi di preparazione del magazzino dati nella guida di connessione applicabile collegata da Comprendere l’importazione del magazzino dati in Klaviyo.
4. Fai clic su Connetti a, quindi sul nome del tuo data warehouse. Inserisci i dettagli di connessione richiesti, quindi fai clic su Avanti.
5. Fai clic su Test. Dopo che la connessione è riuscita e Klaviyo può accedere ad almeno 1 tabella o vista, fai clic su Avanti.

Puoi creare più importazioni del magazzino dati e aggiungere tabelle o viste di origine a ogni connessione.

Prima di creare la sincronizzazione, decidi quali eventi storici includere. Puoi:

• Puntare l'importazione del tuo evento su una tabella o vista che includa già tutti gli eventi storici pertinenti, oppure
• Inizia con una tabella storica dedicata e in seguito passa a una vista basata su change data capture per gli aggiornamenti continui. Mantieni le stesse colonne mappate e assegna alle nuove righe timestamp di rilevamento delle modifiche successivi ai progressi salvati della sincronizzazione.

2) Crea una nuova sincronizzazione dell'importazione degli eventi

Per una nuova connessione, continua nella configurazione che hai aperto sopra. Per una connessione esistente, prima:

1. Da Advanced KDP > Gestione dei dati > Sincronizzazione, seleziona la connessione al tuo magazzino.
2. Clicca su Aggiungi una fonte.

Nella configurazione della sincronizzazione:

1. Inserisci un nome per la sincronizzazione e, facoltativamente, una descrizione.
2. In Origine dati, seleziona la tabella o la vista che contiene gli eventi che vuoi importare.
3. In Tipi di oggetti dati, seleziona Eventi.

3) Scegli la frequenza di sincronizzazione

1. In Cadenza, scegli come eseguire la sincronizzazione:
   • Esecuzione pianificata: scegli l’intervallo in Ogni e imposta Data di inizio, Ora di inizio e Fuso orario. L’intervallo predefinito è di 1 ora.
   • Manuale: salva la sincronizzazione senza una pianificazione ricorrente ed eseguila quando serve.
2. Fai clic su Avanti per mappare i campi.

4) Mappare i campi obbligatori

Successivamente, mapperai le colonne dalla tabella del magazzino ai campi evento obbligatori di Klaviyo.

Completa queste mappature:

1. In Rilevamento delle modifiche, seleziona la colonna del timestamp per il rilevamento delle modifiche in Rilevamento nuove righe. Usa una colonna di origine diversa rispetto al timestamp dell'evento.
2. In Tipo di evento, scegli 1 di queste opzioni:
   • Stesso tipo di evento: seleziona una metrica API esistente per tutte le righe.
   • Tipo di evento specifico per ogni riga: seleziona la colonna che contiene il nome della metrica di ogni riga. Usa questa opzione se la metrica di cui hai bisogno non è presente nell’elenco esistente delle metriche API.
3. In Timestamp degli eventi, seleziona la colonna che registra quando si è verificato l’evento.
4. In Proprietà del profilo, fai clic su Aggiungi mappatura e mappa almeno 1 identificatore del profilo (ad es. e-mail, numero di telefono, ID esterno o ID Klaviyo).

Puoi anche mappare i campi consigliati:

• ID univoco
• Valore

Per mantenere i metadati della valuta (ad esempio, USD), lascia la sua colonna non mappata in modo che diventi una proprietà dell’evento. Non esiste una mappatura dedicata per Valuta del valore.

Tutte le colonne rimanenti che non hai mappato esplicitamente su questi campi fondamentali diventano automaticamente proprietà dell'evento.

L'interfaccia utente di configurazione ti impedisce di mappare più colonne sullo stesso campo di primo livello e verifica che tutti i campi obbligatori siano presenti prima di consentirti di salvare.

5) Salva e controlla la sincronizzazione

1. Controlla le impostazioni, poi fai clic su Fine per salvare la sincronizzazione dell’importazione dell’evento.
2. Nella pagina di connessione del magazzino, fai clic sul nome della sincronizzazione. Se la configurazione ti ha riportato alla panoramica Sincronizzazione, seleziona prima la connessione del magazzino.
3. Se hai scelto Manuale, fai clic su Esegui sincronizzazione per avviare l’importazione. Le importazioni pianificate vengono eseguite secondo la cadenza selezionata.
4. Controlla Cronologia esecuzioni per verificare l'avanzamento e Log per gli errori.

Come si comportano gli eventi importati in Klaviyo

Una volta importato:

• Ogni riga appare come un evento di una metrica API personalizzata in Klaviyo.
• Il nome della metrica che hai mappato (o configurato come costante) determina il nome del tipo di evento che vedi nel prodotto (ad esempio, Placed Order).
• Tutti gli identificatori del profilo vengono risolti nei profili esistenti, ove possibile; in caso contrario, Klaviyo crea nuovi profili utilizzando i campi identificatori forniti, in modo simile ad altri percorsi di acquisizione degli eventi.

Puoi utilizzare questi eventi per:

• Crea segmenti in base a ciò che qualcuno ha fatto e filtra in base alle proprietà dell'evento.
• Attiva e filtra i flussi.
• Analizza il comportamento nelle metriche e nella reportistica insieme agli eventi provenienti da altre fonti.

Limitazioni e procedure consigliate

Quando utilizzi l'importazione degli eventi del magazzino dati, tieni presente quanto segue:

• Usa l'importazione di eventi per i dati degli eventi. Per aggiornare le proprietà del profilo, utilizza l'importazione dei profili o altri percorsi supportati.
• Il timestamp di rilevamento delle modifiche deve essere diverso dal timestamp dell'evento. Utilizzare la stessa colonna per entrambi può impedirti di importare in modo sicuro lo storico degli eventi dopo la prima sincronizzazione.
• Per i backfill storici, usa l'ora in cui ogni riga è stata caricata nel warehouse come timestamp di rilevamento delle modifiche. Un job che crea una tabella storica può memorizzare il timestamp del job nelle righe per mantenere l’intervallo ristretto. Non ricalcolare questo timestamp ogni volta che una view viene interrogata e segui le indicazioni sul volume di righe riportate di seguito.
• Quando possibile, usa un ID univoco stabile per ogni evento per migliorare la deduplicazione e semplificare il debug. Reimportare lo stesso ID per lo stesso profilo e la stessa metrica viene considerato un duplicato; non aggiorna le proprietà dell’evento.
• Puoi mantenere più tipi di evento (metriche) nella stessa tabella. Le colonne non mappate vengono incluse come proprietà dell’evento, quindi usa viste separate se ti servono set di proprietà diversi per metriche diverse.
• Per gli oggetti nidificati complessi (ad esempio, matrici di elementi riga), ti consigliamo di unire in più colonne laddove possibile, soprattutto per le proprietà che prevedi di utilizzare nella segmentazione o nei flussi.
• Mantieni gli indicatori temporali del rilevamento delle modifiche storiche in un intervallo ristretto. Durante il backfill iniziale, Klaviyo legge i dati in finestre di 1 ora a partire dall’indicatore temporale di rilevamento delle modifiche più vecchio. Un singolo record del 2023, quando tutti gli altri sono recenti, può rendere più lento quel backfill perché Klaviyo deve avanzare attraverso le finestre intermedie. Le esecuzioni successive riprendono dall’avanzamento salvato invece di ricominciare dal record più vecchio.
• Non superare circa 100.000 righe in un'unica finestra di rilevamento delle modifiche della durata di 1 ora. Se troppe righe condividono la stessa finestra di 1 ora, la query di sincronizzazione potrebbe interrompersi.

Migliora le prestazioni delle query Snowflake

Configurazione consigliata della chiave di clustering Snowflake

Per tabelle Snowflake di grandi dimensioni, una chiave di clustering sul timestamp di rilevamento delle modifiche può aiutare le query a saltare micro-partizioni non necessarie. Testa query rappresentative prima di aggiungere una chiave e valuta eventuali risparmi di query rispetto ai crediti Snowflake utilizzati per mantenere il clustering:

ALTER TABLE your_schema.your_table CLUSTER BY (your_change_timestamp_column);