HubSpot HubSpot BigQuery Google BigQuery Tutorial

Como Conectar HubSpot ao Google BigQuery

Juan Bello

Juan Bello

Fundador, Porter Metrics

30 jan 2026
15 min de leitura

Para conectar HubSpot ao Google BigQuery:

  1. 1

    Faça login com Google em portermetrics.com.

  2. 2

    Selecione Google BigQuery como destino.

  3. 3

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

  4. 4

    Autorize sua conta HubSpot via OAuth ou Private App.

  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., Analytics sessions) e dimensões (e.g., Account name).

  8. 8

    Opcionalmente, crie campos personalizados (e.g., Cost per MQL, CAC).

  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 HubSpot 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 contatos, uma para empresas, uma para negócios, uma para tickets. 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:

  • Crie um Private App nas configurações do HubSpot.
  • Selecione os escopos necessários: crm.objects.contacts.read, crm.objects.deals.read, etc.
  • Copie o access token para autenticação da API.
  • Limites de taxa: 100 requests/10 segundos (Private App).
  • Construa pipeline ETL personalizado para BigQuery (sem integração nativa).

O que você obtém:

  • Objetos CRM: contatos, empresas, negócios, tickets.
  • Dados de engajamento: emails, chamadas, reuniões.
  • Manutenção manual do pipeline de dados necessária.

Limitações:

  • Sem integração nativa com BigQuery: requer pipeline ETL personalizado.
  • Limites de API variam por plano: Free/Starter mais restritos.
  • Paginação necessária: máximo de 100 registros por request.
  • Limites de propriedades: máximo de propriedades retornadas por objeto varia.

4. Exportação manual CSV ou Google Sheets

Exporte dos Relatórios do HubSpot manualmente. Sem automação.

Como funciona:

Limitações:

  • Sem automação: repita manualmente para cada atualização.
  • Limite de exportação: 1.000.000 linhas por arquivo. Exportações maiores são divididas e entregues como ZIP.
  • Sem atualizações agendadas.
  • Upload manual para BigQuery necessário.

Como Conectar HubSpot 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 HubSpot para o Google BigQuery com Porter. Enviaremos dados de CRM incluindo campos como Total Contacts, Deals Won, Deal Revenue e campos personalizados como Cost per MQL e CAC.

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., “HubSpot Campaign Performance”). Selecione HubSpot como fonte de dados.

Interface de seleção de projetos BigQuery

Conecte suas contas HubSpot

Conecte sua conta HubSpot via OAuth ou Private App. Conceda acesso aos objetos CRM que você precisa (contatos, negócios, empresas). Selecione os portais HubSpot que deseja conectar.

Conectar HubSpot ao Google BigQuery

Acesso completo ao CRM

Acesse contatos, empresas, negócios e objetos personalizados em uma conexão.

Permissões necessárias

Marketing Access ou Super Admin na conta HubSpot.

Suporte a Private App

Conecte via OAuth ou Private App para controle granular de permissões.

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., “CRM_data”) e selecione uma localização (US ou EU).
  3. Crie uma Tabela: dentro do seu dataset, você pode criar uma tabela (e.g., “hubspot_crm”). 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., Account total number of contacts to date, Account total number of deals to date, Analytics conversion rate (%), Analytics bounce rate (%), Analytics CTA clicks.

Selecionar métricas do HubSpot para transferir ao Google BigQuery
+500 Campos Disponíveis: Porter traz a maioria dos objetos e propriedades CRM do HubSpot. Espere exatamente os mesmos dados que você vê no seu portal HubSpot. Veja todos os campos do HubSpot

Escolha dimensões

Para segmentar seus dados, no dropdown de dimensões, pesquise e selecione: e.g., Account name, Analytics page name, Date.

Selecionar dimensões do HubSpot para transferir ao Google BigQuery
  • Outras dimensões: Deal stage, Date, Company owner, Company owner assigned date, Company owner email, Company owner first name, Company owner ID.
  • Objetos CRM: Contacts, Companies, Deals, Tickets e Custom Objects disponíveis.
  • Estágios de pipeline: Deal Stage, Lifecycle Stage e estágios de pipeline personalizados incluídos.
  • Propriedades personalizadas: Todas as propriedades personalizadas de contato, empresa e negócio estão disponíveis como dimensões.

Veja todos os campos do HubSpot

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: Conversion Rate = “Account total number of deals to date / Account total number of contacts to date”, CTA CTR = “Analytics CTA clicks / Analytics CTA views”.

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 analytics source contém ‘Organic Search’, etiquetar como ‘SEO’. Se contém ‘Paid’, etiquetar como ‘Paid’. Se contém ‘Social’, etiquetar como ‘Social’. 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 HubSpot 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 gasto.

  • 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., “CRM_Data”): uma coleção de tabelas dentro de um projeto.
  • Table (e.g., “HubSpot”): 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 “CRM_Data” → Table “HubSpot”. 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., Analytics sessions). 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., “hubspot_crm_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., “hubspot_crm_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 HubSpot 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 HubSpot 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 HubSpot 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 HubSpot 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 HubSpot 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 HubSpot spend 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 HubSpot para Google Sheets, PostgreSQL ou outros data warehouses. Mesmo processo de configuração.

Explore todos os templates HubSpot

Pronto para conectar HubSpot ao BigQuery?

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

Agende uma chamada →