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 Marketplace
2. Een aangepaste IAM-rol aanmaken in Google Cloud Platform
3. De aangepaste rol toewijzen aan de Google Service Account
4. Geef het door HubSpot gegenereerde Google BigQuery account rechten om BigQuery tabellen te wijzigen
5. Volledig instellen 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.

• Zorg ervoor dat je HubSpot-account is aangemeld voor deze bèta: Toegang tot HubSpot-gegevens in Google BigQuery.
• Navigeer naar deze koppeling en selecteer je HubSpot-account.
• Klik rechtsboven op App installeren.
• Voer uw 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 je Google Cloud-console.
• Klik op het linker navigatiemenu en selecteer IAM & Beheer > Rollen.
• Klik bovenaan op Rol maken.
• 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. Wijs de aangepaste rol toe aan de Cloud Storage Service-account

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

• Voer in het rechterpaneel in het veld Nieuwe opdrachtgevers de naam in van de Google Serviceaccount uit stap 2.
• Klik in de sectie Rollen toewijzen op het vervolgkeuzemenu en selecteer Aangepast > <rol> waarbij <rol> de aangepaste IAM-rol is die in Stap 1 is aangemaakt.
• 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.

• Klik op het linker navigatiemenu en selecteer IAM & Beheer > IAM.
• Klik op Toegang verlenen.
• Voer in het rechterpaneel in het veld Nieuwe opdrachtgevers de naam in van de Google Serviceaccount uit stap 2.
• Klik in de sectie Rollen toewijzen op het vervolgkeuzemenu en selecteer Aangepast > <rol> waarbij <rol> de aangepaste IAM-rol is die in Stap 1 is aangemaakt.

5. Volledige installatie in HubSpot

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

• 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.
• Lijsten: HubSpot contact- en bedrijfslijsten.
• 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: elk objecttype wordt opgeslagen in zijn eigen tabel en bevat alleen records van hetzelfde objecttype. Bijvoorbeeld: objects_contacts bevat alleen records van contactpersonen.
• Gecombineerd: allerecords voor alle objecttypes worden gecombineerd in één databaseobject. Wanneer je dus een query uitvoert, moet je een filter specificeren 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 de 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 "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 van je HubSpot-records. Je kunt een rij krijgen voor elke record binnen een objecttype (bijvoorbeeld alle contactrecords in het objecttype Contacten).

object_eigenschappen_geschiedenis

Deze tabel bevat historische waarden van eigendommen. 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 waarde van een eigenschap. De huidige waarde van een eigenschap wordt bepaald door de meest recente tijdstempel UPDATEDAT 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 handig zijn bij 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

Gegevens worden dagelijks gesynchroniseerd tussen HubSpot en Google BigQuery om 0900 UTC +0. 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 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 map met gecomprimeerde CSV-bestanden:

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