HubSpot en Google BigQuery verbinden (BETA)

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.

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

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.

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

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

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

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