Klaviyo Klaviyo BigQuery Google BigQuery Tutorial

Como Conectar Klaviyo ao Google BigQuery

Juan Bello

Juan Bello

Fundador, Porter Metrics

30 jan 2026
15 min de leitura

Para conectar Klaviyo ao Google BigQuery:

  1. 1

    Faça login com Google em portermetrics.com.

  2. 2

    Selecione Google BigQuery como destino.

  3. 3

    Selecione Klaviyo como fonte de dados e nomeie sua conexão.

  4. 4

    Conecte sua conta Klaviyo usando sua Private API key.

  5. 5

    Autentique o BigQuery via login do Google ou Service Account.

  6. 6

    Selecione Project ID, localização do Dataset, Dataset e nome da tabela (ou crie uma nova).

  7. 7

    Selecione métricas (e.g., Profile Average Order Value) e dimensões (e.g., Campaign Name).

  8. 8

    Opcionalmente, crie campos personalizados (e.g., Revenue Per Email, CLV).

  9. 9

    Defina o intervalo de datas (e.g., this month to date).

  10. 10

    Agende atualizações em linguagem natural (e.g., “daily at 8am”).

  11. 11

    Defina o modo de escrita (overwrite, append, or update).

  12. 12

    Envie e monitore os logs de execução.

Quatro formas gratuitas e pagas de conectar Klaviyo ao Google BigQuery

2. Ferramentas gerais de ETL/ELT

Plataformas de integração de dados para engenheiros de dados. Exemplos: Fivetran, Stitch, Airbyte.

Exportam tabelas brutas que espelham o schema da fonte: uma tabela para perfis, uma para listas, uma para campanhas, uma para fluxos. Cada tabela contém todos os campos. O engenheiro de dados escreve SQL JOINs para relacionar tabelas, seleciona campos, transforma dados e usa dbt ou Python para pré-processamento antes da visualização.

3. Google BigQuery Data Transfer Service

Integração nativa gratuita do Google para engenheiros de dados.

Requisitos de configuração:

  • Gere uma Private API Key nas Configurações da Conta Klaviyo.
  • Copie a chave privada para autenticação da API.
  • Limites de taxa: 75 requests/segundo para a maioria dos endpoints.
  • Sem OAuth necessário — autenticação por API key.
  • Construa pipeline ETL personalizado para BigQuery (sem integração nativa).

O que você obtém:

  • Dados de perfis, listas e segmentos.
  • Métricas de performance de campanhas e fluxos.
  • Manutenção manual do pipeline de dados necessária.

Limitações:

  • Sem integração nativa com BigQuery: requer pipeline ETL personalizado.
  • Limites de dados de eventos: grandes volumes de eventos podem requerer paginação.
  • Versionamento de API: Klaviyo está em transição para novas versões de API.
  • Cálculos de métricas: algumas métricas requerem agregação personalizada.

4. Exportação manual CSV ou Google Sheets

Exporte do Klaviyo manualmente. Sem automação.

Como funciona:

Limitações:

  • Sem automação: repita manualmente para cada atualização.
  • Limite de colunas: máximo de 700 colunas por exportação. Sem limite documentado de linhas.
  • Sem atualizações agendadas.
  • Upload manual para BigQuery necessário.

Como Conectar Klaviyo ao Google BigQuery para Profissionais de Marketing (Sem Código)

Porter é um conector nativo de IA. Configure tudo com linguagem natural, não SQL ou formulários. Campos personalizados, filtros, agendamento—tudo por prompts em inglês simples. Sem código, sem engenharia de dados necessária.

  • A visualização dos dados está sempre ao vivo. Conforme você seleciona métricas, dimensões, filtros e intervalos de datas, Porter mostra seus dados em tempo real. Verifique tudo antes de enviar ao BigQuery.
  • Os dados chegam transformados, combinados e prontos para visualizar. Nenhuma transformação SQL necessária depois.

Neste tutorial, mostraremos como enviar seus dados do Klaviyo para o Google BigQuery com Porter. Enviaremos dados de email marketing incluindo campos como Campaign Opens, Clicks, Revenue e campos personalizados como Revenue per Email e Conversion Rate.

Criar uma conexão

Faça login em portermetrics.com com Google. Clique em “Create” e selecione “Google BigQuery” como destino. Nomeie sua conexão (e.g., “Klaviyo Campaign Performance”). Selecione Klaviyo como fonte de dados.

Interface de seleção de projetos BigQuery
  • Combinação de dados: opcionalmente, adicione Meta Ads, Shopify, Google Ads na mesma conexão para relatórios cross-channel.

Conecte suas contas Klaviyo

