Doorgaan naar artikel
Let op: De Nederlandse vertaling van dit artikel is alleen bedoeld voor het gemak. De vertaling wordt automatisch gemaakt via een vertaalsoftware en is mogelijk niet proefgelezen. Daarom moet de Engelse versie van dit artikel worden beschouwd als de meest recente versie met de meest recente informatie. U kunt het hier raadplegen.

HubSpot en Google BigQuery verbinden (BETA)

Laatst bijgewerkt: februari 6, 2025

Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:

Operations Hub   Enterprise

Leer hoe je HubSpot en Google BigQuery met elkaar verbindt om HubSpot gegevens te synchroniseren met je Google BigQuery instance.

HubSpot en BigQuery verbinden

Om HubSpot en Google BigQuery te koppelen, moet je deze stappen in volgorde doorlopen:

  1. Installeer Google BigQuery vanaf de HubSpot App-marktplaats
  2. Maak een aangepaste IAM-rol aan in Google Cloud Platform
  3. Wijs de aangepaste rol toe aan het Google Service Account
  4. Geef het door HubSpot gegenereerde Google BigQuery account rechten om BigQuery tabellen te wijzigen
  5. Voltooi de installatie in HubSpot

1. Installeer Google BigQuery vanaf de HubSpot App-marktplaats

Het is aan te raden om je HubSpot account en Google BigQuery account in aparte tabbladen te openen wanneer je de twee apps met elkaar verbindt.

  • Zorg ervoor dat je HubSpot account is aangemeld voor deze bèta: Krijg toegang tot HubSpot gegevens in Google BigQuery.
  • Navigeer naar deze link en selecteer je HubSpot account.
  • Klik rechtsboven op Install app.
  • Voer je Bucket URI en Project ID in.
  • Klik op Volgende.

connect-hubspot-bigquery

  • Controleer en noteer de Google Service- en BigQuery-accounts omdat u deze in de volgende stap nodig hebt. Navigeer vervolgens naar je Google Cloud console om de volgende stap te voltooien.

google-service-account

2. Een aangepaste IAM-rol aanmaken in Google Cloud Platform

  • Log in op uw Google Cloud-console.
  • Klik op het linker navigatiemenu en selecteer IAM & Beheer > Rollen.
  • Klik bovenaan op Rol aanmaken.
  • Voer een titel, optionele beschrijving en ID voor de rol in.
  • Klik op Machtigingen toevoegen.

create-iam-role

  • Selecteer in de tabel de volgende rechten en klik op Toevoegen:

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

  • Klik op Maken.

3. De aangepaste rol toewijzen aan de Cloud Storage Service-account

  • Klik op het linker navigatiemenu en selecteer Cloud Storage > Buckets.
  • Selecteer een bucket om te configureren.
  • Klik op het tabblad Machtigingen.
  • Klik op het tabblad Bekijken op opdrachtgevers op Toegang verlenen.

bigquery-bucket-permissions

  • Voer in het rechterpaneel in het veld New principals de naam in van de Google Service Account uit stap 1.
  • Klik in het gedeelte Rollen toewijzen op het vervolgkeuzemenu en selecteer Aangepast > <rol> waarbij <rol> de aangepaste IAM-rol is die in stap 2 is gemaakt.
  • Klik op Opslaan. De Google Service-account wordt toegevoegd aan de rol Storage Object Viewer .

4. Geef het door HubSpot gegenereerde Google BigQuery Account rechten om BigQuery tabellen te wijzigen

  • Klik op het linker navigatiemenu en selecteer IAM & Beheer > IAM.
  • Klik op Toegang verlenen.
  • Voer in het rechterpaneel in het veld Nieuwe opdrachtgevers het door HubSpot gegenereerde Google BigQuery-account uit stap 1 in.
  • Klik in het gedeelte Rollen toewijzen op het vervolgkeuzemenu en selecteer Aangepast > <rol>, waarbij <rol> de aangepaste IAM-rol is die in stap 2 is gemaakt.

5. Volledige installatie in HubSpot

  • Klik in je HubSpot account op Doorgaan naar Aangesloten Apps.

google-service-account

  • Schakel de selectievakjes in het dialoogvenster in en klik vervolgens op Toestaan en installeren.

