BetaConectar o HubSpot ao Google BigQuery

Sincronize dados do Google BigQuery com objetos do CRM da HubSpot, como contatos, empresas, negócios, associações e outros dados da sua conta.

As seções abaixo mostram como autorizar o aplicativo Google BigQuery e, em seguida, definir as configurações de sincronização entre sua conta do Google Cloud e o HubSpot.

Conecte e configure a integração do Google BigQuery

Para conectar sua conta do Google BigQuery ao HubSpot:

1. Na sua conta HubSpot, clique no ícone do Marketplace na barra de navegação superior e selecione HubSpot Marketplace.
2. Clique na barra de pesquisa e insira o Google BigQuery.
3. Clique em Google BigQuery na página de listagem.
4. Clique emInstalar.
5. Clique em Continuar configuração.

Você será redirecionado para a ferramenta de integração de dados , onde um painel lateral o guiará pela sincronização de dados entre suas contas do HubSpot e do BigQuery, com base nas instruções que deseja sincronizar:

• Google BigQuery → HubSpot: configure a sincronização do BigQuery para o HubSpot.
• HubSpot → Google BigQuery: configure a sincronização do HubSpot para o BigQuery.

Sincronize dados do Google BigQuery com sua conta da HubSpot

Para enviar dados do Google BigQuery para o HubSpot, adicione e configure um novo usuário com as funções necessárias na sua conta do BigQuery:

1. No painel direito, selecione Google BigQuery → HubSpot.
2. Copie o e-mail da conta de serviço do Google gerado pelo HubSpot.

3. Na sua conta do Google Cloud, acesse as configurações do IAM do projeto, crie um novo usuário com o e-mail da conta de serviço que você copiou do HubSpot e adicione as funções Visualizador de dados do BigQuery e Usuário do trabalho do BigQuery para o usuário recém-criado.

4. Copie o ID do projeto da sua conta do Google Cloud.
5. De volta ao HubSpot, cole o ID do projeto e clique em Testar conexão.
6. Depois que a conexão for verificada, clique em Próximo para concluir a configuração.

Sincronizar dados do HubSpot com sua conta do Google BigQuery

Para enviar dados do HubSpot para o Google BigQuery, você configurará um usuário com as permissões necessárias na sua conta do Google Cloud, além de especificar o projeto do GCP associado e o URI do bucket do GCS.

Observação: você precisará de acesso de administrador do Google Cloud ao projeto do GCP, no qual o conjunto de dados do BigQuery estará, e a um bucket do Google Cloud Storage (GCS), no qual o HubSpot preparará os arquivos do Parquet.

1. No painel direito, selecione HubSpot → Google BigQuery.
2. Copie o e-mail da conta de serviço do Google gerado pelo HubSpot.

3. Na sua conta do Google Cloud, acesse as configurações do IAM do projeto, crie um novo usuário com o e-mail da conta de serviço que você copiou do HubSpot e adicione o Visualizador de dados do BigQuery, o usuário de trabalho do BigQuery e as funções de objeto proprietário de armazenamento para o usuário recém-criado.
   

4. Copie o ID do projeto da sua conta do Google Cloud.
5. De volta ao HubSpot, cole o ID do projeto.
6. Adicione o URI do bucket do Google Cloud Storage (GCS):
   • O URI do bucket do GCS deve seguir a estrutura:gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • As tabelas externas do BigQuery são criadas em um conjunto de dados dedicado no projeto do GCP e seguem o formato:hubspot_data_set_{hubId}
   • Os dados serão gravados no bucket do GCS e as tabelas associadas farão referência a arquivos parquet no GCS.
   • Saiba mais sobre como criar buckets do GCS na documentação do Google.
7. Clique em Testar conexão.
8. Quando a conexão for verificada, clique em Próximo.
9. Marque as caixas de seleção ao lado das fontes de dados que deseja sincronizar (por exemplo, Contatos, Associações, Eventos etc.).
10. Configure a frequência de sincronização e a programação.
11. Clique em Iniciar sincronização.