Insira sua Private API key do Klaviyo. Você pode gerar isso nas configurações da sua conta Klaviyo. Selecione as contas Klaviyo que deseja conectar.

Conectar Klaviyo ao Google BigQuery

Multi-conta

Consolide dezenas ou centenas de contas em um único relatório.

Permissões necessárias

Acesso completo ou API key personalizada na conta Klaviyo.

Tokens nunca expiram

Sua conexão Klaviyo permanece ativa enquanto sua API key for válida.

Conecte seu destino BigQuery

Autentique com login do Google ou Service Account. Selecione Project ID, localização do Dataset, Dataset e nome da tabela.

Interface de seleção de projetos BigQuery
  • Login do Google (recomendado): Porter lista seus projetos em um dropdown. Opção mais fácil.
  • Service Account JSON: para empresas com gestão rigorosa de permissões no Google Workspace. Copie um texto JSON dos detalhes do seu projeto para conectar.
  • Localização do Dataset: US, EU ou sua região preferida.
  • Auto-atualização de schema: se você alterar sua query depois, Porter atualiza o schema automaticamente e reescreve na sua tabela BigQuery, diferente de outras ferramentas.

Novo no BigQuery? Crie seu primeiro projeto:

Acesse console.cloud.google.com. No Menu de Navegação (canto superior esquerdo), selecione BigQuery → Studio. No painel esquerdo, você verá seus projetos.

  1. Crie um Projeto: selecione ou crie um novo projeto (e.g., “Marketing Data”). Escolha um nome, tipo e organização. BigQuery cria uma pasta para ele.
  2. Crie um Dataset: expanda a pasta do seu projeto, clique nas reticências e selecione “Create Dataset”. Nomeie-o (e.g., “email_data”) e selecione uma localização (US ou EU).
  3. Crie uma Tabela: dentro do seu dataset, você pode criar uma tabela (e.g., “klaviyo_email”). Ou deixe Porter criar automaticamente quando você enviar sua primeira query.

O Project ID, nome do Dataset e nome da Tabela que você definir aqui são os mesmos valores que você inserirá na configuração do BigQuery no Porter.

Verifique seus dados no BigQuery:

Quando você seleciona uma tabela, BigQuery mostra a visualização Schema primeiro. Esses são os metadados: nomes de campos, tipos de campos e modos. Para ver seus dados exportados, vá para a aba Preview. Quando sua query executar, você verá a tabela completa com seus dados.

Preview do dataset no Google BigQuery

Escolha métricas

No dropdown de métricas, pesquise e selecione: e.g., Profile Historic CLV, Profile Predicted CLV, Profile Total CLV, Profile Average Order Value, Profile Historic Number Of Orders.

Selecionar métricas do Klaviyo para transferir ao Google BigQuery
+500 Campos Disponíveis: Porter traz a maioria dos campos da API do Klaviyo. Espere exatamente os mesmos dados que você vê na plataforma. Veja todos os campos do Klaviyo

Escolha dimensões

Para segmentar seus dados, no dropdown de dimensões, pesquise e selecione: e.g., Campaign Name, Campaign Channel, Date.

Selecionar dimensões do Klaviyo para transferir ao Google BigQuery
  • Outras dimensões: Date, Campaign Archived, Campaign Channel, Campaign Created At, Campaign ID, Campaign Ignore Unsubscribers, Campaign Is Add UTM.
  • Dimensões de tempo: Date, Week, Month, Quarter, Year disponíveis para análise de tendências.
  • Lista completa de campos: Consulte a documentação do Porter para todos os campos e dimensões disponíveis.

Veja todos os campos do Klaviyo

Crie campos personalizados

Para métricas personalizadas, adicione uma nova métrica, digite sua fórmula em linguagem natural e verifique a fórmula gerada e uma preview da query. Escolha o formato da sua métrica (number, currency, percentage). Para este exemplo: CLV Growth = “Profile Predicted CLV / Profile Historic CLV”, Churn Risk = “Profile Churn Probability / Profile Total CLV”.

Interface de criação de métricas personalizadas com linguagem natural

Para dimensões personalizadas, digite sua fórmula para segmentar dados baseado em convenções de nomenclatura. Se suas convenções de nomenclatura incluem objetivo, estágio do funil ou produtos, digite uma fórmula como: “Se campaign name contém ‘awareness’, etiquetar como ‘Awareness’. Se contém ‘consideration’, etiquetar como ‘Consideration’. Se contém ‘conversion’, etiquetar como ‘Conversion’. Senão ‘Other’.” Na preview, veja como Porter transforma condicionais em regex para segmentações personalizadas.

Interface de criação de dimensões personalizadas

