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. Ad ogni esecuzione, Klaviyo legge solo le righe il cui timestamp di rilevamento delle modifiche è più recente dell'ultima sincronizzazione riuscita. In questo modo è possibile importare i dati in modo incrementale senza rielaborare l'intera tabella.
3. Ogni riga viene quindi elaborata come segue:
   • Klaviyo determina il nome della metrica (tipo di evento) in base alle opzioni selezionate durante la configurazione della sincronizzazione: una singola metrica scelta o dinamicamente in base al valore di una colonna del nome della metrica designata nella tabella di origine.
   • Il timestamp dell'evento, gli identificatori del profilo, l'ID univoco, il valore e la valuta del valore opzionali sono impostati in base alle mappature dei campi configurate durante la configurazione della sincronizzazione.
   • Tutte le colonne rimanenti vengono acquisite come proprietà evento, utilizzando i nomi delle colonne come nomi di proprietà. Nomi di colonne con tre trattini bassi (ad esempio genitore___child1, parent___figlio2) può essere utilizzato per creare una proprietà evento (padre) con proprietà figlio.
4. Klaviyo carica gli eventi risultanti nel tuo account, dove si comportano come altre metriche API personalizzate in segmentazione, flussi e dati analitici.

Le importazioni vengono eseguite con una frequenza ricorrente (ad esempio, ogni ora), quindi le righe nuove o aggiornate del tuo magazzino vengono regolarmente tradotte in eventi in Klaviyo.

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.
• Hai creato e convalidato una connessione con il magazzino dati in Klaviyo. Consulta gli articoli del centro assistenza per il tuo magazzino dati per i dettagli sull'account di assistenza e sugli schemi richiesti.
• 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

Le seguenti colonne sono obbligatorie nella V1 dell'importazione degli eventi del magazzino dati:

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:

• Le colonne vengono importate come proprietà appiattite, con il nome della colonna utilizzato direttamente come nome della proprietà in Klaviyo.
• 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:

• Eventi di acquisto in negozio con totali degli ordini, ubicazione del negozio e tipo di appalto
• Appuntamento Completato eventi con membro del personale, 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:

• Ticket di assistenza creato e ticket di assistenza risolto
• Ordine restituito 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:

• Eventi di alto rischio di abbandono generati da un modello nel tuo magazzino
• Tappa fondamentale del ciclo di vita Eventi raggiunti quando un cliente passa a fasi diverse di un modello di ciclo di vita personalizzato

Configura la sincronizzazione dell'importazione degli eventi del magazzino dati

1) Collega il tuo magazzino dati

Se non hai ancora collegato il tuo magazzino:

1. In Klaviyo, vai su Advanced KDP > Gestione dei dati > Sincronizzazione.
2. Clicca su Aggiungi magazzino dati e seleziona il connettore del tuo magazzino dati.
3. Completa i passaggi di connessione per la tua piattaforma seguendo la guida alla connessione applicabile, collegata dall'articolo sulla panoramica dell'importazione del magazzino dati.

Klaviyo supporta una connessione attiva al magazzino dati per account.

2) Crea una nuova sincronizzazione dell'importazione degli eventi

Una volta connesso il tuo magazzino:

1. Da Advanced KDP > Gestione dei dati > Sincronizzazione, seleziona la connessione al tuo magazzino.
2. Scegli Importa dati (se stai configurando le importazioni per la prima volta) o fai clic su Crea sincronizzazione / Aggiungi sincronizzazione per una connessione esistente.
3. Quando viene richiesto il tipo di dati, seleziona Eventi (invece di Profili).
4. Scegli la tabella o la vista nel magazzino che contiene gli eventi che desideri importare.

3) Mappa i campi obbligatori

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

La configurazione dell'importazione degli eventi richiede che tu fornisca le mappature per:

• Data e ora dell'evento
• Nome della metrica (una costante selezionata nella configurazione o una colonna che contiene il nome della metrica per riga)
• Identificatore del profilo (almeno uno)
• Modifica la data e l'ora di rilevamento

Puoi anche mappare i campi consigliati:

• ID univoco
• Valore
• 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.

4) Scegli la frequenza di sincronizzazione e l'ambito storico

Quando salvi l'importazione del tuo evento:

• Klaviyo programma le sincronizzazioni ricorrenti in modo che vengano eseguite a una cadenza regolare (solitamente ogni ora).
• A ogni esecuzione vengono elaborate solo le righe il cui timestamp di rilevamento delle modifiche è più recente dell'ultima esecuzione riuscita, assicurando che le importazioni siano incrementali.

Per il recupero dello storico dei dati, 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 poi passa a una vista supportata dall'acquisizione delle modifiche e dei dati per gli aggiornamenti continui.

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, Ordine effettuato).
• 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:

• La versione 1 dell'importazione degli eventi si concentra solo sui dati degli eventi. Gli aggiornamenti delle proprietà del profilo derivati dagli eventi possono essere aggiunti in un'iterazione successiva. Per ora, le proprietà del profilo devono essere aggiornate tramite l'importazione del profilo 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 una velocità ottimale, imposta il campo di rilevamento delle modifiche sulla data e l'ora di creazione della nuova tabella. I record vengono raggruppati in cicli di sincronizzazione utilizzando questo valore, quindi il tempo di importazione dei record storici può essere ridotto se tutti i record storici hanno una data e un'ora di rilevamento delle modifiche in un intervallo ristretto (ad esempio la data e l'ora di un processo che crea la nuova tabella).
• Utilizza un ID univoco stabile per evento, ove possibile, per migliorare la deduplicazione e semplificare il debug a valle.
• Se la tua tabella contiene più tipi di eventi (metriche) con diversi set di colonne, in genere va bene tenerli insieme: le colonne NULL per determinate righe vengono semplicemente ignorate per quegli eventi in Klaviyo.
• 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.

"