BètaHubSpot en Google BigQuery verbinden

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

Let op: HubSpot deelt geen HIPAA-gegevens met Google BigQuery.

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 Marketplace.
2. Maak een aangepaste IAM-rol aan in Google Cloud Platform.
3. Wijs de aangepaste rol toe aan de Google Service Account.
4. Geef het door HubSpot gegenereerde Google BigQuery account rechten om BigQuery tabellen te wijzigen.
5. Volledige installatie in HubSpot.

1. Installeer Google BigQuery vanaf de HubSpot App Marketplace

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. 

1. Zorg ervoor dat je HubSpot-account is aangemeld voor de bèta: Krijg toegang tot HubSpot-gegevens in Google BigQuery. 
2. Navigeer naar deze koppeling en selecteer je HubSpot-account. 
3. Klik op Installeren.
4. Voer uw Bucket URI en Project ID in. 
5. Klik op Volgende. 
6. Controleer en noteer de Google Service en BigQuery accounts, want die heb je nodig in de volgende stap. Navigeer vervolgens naar je Google Cloud console om de volgende stap te voltooien. 

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

1. Log in op je Google Cloud-console. 
2. Klik op het linker navigatiemenu en selecteer IAM & Admin > Rollen. 
3. Klik bovenaan op Rol maken.
4. Voer een titel, optionele beschrijving en ID voor de rol in. 
5. Klik op Machtigingen toevoegen. 

6. 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

7. Klik op Maken. 

3. Google Service Account rechten geven om toegang te krijgen tot Cloud Storage Buckets

1. Klik op het linker navigatiemenu en selecteer Cloud Storage > Buckets. 
2. Selecteer een emmer om te configureren. 
3. Klik op het tabblad Machtigingen .
4. Klik op het tabblad Weergeven op opdrachtgevers op Toegang verlenen.

5. Voer in het rechterpaneel in het veld Nieuwe opdrachtgevers de naam in van de Google Serviceaccount uit stap 1.

Let op: wijs het Google Service Account toe, niet het BigQuery account.

6. Klik in de sectie Rollen toewijzen op het dropdownmenu en selecteer Aangepast > <role> waarbij <role> de aangepaste IAM-rol is die in Stap 2 werd aangemaakt. 
7. Klik op Opslaan. Het 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

1. Klik op het linker navigatiemenu en selecteer IAM & Admin > IAM. 
2. Klik op Toegang verlenen.
3. Voer in het rechter paneel, in het veld New principals , het door HubSpot gegenereerde Google BigQuery-account uit stap 1 in.
4. Klik in de sectie Rollen toewijzen op het dropdownmenu en selecteer Aangepast > <role> waarbij <role> de aangepaste IAM-rol is die in Stap 2 werd aangemaakt. 

5. Volledig instellen in HubSpot

1. Klik, terug in je HubSpot-account, op Doorgaan naar Aangesloten Apps. 
2. Schakel in het dialoogvenster de selectievakjes 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 objectrecords. 
• Associaties: alle associatietypen en bijbehorende records.
• Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen als aangepaste gedragsevents. 
• Segmenten: HubSpot contact- en bedrijfssegmenten.
• Eigenaren: geregistreerde eigenaars. 
• Pijplijnen: deal- en ticketpijplijnen en pijplijnfasen. 
• Eigenschappen: eigenschappen en hun waarden op de objectrecords, inclusief de geschiedenis van de eigenschappen. 

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

• Individueel: eelk objecttype wordt opgeslagen in zijn eigen tabel en bevat alleen records van hetzelfde objecttype. Bijvoorbeeld, objects_contacts bevat alleen contactrecords.
• Gecombineerd: allerecords voor alle objecttypes worden gecombineerd in één databaseobject. Bij het queryen moet je dus een filter opgeven zoals "WHERE objectTypeId='0-1'"

Aangepaste objecten krijgen een ID toegewezen op het moment van creatie 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(Als het objecttype geen meervoudsvorm heeft, dan is <object type name> het label van de enkelvoudsvorm van de objecttypenaam aaneengesloten met "S").

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

object_met_object_eigenschappen

Deze tabel bevat gegevens uit je HubSpot records. U kunt een rij krijgen voor elke record binnen een objecttype (bijv. alle contactrecords in het objecttype Contacten). 

object_eigenschappen_geschiedenis

Deze tabel bevat historische vastgoedwaarden. Voor contactpersonen bevat het de meest recente 45 waarden. Voor alle andere objecten bevat het de meest recente 20 waarden. De tabel heeft een rij voor elke historische eigendomswaarde. 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 associatierecords tussen contact- en dealobjecten. T
• Gecombineerd: alle records voor alle associatietypen worden gecombineerd in één tabel.

associaties_x_tot_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 objecteigenschappen en gebeurteniseigenschappen in je HubSpot account. Gebeurteniseigenschappen omvatten standaardgebeurtenissen, zoals e-mail openen en klikken, en aangepaste gedragseigenschappen voor gebeurtenissen. Deze informatie kan nuttig zijn voor het definiëren van waarden in object_eigenschappen en gebeurtenisgegevens.

Evenementen

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

Datasynchronisatietaken tussen HubSpot en Google BigQuery starten dagelijks om ongeveer 6:00 AM UTC. De tijd die nodig is om gegevens te synchroniseren met Google BigQuery hangt af van de wachtrijpositie van uw account en het datavolume. Voltooiingstijden zijn niet gegarandeerd.

Er wordt een map aangemaakt voor elke dag dat de gegevens worden gesynchroniseerd, met verschillende submappen voor elke tabel. De laatste zeven synchronisaties zullen beschikbaar zijn in het 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