Monitore a sincronização

Depois de configurar a sincronização entre suas contas, você poderá revisar o status e o histórico de sincronização na página de detalhes da sincronização:

1. Em sua conta HubSpot, acesse Gerenciamento de dados > Integração de dados.
2. Em Monitorar suas sincronizações de importações &, clique na guia Sincronizações de aplicativos .
3. Clique na barra de pesquisa e procure pelo Google BigQuery.
4. Clique em Google BigQuery. Observe que várias entradas podem aparecer se você tiver configurado a sincronização em ambas as direções.
5. Na página de detalhes da sincronização, você pode gerenciar e revisar suas configurações e histórico de sincronização:
   • Para arquivar ou editar detalhes de sincronização, no canto superior direito, clique em Ações e selecione a opção correspondente.
   • Para gatilho imediatamente uma sincronização, no canto superior direito, clique em Sincronizar agora.
   • Os registros, as associações e os erros sincronizados estão resumidos na parte superior da página.
   • A atividade de sincronização recente aparecerá na tabela. Clique na guia Histórico de sincronização para revisar tentativas e conclusões de sincronização específicas. Você pode filtrar por intervalos de datas específicos ou por um status de sincronização.

Status de sincronização e tratamento de erros

A tabela abaixo descreve os possíveis status de sincronização:

Se uma sincronização falhar:

• Um status de Falha será exibido na página de detalhes da sincronização, juntamente com informações sobre quais tabelas foram sincronizadas com sucesso ou falhar.
• Nenhum dado é parcialmente gravado em caso de falha: as tabelas do BigQuery só são atualizadas na conclusão bem-sucedida de uma sincronização.
• A próxima sincronização programada tentará automaticamente uma nova sincronização completa.
• Você pode gatilho uma ressincronização manualmente a qualquer momento na página de detalhes da sincronização.

Lista de permissões de rede

A sincronização de dados do HubSpot com provedores de terceiros, como o BigQuery, é roteada por meio de IPs de proxy da HubSpot. Esses intervalos de IP são usados por outras integrações do HubSpot, como sincronização de dados e webhooks.

Se sua organização restringe o acesso de entrada aos seus recursos do GCP, você deve colocar na lista de permissões os seguintes intervalos CIDR com base no hublet do HubSpot:

Saiba como descobrir onde os dados da sua conta da HubSpot estão hospedados.

Limitações do beta

Lembre-se das seguintes limitações durante esta versão beta:

• Frequência de sincronização: apenas um conjunto limitado de frequências de sincronização está disponível, incluindo uma vez, a cada 6 horas, a cada 12 horas, diariamente, semanalmente e mensalmente. Você pode gatilho manualmente uma ressincronização na página de detalhes da sincronização no HubSpot a qualquer momento.
• Uma exportação por tipo de dados: cada tipo de objeto, tipo de evento ou par de associação só pode ser exportado em uma configuração de sincronização por conta da HubSpot.
  
  • Por exemplo, se os contatos já estiverem sendo exportados para um destino do BigQuery, eles não poderão ser adicionados a uma segunda configuração até que o destino original seja arquivado.
  • Isso evita pipelines de dados duplicados e garante uma única fonte confiável por tipo de dados em seu armazém de dados.
• Suporte limitado a dados confidenciais: você pode armazenar e sincronizar dados confidenciais com sua conta da HubSpot, mas não pode sincronizar dados confidenciais com sua conta do BigQuery.
• Sem suporte para object_x_views: o object_x_views objeto não é compatível com a sincronização com o BigQuery. Use object_with_object_propertiesou associe-se objects a para object_properties obter visualizações equivalentes por registro.

Próximas etapas

Depois de conectar a integração do BigQuery e definir as configurações de sincronização, saiba mais sobre o esquema das tabelas sincronizadas no BigQuery.