Conecte o HubSpot e o Google BigQuery (BETA)

Aprenda como conectar o HubSpot e o Google BigQuery para sincronizar dados do HubSpot com sua instância do Google BigQuery. 

Conecte o HubSpot e o BigQuery

Para conectar o HubSpot e o Google BigQuery, você deve executar estas etapas em ordem:

1. Instale o Google BigQuery do HubSpot App Marketplace
2. Crie uma função IAM personalizada no Google Cloud Platform
3. Atribuir a função personalizada à conta de serviço do Google
4. Conceda permissões à conta do Google BigQuery gerada pelo HubSpot para modificar tabelas do BigQuery
5. Configuração completa no HubSpot

1. Instale o Google BigQuery do HubSpot App Marketplace

É recomendável que você tenha sua conta do HubSpot e sua conta do Google BigQuery abertas em guias separadas ao conectar os dois aplicativos. 

• Certifique-se de que sua conta HubSpot está optando por esta versão beta: Acesse dados do HubSpot no Google BigQuery. 
• Navegar para este link e selecione sua conta HubSpot. 
• No canto superior direito, clique em Instalar aplicativo.
• Digite seu URI do balde e ID do projeto. 
• Clique em Próximo. 

• Revise e anote as contas do Google Service e do BigQuery, pois você precisará delas na próxima etapa. Em seguida, navegue até o console do Google Cloud para concluir a próxima etapa. 

2. Crie uma função IAM personalizada no Google Cloud Platform

• Faça login no console do Google Cloud. 
• Clique no menu de navegação à esquerda e selecione IAM e Administração > Funções. 
• Na parte superior, clique em Criar função.
• Digite um título, opcional descrição, e EU IA para o papel. 
• Clique Adicionar permissões. 

• Na tabela, selecione as seguintes permissões e clique em Adicionar:

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
Bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list

• Clique em Criar. 

3. Atribuir a função personalizada à conta do Cloud Storage Service

• Clique no menu de navegação à esquerda e selecione Armazenamento em nuvem > Baldes. 
• Selecione um balde para configurar. 
• Clique no Permissões aba.
• No Visualização por diretores aba, clique Conceder acesso. 

• No painel direito, no Novos diretores campo, digite o Conta de serviço do Google nome da Etapa 2.
• No Atribuir funções seção, clique em menu suspenso e selecione Personalizado > <role> onde <role> é a função IAM personalizada criada na Etapa 1. 
• Clique em Salvar. A conta do serviço Google será adicionada ao Visualizador de Objetos de Armazenamento papel. 

4. Conceda permissões à conta do Google BigQuery gerada pelo HubSpot para modificar tabelas do BigQuery

• Clique no menu de navegação à esquerda e selecione IAM e Administração > EU SOU. 
• Clique Conceder acesso.
• No painel direito, no Novos diretores campo, digite o Conta de serviço do Google nome da Etapa 2.
• No Atribuir funções seção, clique em menu suspenso e selecione Personalizado > <role> onde <role> é a função IAM personalizada criada na Etapa 1. 

5. Configuração completa no HubSpot

• Na sua conta HubSpot, clique em Continuar para aplicativos conectados. 

• Na caixa de diálogo, selecione as caixas de seleção e clique em Permitir e instalar. 

Formato de dados para sincronização entre HubSpot e Google BigQuery

Dados disponíveis para sincronização

Você pode sincronizar os seguintes dados do HubSpot com o Google BigQuery: 

• Objetos: objetos padrão e personalizados, como contatos, empresas, tickets ou produtos.
• Registros: registros de objetos individuais. 
• Associações: todos os tipos de associação e registros associados.
• Eventos: dados de eventos para eventos padrão do HubSpot e eventos comportamentais personalizados. 
• Listas: Listas de contatos e empresas do HubSpot.
• Proprietários: detentores de recordes. 
• Tubulações: pipelines de negócios e tickets e estágios do pipeline. 
• Propriedades: propriedades e seus valores nos registros de objetos, incluindo o histórico de propriedades. 

Dados de objetos de diferentes tipos são organizados e disponíveis de duas maneiras:

• Individual: eCada tipo de objeto é armazenado em sua própria tabela e possui apenas registros do mesmo tipo de objeto. Por exemplo, objects_contacts contém apenas registros de contato.
• Combinado: aTodos os registros de todos os tipos de objetos são combinados em um único objeto de banco de dados. Portanto, ao consultar, você precisa especificar um filtro como “WHERE objectTypeId='0-1'

Objetos personalizados será atribuído um ID no momento da criação e será identificado como 2-ID_único. Por exemplo, 2-12345. 

tabelas objects_x

Cada tipo de objeto disponível, incluindo objetos personalizados, tem sua própria tabela específica. Essas tabelas são nomeadas seguindo o formato OBJECTS_<object type name> onde <object type name> é o plural do rótulo objecttype. (Observe que se o tipo de objeto não tiver forma plural, então <object type name> será o rótulo de forma singular do nome do tipo de objeto concatenado com “S”).

Abaixo está uma lista completa dos tipos de objetos do HubSpot disponíveis, uma breve descrição dos dados que eles representam e suas tabelas correspondentes.

object_with_object_properties

Esta tabela contém dados dos seus registros do HubSpot. Você pode obter uma linha para cada registro dentro de um objecttype (por exemplo, todos os registros de contato no objecttype contacts). 

object_properties_history

Esta tabela contém valores históricos de propriedades. Para contatos, contém os 45 valores mais recentes. Para todos os outros objetos, ele contém os 20 valores mais recentes. A tabela tem uma linha para cada valor histórico da propriedade. O valor atual de uma propriedade é determinado pelo registro de data e hora UPDATEDAT mais recente no histórico da propriedade.

Consultas de associação

Assim como os dados de objetos, os dados de associações são organizados de duas maneiras:

• Individual: cada tipo de associação é armazenado em sua própria tabela e contém apenas registros desse tipo. Por exemplo, associations_contacts_to_deals contém apenas registros de associação entre objetos de contato e negócio. E
• Combinado: todos os registros para todos os tipos de associação são combinados em uma tabela.

associações_x_para_y 

Cada tipo de associação tem sua própria visão, rotulada como associations_<association type name> por exemplo associations_contacts_to_deals. 

association_definitions

Esta tabela contém informações sobre todos os tipos de associação disponíveis entre objetos do HubSpot, com uma linha por tipo de associação.

property_definitions

Esta tabela contém informações sobre propriedades do objeto e propriedades de eventos na sua conta HubSpot. As propriedades do evento incluem eventos padrão, como aberturas e cliques de e-mail, e evento comportamental personalizado propriedades. Essas informações podem ser úteis para definir valores encontrados em propriedades_do_objeto e eventos dados.

Eventos

Os eventos incluem eventos padrão do HubSpot e eventos comportamentais personalizados. Cada evento tem sua própria tabela, rotulada como events_eventname.

object_and_event_type_definitions

Esta tabela contém definições para todos os objetos e eventos disponíveis na sua conta HubSpot.

Frequência de sincronização e organização de dados

Sincronização de dados diário entre HubSpot e Google BigQuery às 09:00 UTC +0. Uma pasta será criada para cada dia em que os dados forem sincronizados, com diversas subpastas para cada tabela. As últimas sete sincronizações estarão disponíveis na plataforma Google Cloud e as tabelas no BigQuery serão atualizadas para apontar para o último despejo de bucket.

Cada uma das tabelas a seguir estará disponível como uma pasta com arquivos CSV compactados:

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS