Conectar HubSpot y Google BigQuery

Aprende a conectar HubSpot y Google BigQuery para sincronizar los datos de HubSpot con tu instancia de Google BigQuery. 

Nota: HubSpot no comparte datos HIPAA con Google BigQuery.

Conectar HubSpot y BigQuery

Para conectar HubSpot y Google BigQuery, debes seguir estos pasos en orden:

1. Instala Google BigQuery desde el mercado de aplicaciones de HubSpot
2. Crea un rol IAM personalizado en Google Cloud Platform
3. Asigna el rol personalizado a la cuenta de servicio de Google
4. Concede a la cuenta de Google BigQuery generada por HubSpot permisos para modificar las tablas de BigQuery
5. Termina la configuración en HubSpot

1. Instalar Google BigQuery desde el mercado de aplicaciones de HubSpot App

Se recomienda que tengas tu cuenta de HubSpot y tu cuenta de Google BigQuery abiertas en pestañas separadas cuando conectes las dos aplicaciones. 

1. Asegúrate de que tu cuenta de HubSpot está incluida en esta beta: Accede a los datos de HubSpot en Google BigQuery. 
2. Navega hasta este enlace y selecciona tu cuenta de HubSpot. 
3. En la parte superior derecha, haz clic en Instalar aplicación.
4. Introduce el URI del registro provisional y el ID del proyecto. 
5. Haz clic en Siguiente. 

6. Revisa y toma nota de las cuentas de Google Service y BigQuery ya que las necesitarás en el siguiente paso. A continuación, accede a tu consola de Google Cloud para completar el siguiente paso. 

2. Crear un rol IAM personalizado en Google Cloud Platform

1. Accede a tu consola de Google Cloud. 
2. Haz clic en el menú de navegación de la izquierda y selecciona IAM y administración > Roles. 
3. En la parte superior, haz clic en Crear rol.
4. Introduce un título, descripción opcional , y ID para el rol. 
5. Haz clic en Agregar permisos. 

6. En la tabla, seleccione los siguientes permisos y haz clic en Agregar:

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

7. Haz clic en Crear. 

3. Conceder permisos a la cuenta de servicio de Google para acceder a los buckets de Cloud Storage

1. Haz clic en el menú de navegación de la izquierda y selecciona Cloud Storage > Buckets. 
2. Selecciona un bucket para configurarlo. 
3. Haz clic en la pestaña Permisos.
4. En la pestaña Ver por principales, haz clic en Otorgar acceso. 

5. En el panel derecho, en el campo Principales nuevas, introduce el nombre de la cuenta de servicio de Google del paso 1.

Nota: asegúrate de asignar la cuenta de servicio de Google, no la cuenta de BigQuery.

6. En la sección Asignar roles, haz clic en el menú desplegable y selecciona Personalizado > <role> donde <role> es el rol IAM personalizado creado en el Paso 2. 
7. Haz clic en Guardar. La cuenta de servicio de Google se agregará al rol Storage Object Viewer. 

4. Otorgar permisos a la cuenta de Google BigQuery generada por HubSpot para modificar las tablas de BigQuery

1. Haz clic en el menú de navegación de la izquierda y selecciona IAM y administración > IAM. 
2. Haz clic en Otorgar acceso.
3. En el panel derecho, en el campo Principales nuevas, introduce la cuenta de Google BigQuery generada por HubSpot en el Paso 1.
4. En la sección Asignar roles, haz clic en el menú desplegable y selecciona Personalizado > <role> donde <role> es el rol IAM personalizado creado en el Paso 2. 

5. Terminar la configuración en HubSpot

1. En tu cuenta de HubSpot, haz clic en Continuar a aplicaciones conectadas. 

2. En el cuadro de diálogo, selecciona las casillas de verificación y, a continuación, haz clic en Permitir e instalar. 

Formato de datos para la sincronización entre HubSpot y Google BigQuery

Datos disponibles para la sincronización

Puedes sincronizar los siguientes datos desde HubSpot a Google BigQuery: 

