Conectar HubSpot y Google BigQuery (BETA)

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

Conectar HubSpot y BigQuery

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

1. Instala Google BigQuery desde HubSpot App Marketplace
2. Crear una función IAM personalizada en Google Cloud Platform
3. Asignar la función personalizada a la cuenta de servicio de Google
4. Conceder a la cuenta de Google BigQuery generada por HubSpot permisos para modificar las tablas de BigQuery
5. Configuración completa en HubSpot

1 1. Instala Google BigQuery desde HubSpot App Marketplace

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

• Asegúrate de que tu cuenta de HubSpot está habilitada para esta beta: Accede a los datos de HubSpot en Google BigQuery. 
• Navega a este enlace y selecciona tu cuenta de HubSpot. 
• En la parte superior derecha, haz clic en Instalar aplicación.
• Introduzca el URI del cubo  y el ID del proyecto . 
• Haz clic en Siguiente. 

• 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 una función IAM personalizada en Google Cloud Platform

• Accede a tu consola de Google Cloud. 
• Haga clic en el menú de navegación de la izquierda y seleccione IAM & Admin > Roles. 
• En la parte superior, haga clic en Crear función.
• Introduzca un título, opcional descripción, y ID para el rol. 
• Haga clic en Añadir permisos. 

• En la tabla, seleccione los siguientes permisos y haga clic en Añadir:

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

• Haz clic en Crear. 

3. Asignar el rol personalizado a la cuenta de Cloud Storage Service

• Haga clic en el menú de navegación de la izquierda y seleccione Cloud Storage > Buckets. 
• Seleccione un cubo  para configurarlo. 
• Haga clic en la pestaña Permisos.
• En la pestaña View by principals, haga clic en Grant access. 

• En el panel derecho, en el campo New principals, introduzca el nombre Google Service Account del paso 2.
• En la sección Asignar roles, haga clic en el menú desplegable y seleccione Personalizado > <role> donde <role> es el rol IAM personalizado creado en el Paso 1. 
• Haz clic en Guardar. La cuenta de Google Service se añadirá a la función Visor de objetos de almacenamiento . 

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

• Haga clic en el menú de navegación de la izquierda y seleccione IAM & Admin > IAM. 
• Haga clic en Conceder acceso.
• En el panel derecho, en el campo New principals, introduzca el nombre Google Service Account del paso 2.
• En la sección Asignar roles, haga clic en el menú desplegable y seleccione Personalizado > <role> donde <role> es el rol IAM personalizado creado en el Paso 1. 

5. Configuración completa en HubSpot

• En tu cuenta de HubSpot, haz clic en Continuar a Connected Apps. 

• En el cuadro de diálogo, seleccione las casillas de verificación y, a continuación, haga 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 registrados. 
• Pipelines: pipelines de transacciones 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: eada tipo de objeto se almacena en su propia tabla y sólo tiene registros del mismo tipo de objeto. Por ejemplo, objects_contacts sólo contiene registros de contactos.
• Combinado: atodos los registros de todos los tipos de objeto se combinan en un objeto de base de datos. Por lo tanto, al realizar la consulta, es necesario 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. 

objetos_x tablas

Cada tipo de objeto disponible, incluidos los objetos personalizados, tiene su propia tabla específica. Estas tablas se nombran siguiendo el formato OBJECTS_<object type name> donde <object type name> es la etiqueta de la forma plural del objecttype. (Tenga en cuenta que si el tipo de objeto no tiene forma plural, entonces <object type name> será la etiqueta de la 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. Puede obtener una fila por cada registro dentro de un tipo de objeto (por ejemplo, todos los registros de contactos en el tipo de objeto 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 propiedad. El valor actual de una propiedad viene determinado por la marca de tiempo UPDATEDAT más reciente del historial de la propiedad.

Consultas sobre asociaciones

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 sólo contiene registros de ese tipo. Por ejemplo, associations_contacts_to_deals sólo contiene registros de asociación entre objetos de contacto y operaciones. T
• Combinado: todos los registros de todos los tipos de asociación se combinan en una sola tabla.

asociaciones_x_a_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 objetos 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 eventos incluyen eventos estándar, como aperturas y clics de correos electrónicos, y propiedades de eventos de comportamiento personalizados de . Esta información puede ser útil para definir los valores que se encuentran en object_properties y events data.

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

Los datos se sincronizan diariamente entre HubSpot y Google BigQuery a las 0900 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 Google Cloud y las tablas en BigQuery se actualizan para apuntar al último volcado de cubo.

Cada una de las siguientes tablas estará disponible como una carpeta con archivos CSV comprimidos con gzip:

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