Gegevensindeling voor synchronisatie tussen HubSpot en Google BigQuery

Beschikbare gegevens voor synchronisatie

Je kunt de volgende gegevens synchroniseren van HubSpot naar Google BigQuery:

  • Objecten: standaard en aangepaste objecten, zoals contactpersonen, bedrijven, tickets of producten.
  • Records: individuele records van objecten.
  • Associaties: alle associatietypen en bijbehorende records.
  • Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot gebeurtenissen als aangepaste gedragsgebeurtenissen.
  • Lijsten: HubSpot lijsten met contactpersonen en bedrijven.
  • Owners: verantwoordelijke records.
  • Pijplijnen: deal en ticket pijplijnen en pijplijn fases.
  • Eigenschappen: eigenschappen en hun waarden op de records van het object, inclusief de geschiedenis van de eigenschappen.

Objectgegevens van verschillende typen zijn op twee manieren georganiseerd en beschikbaar:

  • Individueel: elk objecttype wordt opgeslagen in zijn eigen tabel en bevat alleen records van hetzelfde objecttype. Bijvoorbeeld, objects_contacts bevat alleen contactpersoonrecords.
  • Gecombineerd: allerecords van alle objecttypen worden gecombineerd in één databaseobject. Wanneer je dus een query uitvoert, moet je een filter specificeren zoals "WHERE objectTypeId='0-1'"

Aangepast objecten krijgen een ID toegewezen bij het aanmaken en worden geïdentificeerd als 2-unique_ID. Bijvoorbeeld 2-12345.

objecten_x tabellen

Elk beschikbaar objecttype, inclusief aangepaste objecten, heeft zijn eigen specifieke tabel. Deze tabellen worden benoemd volgens het formaat OBJECTS_<object type name> waarbij <object type name> het label van de meervoudsvorm van het objecttype is. (Merk op dat als het objecttype geen meervoudsvorm heeft, <object type name> het label van de enkelvoudsvorm van de objecttypenaam is, aaneengesloten met een "S").

Hieronder staat een volledige lijst met beschikbare HubSpot objecttypen, een korte beschrijving van de gegevens die ze vertegenwoordigen en de bijbehorende tabellen.

HubSpot Objecttype

ObjectTypeId

Beschrijving

CONTACTPERSOON

0-1

Informatie over personen die contact hebben met uw bedrijf

BEDRIJF

0-2

Informatie over individuele bedrijven of organisaties

DEAL

0-3

Details over omzetmogelijkheden met een contactpersoon of bedrijf.

INTERACTIE

0-4

Slaat gegevens op van CRM-acties, waaronder notities, taken, e-mails, vergaderingen en calls.

TICKET

0-5

Vertegenwoordigt verzoeken van klanten om hulp of ondersteuning.

QUOTE

0-14

Wordt gebruikt om prijsinformatie te delen met potentiële kopers.

FORMULIER_INDIENING

0-15

Details voor individuele formulierverzendingen voor een HubSpot formulier.

LIJN_ITEM

0-8

Vertegenwoordigt een subset van producten die in een deal worden verkocht. Wanneer een product aan een deal wordt gekoppeld, wordt het een post.

GESPREKKEN

0-11

Details van inkomende berichten van meerdere kanalen.

LANDING_PAGE

0-25

Details van uw landingspagina's

TASK

0-27

Slaat informatie op over takenlijsten

FORM

0-28

Gebruikt om leadinformatie te verzamelen over uw bezoekers en contactpersonen

MARKETING_EMAIL

0-29

Details over e-mails van Marketing Hub

AD_ACCOUNT

0-30

Slaat informatie op over je advertenties op Linkedin, Facebook en Google

AD_CAMPAIGN

0-31

Details over je campagnes. Een campagne kan een of meer advertenties bevatten

AD_GROEP

0-32

Logische groepering van advertenties binnen een campagne

ADVERTENTIES

0-33

Details over individuele advertenties

CAMPAGNES

0-35

Informatie over gerelateerde marketingmiddelen en content, zodat u eenvoudig de effectiviteit van uw gezamenlijke marketinginspanningen kunt meetwaarden.

SITE PAGINA

0-38

Gegevens over afzonderlijke pagina's op uw websites

