BetaConectar HubSpot a Google BigQuery

Sincroniza datos de Google BigQuery con objetos de CRM de HubSpot, como contactos, empresas, negocios, asociaciones y otros datos de tu cuenta.

En las secciones siguientes se explica cómo autorizar la aplicación Google BigQuery y, a continuación, configurar los ajustes de sincronización entre tu cuenta de Google Cloud y HubSpot.

Conectar y configurar la integración de Google BigQuery

Para conectar tu cuenta de Google BigQuery a HubSpot:

1. En tu cuenta de HubSpot, haz clic en el icono Mercado en la barra de navegación superior, y luego selecciona Mercado de HubSpot.
2. Haz clic en la barra de búsqueda e introduce Google BigQuery.
3. Haz clic en Google BigQuery en la página del listado.
4. Haz clic en Instalar.
5. Haga clic en Continuar configuración.

Se te redireccionará a la herramienta de integración de datos , donde un panel lateral te guiará a través de la sincronización de datos entre tus cuentas de HubSpot y BigQuery, en función de las direcciones que desees sincronizar:

• Google BigQuery → HubSpot: configurar la sincronización de BigQuery con HubSpot.
• HubSpot → Google BigQuery: configurar la sincronización de HubSpot con BigQuery.

Sincroniza los datos de Google BigQuery con tu cuenta de HubSpot

Para enviar datos de Google BigQuery a HubSpot, añade y configura un nuevo usuario con los roles requeridos en tu cuenta de BigQuery:

1. En el panel derecho, seleccione Google BigQuery → HubSpot.
2. Copia el correo electrónico de la cuenta de servicio de Google que genera HubSpot.

3. En su cuenta de Google Cloud, vaya a la configuración de IAM de su proyecto, cree un nuevo usuario con el correo electrónico de la cuenta de servicio que copió de HubSpot y, a continuación, añada los roles Visor de datos de BigQuery y Usuario de trabajos de BigQuery para el usuario recién creado.

4. Copie el ID del proyecto de su cuenta de Google Cloud.
5. De vuelta en HubSpot, pega el ID del proyecto y haz clic en Probar conexión.
6. Una vez verificada la conexión, haga clic en Siguiente para completar la configuración.

Sincroniza los datos de HubSpot con tu cuenta de Google BigQuery

Para enviar datos de HubSpot a Google BigQuery, deberás configurar un usuario con los permisos necesarios en tu cuenta de Google Cloud, además de especificar el proyecto de GCP asociado y el URI del bucket de GCS.

Nota: necesitarás acceso de administrador de Google Cloud al proyecto GCP donde se almacenará el conjunto de datos de BigQuery, y un bucket de Google Cloud Storage (GCS) donde HubSpot almacenará los archivos Parquet.

1. En el panel derecho, seleccione HubSpot → Google BigQuery.
2. Copia el correo electrónico de la cuenta de servicio de Google que genera HubSpot.

3. En su cuenta de Google Cloud, vaya a la configuración de IAM de su proyecto, cree un nuevo usuario con el correo electrónico de la cuenta de servicio que copió de HubSpot y, a continuación, añada las funciones Visor de datos de BigQuery, Usuario de trabajo de BigQuery y Propietario de objeto de almacenamiento para el usuario recién creado.
   

4. Copie el ID del proyecto de su cuenta de Google Cloud.
5. De vuelta en HubSpot, pega el ID del proyecto.
6. Añade tu URI de bucket de Google Cloud Storage (GCS):
   • El URI para el cubo GCS debe seguir la estructura: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Las tablas externas de BigQuery se crean en un conjunto de datos dedicado en el proyecto GCP y siguen el formato: hubspot_data_set_{hubId}
   • Los datos se escribirán en el bucket GCS, y las tablas asociadas harán referencia a archivos parquet en GCS.
   • Para obtener más información sobre la creación de buckets GCS, consulta la documentación de Google.
