Introduzione ai trasferimenti di dati di Klaviyo

Puoi caricare i dati da Klaviyo a BigQuery utilizzando il BigQuery Data Transfer Service per Klaviyo. Con BigQuery Data Transfer Service, puoi pianificare job di trasferimento ricorrenti che aggiungono i dati più recenti da Klaviyo a BigQuery.

Per scoprire come pianificare un trasferimento di Klaviyo, consulta Caricare i dati di Klaviyo in BigQuery.

Opzioni di acquisizione dei dati

Queste sezioni descrivono le opzioni di importazione dati per configurare un trasferimento di dati di Klaviyo.

Trasferimenti completi o incrementali

Quando configuri un trasferimento di Klaviyo, puoi specificare come caricare i dati in BigQuery selezionando la preferenza di scrittura Completa o Incrementale nella configurazione del trasferimento quando imposti un trasferimento di Klaviyo. I trasferimenti incrementali sono supportati in anteprima.

Puoi configurare un trasferimento di dati completo per trasferire tutti i dati dai set di dati di Klaviyo a ogni trasferimento di dati.

In alternativa, puoi configurare un trasferimento di dati incrementale (anteprima) per trasferire solo i dati modificati dall'ultimo trasferimento di dati, anziché caricare l'intero set di dati a ogni trasferimento di dati. Se selezioni Incrementale per il trasferimento di dati, devi specificare le modalità di scrittura Aggiungi o Esegui upsert per definire come vengono scritti i dati in BigQuery durante un trasferimento di dati incrementale. Le sezioni seguenti descrivono le modalità di scrittura disponibili.

Modalità di scrittura Aggiungi

La modalità di scrittura Aggiungi inserisce solo nuove righe nella tabella di destinazione. Questa opzione aggiunge rigorosamente i dati trasferiti senza verificare la presenza di record esistenti, pertanto questa modalità può potenzialmente causare la duplicazione dei dati nella tabella di destinazione.

Quando selezioni la modalità di aggiunta, devi selezionare una colonna watermark. Il connettore Klaviyo richiede una colonna watermark per monitorare le modifiche nella tabella di origine.

Per i trasferimenti di Klaviyo, ti consigliamo di selezionare una colonna che viene aggiornata solo al momento della creazione del record e non cambia con gli aggiornamenti successivi, ad esempio la colonna CREATED_AT.

Modalità di scrittura Esegui upsert

La modalità di scrittura Esegui upsert aggiorna una riga o ne inserisce una nuova nella tabella di destinazione verificando la presenza di una chiave primaria. Puoi specificare una chiave primaria per consentire al connettore Klaviyo di determinare le modifiche necessarie per mantenere aggiornata la tabella di destinazione con la tabella di origine. Se la chiave primaria specificata è presente nella tabella BigQuery di destinazione durante un trasferimento di dati, il connettore Klaviyo aggiorna la riga con i nuovi dati della tabella di origine. Se una chiave primaria non è presente durante un trasferimento di dati, il connettore Klaviyo inserisce una nuova riga.

Quando selezioni la modalità Esegui upsert, devi selezionare una colonna watermark e una chiave primaria:

  • Il connettore Klaviyo richiede una colonna watermark per monitorare le modifiche nella tabella di origine.
    • Seleziona una colonna watermark che si aggiorna ogni volta che una riga viene modificata. Ti consigliamo di utilizzare colonne simili a UPDATED_AT o LAST_MODIFIED.

  • La chiave primaria può essere una o più colonne della tabella necessarie al connettore Klaviyo per determinare se deve inserire o aggiornare una riga.

    Seleziona le colonne che contengono valori non nulli univoci in tutte le righe della tabella. Ti consigliamo di utilizzare colonne che includono identificatori generati dal sistema, codici di riferimento univoci (ad esempio ID a incremento automatico) o ID di sequenza basati sul tempo immutabili.

    Per evitare potenziali perdite o danneggiamenti dei dati, le colonne della chiave primaria selezionate devono avere valori univoci. Se hai dubbi sull'unicità della colonna della chiave primaria scelta, ti consigliamo di utilizzare la modalità di scrittura Aggiungi.

Mappatura dei tipi di dati

La tabella seguente mappa i tipi di dati di Klaviyo ai tipi di dati di BigQuery corrispondenti:

Tipo di dati di Klaviyo Tipo di dati di BigQuery
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

Prezzi

Non sono previsti costi per il trasferimento dei dati di Klaviyo in BigQuery durante l'anteprima di questa funzionalità.

Passaggi successivi