Crie suas próprias métricas ou dimensões para que nenhum SQL ou transformação seja necessária no BigQuery. Seus dados estão prontos para conectar ao Looker Studio. Operações suportadas: matemática (sum, subtract, divide, multiply), condicionais (if/then/else), regex (correspondência de padrões). Mesmas capacidades dos campos calculados do Looker Studio.

Defina intervalo de datas

Selecione um intervalo de datas no dropdown. Para este exemplo: últimos 30 dias.

Interface de definição de intervalo de datas
  • Intervalos dinâmicos: today, yesterday, last 7/14/28/30/90 days, this week/month/quarter/year to date, last week/month/quarter/year.
  • Intervalos fixos: datas específicas de início e fim.
  • Auto-atualização: dados atualizam automaticamente baseado no intervalo dinâmico.

Adicione filtros

O conector Klaviyo pode retornar registros sem atividade. Criaremos um filtro para excluí-los.

Para este exemplo:

  • Condição: Exclude
  • Campo: Email Status
  • Operador: equals
  • Valor: 0
Interface de criação de filtros

Isso exclui todas as campanhas sem atividade, então sua query retorna apenas campanhas com atividade.

  • Operadores disponíveis: equals, contains, not contains, greater than, less than, starts with, ends with.
  • Detecção de valor: Porter detecta automaticamente se o campo é número ou texto.
  • Combine filtros: adicione lógica AND/OR dentro da mesma condição ou crie múltiplos filtros em uma query.

Agende atualização

Digite seu agendamento em linguagem natural. Para este exemplo: “every day at 8am”.

Interface de agendamento de atualizações de dados com IA
  • Exemplos: “Every Monday at 5am”, “Weekdays at 7pm”, “Every hour”, “Every Tuesday and Friday at 9am”.
  • Auto-conversão: Porter converte prompts em expressões cron.
  • Fuso horário: detectado automaticamente do seu navegador.
  • Frequência mínima: a cada minuto. Sem custo extra para atualizações frequentes.

Escolha modo de escrita

Selecione como Porter escreve dados no BigQuery. Para este exemplo: Overwrite.

Interface de modo de atualização de dados
  • Overwrite (recomendado): deleta tabela existente e escreve dados novos. Sem duplicatas.
  • Append: adiciona novas linhas abaixo dos dados existentes. Risco de duplicatas se o mesmo intervalo de datas rodar duas vezes.
  • Update: corresponde linhas por dimensão e atualiza valores. Para dados CRM com valores que mudam.

Envie, monitore e organize

Clique em “Save” para salvar sua query e clique em “Send” para entregar os dados ao Google BigQuery. A transferência leva alguns segundos dependendo do volume de dados. Quando terminar, você pode atualizar ou criar mais queries.

Interface de gerenciamento de dados

Para criar mais queries: volte ao gerenciador de queries dentro da sua conexão, ou vá para Porter Metrics → Account → Reports → Connections. Na aba Queries, você verá todas as queries rodando da sua conta com sua conexão associada, nome, fontes de dados, horário da última execução, status mais recente e opção para rodar manualmente.

Para monitorar execuções: clique no ícone de reticências e selecione “History”. Você verá logs com data e hora exatas, tipo de execução (manual ou agendada) e status. Se ocorrer um erro, você verá a mensagem de erro específica.

Para organizar seus dados: gerencie conexões e queries dentro delas. Nomeie conexões por campanha (e.g., “Black Friday”), por cliente ou por fonte de dados. Dentro de cada conexão, crie quantas queries ou tabelas precisar e renomeie-as. Você pode habilitar/desabilitar queries ou conexões, e atualizar qualquer query a qualquer momento—Porter atualiza e reescreve o schema no BigQuery automaticamente.

Como Conectar sua Tabela BigQuery ao Google Looker Studio

Primeiro, verifique seus dados no BigQuery:

Acesse console.cloud.google.com/bigquery. No menu esquerdo, em Products, encontre BigQuery → Studio. É aqui que você gerencia suas tabelas.

Hierarquia do BigQuery:

  • Project (e.g., “Marketing Data”): seu container de nível superior.
  • Dataset (e.g., “Email Data”): uma coleção de tabelas dentro de um projeto.
  • Table (e.g., “Klaviyo”): seus dados reais.

No BigQuery Studio, vá para “Classic Explorer” e selecione seu projeto. Clique nas reticências para criar um novo dataset se necessário (defina um nome e localização, e.g., US ou Europe). Navegue até seu dataset e tabela. Em “Schema”, veja a lista de campos e seus tipos. Em “Preview”, veja seus dados reais. Para atualizar dados, volte ao Porter e reenvie—Porter sobrescreve a tabela.

