Carica dati Klaviyo in BigQuery

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Nota: per ricevere assistenza o fornire un feedback su questa funzionalità, contatta [e-mail].

Per pianificare trasferimenti di dati ricorrenti da Klaviyo a BigQuery, crea una configurazione di trasferimento per specificare gli oggetti dati da trasferire e la frequenza con cui pianificare il trasferimento di dati. Puoi creare una configurazione del trasferimento utilizzando la Google Cloud console o lo bqstrumento a riga di comando. Una volta configurato il trasferimento, il BigQuery Data Transfer Service trasferisce i dati più recenti in una tabella BigQuery in base alla pianificazione specificata.

Per scoprire come funziona un trasferimento Klaviyo, consulta Introduzione ai trasferimenti di dati Klaviyo.

Limitazioni

I trasferimenti incrementali di Klaviyo sono soggetti alle seguenti limitazioni:

• Puoi scegliere solo le colonne TIMESTAMP come colonne filigrana.
• L'importazione incrementale è supportata solo per gli asset con colonne filigrana valide.
• I valori di una colonna filigrana devono essere in aumento monotono.
• I trasferimenti incrementali non possono sincronizzare le operazioni di eliminazione nella tabella di origine.
• Una singola configurazione del trasferimento può supportare solo l'acquisizione incrementale o completa.
• Non puoi aggiornare gli oggetti nell'elenco asset dopo la prima esecuzione dell'importazione incrementale.
• Non puoi modificare la modalità di scrittura in una configurazione di trasferimento dopo la prima esecuzione dell'importazione incrementale.
• Non puoi modificare la colonna filigrana o la chiave primaria dopo la prima esecuzione dell'importazione incrementale.
• La tabella BigQuery di destinazione viene raggruppata utilizzando la chiave primaria fornita ed è soggetta alle limitazioni delle tabelle in cluster.
• Quando aggiorni per la prima volta una configurazione del trasferimento esistente alla modalità di importazione incrementale, il primo trasferimento di dati dopo l'aggiornamento trasferisce tutti i dati disponibili dall'origine dati. I trasferimenti di dati incrementali successivi trasferiranno solo le righe nuove e aggiornate dall'origine dati.

Prima di iniziare

Le sezioni seguenti descrivono i prerequisiti da soddisfare prima di creare un trasferimento di dati Klaviyo.

Prerequisiti di Klaviyo

Devi disporre di una chiave API privata di sola lettura per consentire al connettore Klaviyo di trasferire i dati a BigQuery. Per ulteriori informazioni, consulta Creare una chiave privata.

Prerequisiti di BigQuery

• Verifica di aver completato tutte le azioni richieste per abilitare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i dati.

Ruoli BigQuery richiesti

Per ottenere le autorizzazioni necessarie per creare un trasferimento di dati BigQuery Data Transfer Service, chiedi all'amministratore di concederti il ruolo IAM di amministratore BigQuery (roles/bigquery.admin) nel tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito include le autorizzazioni necessarie per creare un trasferimento di dati BigQuery Data Transfer Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un trasferimento di dati BigQuery Data Transfer Service sono necessarie le seguenti autorizzazioni:

• Autorizzazioni BigQuery Data Transfer Service:
  • bigquery.transfers.update
  • bigquery.transfers.get
• Autorizzazioni BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.datasets.update
  • bigquery.datasets.setIamPolicy
  • bigquery.jobs.create

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni, consulta Concedere l'accesso bigquery.admin.

Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di disporre dell'autorizzazione IAM pubsub.topics.setIamPolicy. Le autorizzazioni Pub/Sub non sono necessarie se configuri solo le notifiche via email. Per ulteriori informazioni, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Configura un trasferimento di dati Klaviyo

Aggiungi i dati Klaviyo a BigQuery configurando un trasferimento utilizzando una delle seguenti opzioni:

Console

1. Vai alla pagina Trasferimenti di dati nella Google Cloud console.

   Vai a Trasferimenti di dati

2. Fai clic su Crea trasferimento.

3. Nella sezione Tipo di origine, per Origine, scegli Klaviyo - Anteprima.