7. Haga clic en Probar conexión.
8. Una vez verificada la conexión, haga clic en Siguiente.
9. Selecciona las casillas de verificación situadas junto a las fuentes de datos que deseas sincronizar (por ejemplo, Contactos, Asociaciones, Eventos, etc.).
10. Configura la frecuencia y el horario de sincronización.
11. Haz clic en Iniciar sincronización.

Sincronización de monitores

Después de configurar la sincronización entre tus cuentas, puedes revisar el estado y el historial de la sincronización desde la página de detalles de la sincronización:

1. En tu cuenta de HubSpot, ve a Gestión de datos > Integración de datos.
2. En Supervisa tus importaciones & syncs, haz clic en la pestaña App syncs .
3. Haga clic en la barra de búsqueda y busque Google BigQuery.
4. Haga clic en Google BigQuery. Tenga en cuenta que pueden aparecer varias entradas si ha configurado la sincronización en ambas direcciones.
5. En la página de detalles de sincronización, puedes gestionar y revisar la configuración y el historial de sincronización:
   • Para archivar o editar los detalles de la sincronización, en la parte superior derecha, haga clic en Acciones y, a continuación, seleccione la opción correspondiente.
   • Para desencadenar inmediatamente una sincronización, en la parte superior derecha, haz clic en Sincronizar ahora.
   • Los registros sincronizados, las asociaciones y los errores se resumen en la parte superior de la página.
   • La actividad de sincronización reciente aparecerá en la tabla. Haz clic en la pestaña Historial de sincronización para revisar los intentos y las finalizaciones de sincronización específicos. Puede filtrar por intervalos de fechas específicos o por un estado de sincronización.

Estados de sincronización y gestión de errores

La siguiente tabla muestra los posibles estados de sincronización:

Si falla una sincronización:

• Aparecerá el estado Fallido en la página de detalles de la sincronización, junto con información sobre las tablas que se han sincronizado correctamente o no.
• No se escriben datos parcialmente en caso de fallo: Las tablas de BigQuery sólo se actualizan al finalizar correctamente una sincronización.
• La próxima sincronización programada volverá a intentar automáticamente una sincronización completa.
• Puedes desencadenar una resincronización manualmente en cualquier momento desde la página de detalles de la sincronización.

Lista de redes autorizadas

La sincronización de datos de HubSpot con proveedores externos como BigQuery se enruta a través de las IP proxy de HubSpot. Estos rangos de IP son utilizados por otras integraciones de HubSpot, como la sincronización de datos y webhooks.

Si su organización restringe el acceso entrante a sus recursos GCP, debe permitir los siguientes rangos CIDR basados en su hublet HubSpot:

Aprende a averiguar dónde están alojados los datos de tu cuenta de HubSpot .

Limitaciones beta

Tenga en cuenta las siguientes limitaciones durante esta beta:

• Frecuencia de sincronización: sólo hay disponible un conjunto limitado de frecuencias de sincronización, entre las que se incluyen una vez, cada 6 horas, cada 12 horas, diaria, semanal y mensual. Puedes desencadenar manualmente una resincronización desde la página de detalles de sincronización en HubSpot en cualquier momento.
• Una exportación por tipo de datos: cada tipo de objeto, tipo de evento o par de asociación sólo se puede exportar en una configuración de sincronización por cuenta de HubSpot.
  
  • Por ejemplo, si ya se están exportando contactos a un destino de BigQuery, no se podrán añadir a una segunda configuración hasta que se archive el destino original.
  • Esto evita la duplicación de pipelines de datos y garantiza una única fuente de referencia por tipo de datos en su almacén de datos.
• Compatibilidad limitada con datos sensibles: puedes almacenar y sincronizar datos sensibles con tu cuenta de HubSpot, pero no puedes sincronizar datos sensibles con tu cuenta de BigQuery.
• No se admite object_x_views: el objeto object_x_views no se admite actualmente para la sincronización con BigQuery. Utilice object_with_object_propertieso unir objects con object_properties para obtener vistas equivalentes por registro.

Pasos siguientes

Una vez que hayas conectado la integración con BigQuery y configurado los ajustes de sincronización, obtén información sobre el esquema de las tablas sincronizadas en BigQuery.