• Objetos: objetos estándar y personalizados, como contactos, empresas, tickets o productos.
• Registros: registros de objetos individuales. 
• Asociaciones: todos los tipos de asociaciones y registros asociados.
• Eventos: datos de eventos tanto para eventos estándar de HubSpot como para eventos de comportamiento personalizados. 
• Listas: listas de contactos y empresas de HubSpot.
• Propietarios: propietarios de registros. 
• Pipelines: pipelines de negocios y tickets y etapas de pipelines. 
• Propiedades: propiedades y sus valores en los registros de objetos, incluido el historial de propiedades. 

Los datos de los objetos de diferentes tipos están organizados y disponibles de dos maneras:

• Individual: cada tipo de objeto se almacena en su propia tabla y solo tiene registros del mismo tipo de objeto. Por ejemplo objects_contacts solo contiene registros de contactos.
• Combinado: todos los registros de todos los tipos de objeto se combinan en un objeto de base de datos. Por lo tanto, al consultar, tienes que especificar un filtro como "WHERE objectTypeId='0-1'

A los objetos personalizados se les asignará un ID en el momento de su creación, y se identificarán como 2-unique_ID. Por ejemplo, 2-12345. 

objects_x tables

Cada tipo de objeto disponible, incluidos los objetos personalizados, tiene su propia tabla específica. Estas tablas se denominan siguiendo el formato OBJECTS_<object type name> donde <object type name> es la etiqueta de la forma plural del objecttype. (Ten en cuenta que si el tipo de objeto no tiene forma plural, entonces <object type name> será la etiqueta de forma singular del nombre del tipo de objeto concatenada con "S").

A continuación se muestra una lista completa de los tipos de objetos de HubSpot disponibles, una breve descripción de los datos que representan y sus tablas correspondientes.

object_with_object_properties

Esta tabla contiene datos de tus registros de HubSpot. Puedes obtener una fila por cada registro dentro de un objecttype (por ejemplo, todos los registros de contactos en el objecttype contactos). 

object_properties_history

Esta tabla contiene valores históricos de la propiedad. Para los contactos, contiene los 45 valores más recientes. Para todos los demás objetos, contiene los 20 valores más recientes. La tabla tiene una fila para cada valor histórico de la propiedad. El valor actual de una propiedad está determinado por la marca de tiempo UPDATEDAT más reciente en el historial de la propiedad.

Consultas sobre asociación

Al igual que los datos de los objetos, los datos de las asociaciones se organizan de dos maneras:

• Individual: cada tipo de asociación se almacena en su propia tabla y solo contiene registros de ese tipo. Por ejemplo, associations_contacts_to_deals solo contiene registros de asociación entre objetos de contacto y negocio. T
• Combinado: todos los registros de todos los tipos de asociación se combinan en una sola tabla.

associations_x_to_y 

Cada tipo de asociación tiene su propia vista, etiquetada como associations_<association type name> por ejemplo associations_contacts_to_deals. 

association_definitions

Esta tabla contiene información sobre todos los tipos de asociación disponibles entre los objetos de HubSpot, con una fila por tipo de asociación.

property_definitions

Esta tabla contiene información sobre propiedades de objetos y propiedades de eventos en tu cuenta de HubSpot. Las propiedades de los eventos incluyen eventos estándar, como aperturas y clics de correos electrónicos, y propiedades de eventos personalizados de comportamiento. Esta información puede ser útil para definir los valores que se encuentran en los datos de object_properties y events.

Eventos

Los eventos incluyen eventos estándar de HubSpot y eventos de comportamiento personalizados. Cada evento tiene su propia tabla, etiquetada como events_eventname.

object_and_event_type_definitions

Esta tabla contiene definiciones para todos los objetos y eventos disponibles en tu cuenta de HubSpot.

Frecuencia de sincronización y organización de datos

La sincronización de datos comienza diariamente entre HubSpot y Google BigQuery a las 06:00 (UTC+0). Se creará una carpeta para cada día en que se sincronicen los datos, con varias subcarpetas para cada tabla. Las últimas siete sincronizaciones estarán disponibles en la plataforma de Google Cloud y las tablas en BigQuery se actualizan para señalar al último bucket.

Cada uno de las tablas siguientes estará disponible como archivo en formato Parquet:

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