Conecte BigQuery ao Looker Studio:

Acesse Looker Studio. Clique em “Create” e selecione “Report” para iniciar um relatório em branco. Looker Studio pedirá para adicionar uma fonte de dados. Pesquise por “BigQuery” e conecte sua conta Google.

Você verá opções: Recent Projects, My Projects, Shared Projects, Custom Query, Public Datasets.

Selecione “My Projects” e navegue até seu projeto, dataset e tabela. Neste exemplo: Project “Marketing Data” → Dataset “Email Data” → Table “Klaviyo”. Clique em “Add” para conectar.

Uma vez conectado, Looker Studio carrega os campos da sua tabela. Crie um gráfico, adicione suas dimensões (e.g., date) e métricas (e.g., Profile Average Order Value). Certifique-se de definir um intervalo de datas que corresponda à sua query no Porter.

Conexão BigQuery no Looker Studio
Renomeie campos para legibilidade: Nomes de campos do BigQuery usam underscores (e.g., “klaviyo_email_spend”). Para renomeá-los, vá em Resource → Manage added data sources → Actions → Edit. Clique duas vezes em cada nome de campo para alterá-lo (e.g., “klaviyo_email_spend” → “Spend”). Isso torna os campos mais legíveis para usuários finais.

Seus dados do BigQuery agora estão conectados ao Looker Studio.

Templates Klaviyo para BigQuery + Looker Studio

Porter tem a galeria de templates para Looker Studio mais completa para dados de marketing.

Os templates são compatíveis com tabelas BigQuery criadas no Porter.

Nota: Nomes de campos do BigQuery usam underscores em vez de espaços (e.g., “amount_spent” em vez de “Spend”). Você pode precisar mapear campos ao conectar um template.

Templates disponíveis:

Por que Profissionais de Marketing Movem Dados do Klaviyo para BigQuery

  • Conecte qualquer ferramenta de relatórios: BigQuery conecta ao Looker Studio, Power BI, Tableau ou qualquer ferramenta de BI. Um data warehouse, todos os destinos.
  • Atribuição multi-touch: Junte Klaviyo com dados brutos de eventos do GA4. Rastreie o caminho completo do usuário desde o clique no anúncio até a conversão.
  • Fonte da verdade: Defina o que “conversão” significa para sua empresa. Compare Meta vs. GA4 vs. HubSpot. Escolha uma fonte para CAC, ROAS e CPA. Acabe com o debate “qual número está certo”.
  • Acesso para toda a empresa sem permissões de plataforma: Gerenciar permissões entre plataformas é trabalhoso. Com BigQuery, qualquer um pode acessar dados de marketing sem contas ou papéis em cada plataforma. Um modelo de permissão, todos os dados.
  • Disponibilize dados para IA: IA precisa de dados limpos, estruturados e com contexto. Toda ferramenta de IA parece isolada. Integrar fontes é complicado. Com BigQuery como seu data warehouse universal, qualquer ferramenta de IA pode acessar seus dados de marketing. Sem integrações personalizadas. Sem configuração complicada.
  • Combinação de dados: Combine Klaviyo com CRM, GA4, Shopify, Google Ads em um data warehouse. Meça lucro real, não ROAS de plataforma. Calcule CAC combinado em todos os canais.

Próximos Passos

Agora que seus dados do Klaviyo estão no BigQuery:

  • Conecte ao BigQuery: aprenda Google BigQuery para profissionais de marketing e leia tutoriais para conectar outras fontes de dados.
  • Conecte ao Looker Studio: Construa dashboards que carregam em segundos. Use templates Porter ou crie os seus.
  • Conecte ao Google Sheets: Exporte dados do BigQuery para Sheets para análise rápida, compartilhamento com clientes ou cálculos personalizados.
  • Combine dados de múltiplas fontes: Adicione Google Ads, GA4, Shopify, CRM à mesma conexão. Porter auto-mapeia campos equivalentes. Crie relatórios cross-channel sem SQL joins.
  • Crie workflows de IA: Automatize alertas e relatórios com linguagem natural. Exemplo: “Every Monday at 9am, get Klaviyo data for last 7 days, analyze performance with AI, send summary to Slack.”
  • Use templates: Comece com templates pré-construídos para Looker Studio. Performance de campanha, análise criativa, breakdowns de audiência—prontos para conectar.
  • Explore outros destinos: Envie dados do Klaviyo para Google Sheets, PostgreSQL ou outros data warehouses. Mesmo processo de configuração.

Explore todos os templates Klaviyo

Pronto para conectar Klaviyo ao BigQuery?

Comece seu teste gratuito e tenha seus dados de marketing fluindo em minutos.

Agende uma chamada →