4. Nella sezione Dettagli origine dati, segui questi passaggi:

   • In Chiave API privata, inserisci la chiave API privata. Per ulteriori informazioni, consulta Prerequisiti di Klaviyo.
   • (Facoltativo) In Data di inizio, specifica una data di inizio per i nuovi record da includere nel trasferimento di dati. Nel trasferimento di dati sono inclusi solo i record creati in questa data o dopo. Il valore predefinito è 3 mesi prima della data di esecuzione del trasferimento.
   • Per Oggetti Klaviyo da trasferire, fai clic su Sfoglia per selezionare gli oggetti da trasferire al set di dati di destinazione BigQuery. Puoi anche inserire manualmente gli oggetti da includere nel trasferimento di dati in questo campo.

5. Nella sezione Impostazioni destinazione, in Set di dati, scegli il set di dati che hai creato per archiviare i dati.

6. Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome per il trasferimento di dati.

7. Nella sezione Opzioni di pianificazione:

   • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza con cui viene eseguito questo trasferimento di dati. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, l'esecuzione avviene quando attivi manualmente il trasferimento.
   • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.

8. (Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:

   • Per attivare le notifiche via email, fai clic sul pulsante di attivazione/disattivazione Notifica email. Quando attivi questa opzione, l'amministratore del trasferimento riceve una notifica via email quando l'esecuzione di un trasferimento non riesce.
   • Per attivare le notifiche di esecuzione del trasferimento Pub/Sub per questo trasferimento, fai clic sul pulsante di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome del tuo argomento oppure fare clic su Crea un argomento per crearne uno.

9. Fai clic su Salva.

bq

Inserisci il bq mk comando e fornisci il flag di creazione del trasferimento --transfer_config:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

Sostituisci quanto segue:

• PROJECT_ID (facoltativo): l' Google Cloud ID del tuo progetto. Se non viene fornito --project_id per specificare un progetto particolare, viene utilizzato il progetto predefinito.
• DATA_SOURCE: l'origine dati: klaviyo.
• NAME: il nome visualizzato per la configurazione del trasferimento di dati. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
• DATASET: il set di dati di destinazione per la configurazione del trasferimento.

• PARAMETERS: i parametri per la configurazione del trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per un trasferimento di dati Klaviyo:

  • assets: il percorso degli oggetti Klaviyo da trasferire a BigQuery.
  • connector.authentication.privateApiKey: la chiave API privata per l'account Klaviyo.
  • connector.startDate: (facoltativo) una data di inizio per i nuovi record da includere nel trasferimento di dati, nel formato YYYY-MM-DD. Nel trasferimento di dati sono inclusi solo i record creati in questa data o dopo. Il valore predefinito è 3 mesi prima della data di esecuzione del trasferimento.

Il seguente comando crea un trasferimento di dati Klaviyo nel progetto predefinito.

    bq mk
        --transfer_config
        --target_dataset=mydataset
        --data_source=klaviyo
        --display_name='My Transfer'
        --params= ' {
            "assets": [ "Events" , "Flows"] ,
            "connector.authentication.privateApiKey" : "pk_123456789123",
            "connector.startDate": "2025-10-20"
            }'

Quando salvi la configurazione del trasferimento, il connettore Klaviyo attiva automaticamente un'esecuzione del trasferimento in base all'opzione di pianificazione. A ogni esecuzione del trasferimento, il connettore Klaviyo trasferisce tutti i dati disponibili da Klaviyo a BigQuery.

Per eseguire manualmente un trasferimento di dati al di fuori della pianificazione regolare, puoi avviare un'esecuzione di backfill.

Per un elenco dei dati inclusi in un trasferimento di dati Klaviyo, consulta Riferimento modello dei dati Klaviyo.

Risolvi i problemi di configurazione del trasferimento

Se riscontri problemi durante la configurazione del trasferimento di dati, consulta Problemi di trasferimento di Klaviyo.

Passaggi successivi

• Per una panoramica di BigQuery Data Transfer Service, consulta Che cos'è BigQuery Data Transfer Service.
• Per informazioni sull'utilizzo dei trasferimenti, inclusa la visualizzazione delle informazioni su una configurazione di trasferimento, l'elenco delle configurazioni di trasferimento e la visualizzazione della cronologia di esecuzione di un trasferimento, consulta Gestire i trasferimenti.