Carregar dados do Klaviyo no BigQuery

Console

1. Acesse a página "Transferências de dados" no Cloud de Confiance console.

   Acessar transferências de dados

2. Clique em add Criar transferência.

3. Na seção Tipo de origem, em Origem, escolha Klaviyo - Visualização.

4. Na seção Detalhes da fonte de dados, faça o seguinte:

   • Em Chave de API privada, insira sua chave de API privada. Para mais informações, consulte Pré-requisitos do Klaviyo.
   • Opcional: em Data de início, especifique uma data de início para que novos registros sejam incluídos na transferência de dados. Somente os registros criados nessa data ou depois dela serão incluídos na transferência de dados. O valor padrão é de três meses antes da data de execução da transferência.
   • Em Objetos do Klaviyo para transferência, clique em Procurar para selecionar os objetos a serem transferidos para o conjunto de dados de destino do BigQuery. Nesse campo, também é possível inserir manualmente qualquer objeto para incluir na transferência de dados.

5. Na seção Configurações de destino, no campo Conjunto de dados, escolha o conjunto de dados que você criou para armazenar seus dados.

6. No campo Nome de exibição da seção Nome de configuração da transferência, insira um nome para a transferência de dados.

7. Na seção Opções de programação, faça o seguinte:

   • Na lista Frequência de repetição, selecione uma opção para especificar com que frequência essa transferência de dados é executada. Para especificar uma frequência de repetição personalizada, selecione Personalizada. Se você selecionar Sob demanda, essa transferência será executada quando você acionar manualmente a transferência.
   • Se aplicável, selecione Começar agora ou Começar no horário definido e escolha uma data de início e hora de execução.

8. Opcional: na seção Opções de notificação, faça o seguinte:

   • Para ativar as notificações por e-mail, clique no botão que ativa as Notificações por e-mail. Quando essa opção está ativada, o administrador da transferência recebe uma notificação por e-mail quando uma execução da transferência falha.
   • Para ativar as notificações de execução de transferência do Pub/Sub para essa transferência, clique no botão de alternância Notificações do Pub/Sub. Selecione o nome do tópico ou clique em Criar tópico.

9. Clique em Salvar.

bq

Insira o comando bq mk e forneça a sinalização de execução da transferência --transfer_config:

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

Substitua:

• PROJECT_ID (opcional): o ID do seu Cloud de Confiance by S3NS projeto. Se --project_id não for fornecido para especificar um projeto determinado, o projeto padrão será usado;
• DATA_SOURCE: a fonte de dados — klaviyo.
• NAME: o nome de exibição da configuração da transferência de dados. O nome da transferência pode ser qualquer valor que permita identificá-la, caso você precise modificá-la mais tarde.
• DATASET: o conjunto de dados de destino na configuração da transferência.

• PARAMETERS é o parâmetro da configuração de transferência criada no formato JSON. Por exemplo: --params='{"param":"param_value"}'. Veja a seguir os parâmetros de uma transferência de dados do Klaviyo:

  • assets: o caminho para os objetos do Klaviyo a serem transferidos para o BigQuery.
  • connector.authentication.privateApiKey: a chave de API privada da conta do Klaviyo.
  • connector.startDate: (opcional) uma data de início para que novos registros sejam incluídos na transferência de dados, no formato YYYY-MM-DD. Somente os registros criados nessa data ou depois dela serão incluídos na transferência de dados. O valor padrão é de três meses antes da data de execução da transferência.

O comando a seguir cria uma transferência de dados do Klaviyo no projeto padrão.

    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"
            }'