BLOG_POST

0-39

Gegevens over blogberichten

OBJECT LIJST

0-45

Informatie over groepen van records van objecten op basis van hun eigenschappen of activiteiten

CALL

0-48

Calls gemaakt door andere CRM records, bijvoorbeeld contactpersonen

INVOICE

0-53

Facturen beheren en synchroniseren met externe boekhoudsystemen

MEDIA_BRUG

0-57

Informatie over in HubSpot geïmporteerde media-assets

SEQUENTIE

0-58

Een sequentie is een reeks gerichte, getimede e-mailsjablonen om contactpersonen in de loop der tijd te voeden

DEAL_SPLIT

0-72

Deal splits worden gebruikt om deal krediet te verdelen onder meerdere gebruikers

VERKOOPDOCUMENT

0-83

Verkoopdocumenten vormen een inhoudsbibliotheek voor je hele team om documenten te uploaden en te delen met je contactpersonen.

FEEDBACK_INDIENING

0-19

Slaat informatie op die is ingediend bij een feedbackenquête.

ABONNEMENT

0-69

Abonnementen bevatten details van terugkerende betalingen

COMMERCIËLE BETALINGEN

0-101

Bevat gegevens over geld dat van klanten is geïnd

object_met_object_eigenschappen

Deze tabel bevat gegevens van je HubSpot records. Je kunt een rij krijgen voor elke record binnen een objecttype (bijvoorbeeld alle contactpersoonrecords in het objecttype Contacten).

object_eigenschappen_geschiedenis

Deze tabel bevat historische waarden van eigenschappen. Voor contactpersonen bevat deze de meest recente 45 waarden. Voor alle andere objecten bevat het de meest recente 20 waarden. De tabel heeft een rij voor elke historische eigenschap. De huidige waarde van een eigenschap wordt bepaald door de meest recente UPDATEDAT-tijdstempel in de geschiedenis van de eigenschap.

Verenigingsvragen

Net als objectgegevens worden associatiegegevens op twee manieren georganiseerd:

  • Individueel: elk associatietype wordt opgeslagen in zijn eigen tabel en bevat alleen records van dat type. Bijvoorbeeld, associations_contacts_to_deals bevat alleen associatie records tussen contactpersoonrecords en dealrecords. T
  • Combined: alle records van alle associatietypen worden gecombineerd in één tabel.

associaties_x_naar_y

Elk associatietype heeft zijn eigen weergave, gelabeld als associations_<association type name> bijv. associations_contacts_to_deals.

associatie_definities

Deze tabel bevat informatie over alle beschikbare associatietypen tussen HubSpot objecten, met één rij per associatietype.

eigendom_definities

Deze tabel bevat informatie over object eigenschappen en gebeurtenis eigenschappen in je Hubspot account. Gebeurteniseigenschappen omvatten standaard gebeurtenissen, zoals e-mail openen en klikken, en aangepaste eigenschappen voor gedragsevenementen. Deze informatie kan handig zijn bij het definiëren van waarden in object_eigenschappen en gebeurtenisgegevens.

Gebeurtenissen

Gebeurtenissen omvatten standaard HubSpot gebeurtenissen en aangepaste gedragsgebeurtenissen. Elke gebeurtenis heeft zijn eigen tabel, gelabeld als events_eventname.

object_en_gebeurtenis_type_definities

Deze tabel bevat definities voor alle objecten en gebeurtenissen die beschikbaar zijn in je HubSpot account.

Synchronisatiefrequentie en gegevensorganisatie

Gegevens worden dagelijks gesynchroniseerd tussen HubSpot en Google BigQuery om 0900 UTC +0. Er wordt een map gemaakt voor elke dag dat de gegevens worden gesynchroniseerd met verschillende submappen voor elke tabel. De laatste zeven synchronisaties zullen beschikbaar zijn in Google Cloud platform en tabellen in BigQuery worden bijgewerkt om te verwijzen naar de laatste bucket dump.

Elk van de volgende tabellen zal beschikbaar zijn als een Parquet-bestand:

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

Was dit artikel nuttig?
Dit formulier wordt alleen gebruikt voor feedback op documentatie. Ontdek hoe je hulp krijgt met HubSpot.