BètaHubSpot verbinden met Google BigQuery

Synchroniseer gegevens uit Google BigQuery met HubSpot CRM-objecten, zoals contactpersonen, bedrijven, deals, verenigingen en andere gegevens uit je account.

In de onderstaande secties wordt uitgelegd hoe je de Google BigQuery app kunt autoriseren en vervolgens de synchronisatie-instellingen tussen je Google Cloud account en HubSpot kunt configureren.

Verbind en configureer de Google BigQuery integratie

Om je Google BigQuery account te verbinden met HubSpot:

1. Klik in je HubSpot-account op het Marktplaats-pictogram in de bovenste navigatiebalk en selecteer vervolgens HubSpot-marktplaats.
2. Klik op de zoekbalk en voer Google BigQuery in.
3. Klik op Google BigQuery op de lijstpagina.
4. Klik op Installeren.
5. Klik op Installatie voortzetten.

Je wordt doorgestuurd naar de tool voor gegevensintegratie, waar een zijvenster je helpt bij het synchroniseren van gegevens tussen je HubSpot- en BigQuery-accounts, op basis van de richtingen waarin je wilt synchroniseren:

• Google BigQuery → HubSpot: synchronisatie configureren van BigQuery naar HubSpot.
• HubSpot → Google BigQuery: synchronisatie configureren van HubSpot naar BigQuery.

Google BigQuery gegevens synchroniseren met je HubSpot account

Om Google BigQuery-gegevens naar HubSpot te verzenden, moet je een nieuwe gebruiker met de vereiste rollen toevoegen en configureren in je BigQuery-account:

1. Selecteer in het rechterdeelvenster Google BigQuery → HubSpot.
2. Kopieer het e-mailadres van het Google-serviceaccount dat HubSpot genereert.

3. Navigeer in je Google Cloud-account naar de IAM-instellingen van je project, maak een nieuwe gebruiker aan met het serviceaccount dat je hebt gekopieerd van HubSpot en voeg de rollen BigQuery Data Viewer en BigQuery Job User toe voor de nieuw aangemaakte gebruiker.

4. Kopieer de Project ID van je Google Cloud account.
5. Plak de Project-ID terug in HubSpot en klik vervolgens op Test verbinding.
6. Zodra de verbinding is geverifieerd, klik je op Volgende om de installatie te voltooien.

HubSpot gegevens synchroniseren met je Google BigQuery account

Om HubSpot data naar Google BigQuery te sturen, configureer je een gebruiker met de vereiste rechten in je Google Cloud account, samen met het specificeren van het bijbehorende GCP project en GCS bucket URI.

Let op: je hebt Google Cloud admin toegang nodig tot het GCP project waar de BigQuery dataset zal worden opgeslagen, en een Google Cloud Storage (GCS) bucket waar HubSpot de Parquet bestanden zal opslaan.

1. Selecteer in het rechtervenster HubSpot → Google BigQuery.
2. Kopieer de Google service account e-mail die HubSpot genereert.

3. Navigeer in je Google Cloud-account naar de IAM-instellingen van je project, maak een nieuwe gebruiker aan met het serviceaccount e-mailadres dat je hebt gekopieerd van HubSpot en voeg de rollen BigQuery Data Viewer, BigQuery Job User en Storage object owner toe voor de nieuw aangemaakte gebruiker.
   

4. Kopieer de Project ID van je Google Cloud account.
5. Plak de Project-ID terug in HubSpot.
6. Voeg uw Google Cloud Storage (GCS) bucket URI toe:
   • De URI voor de GCS bucket moet de structuur volgen: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • BigQuery externe tabellen worden aangemaakt in een speciale dataset in het GCP project en volgen het formaat: hubspot_data_set_{hubId}
   • Gegevens worden geschreven naar de GCS emmer en de bijbehorende tabellen verwijzen naar parketbestanden in GCS.
   • Lees meer over het maken van GCS buckets in de documentatie van Google.
7. Klik op Verbinding testen.
8. Klik op Volgende zodra de verbinding is geverifieerd.
9. Schakel de selectievakjes in naast de gegevensbronnen die u wilt synchroniseren (bijv. Contactpersonen, Verenigingen, Gebeurtenissen, enz.).
10. Configureer de synchronisatiefrequentie en het schema.
11. Klik op Synchronisatie starten.

De synchronisatie bewaken

Nadat je de synchronisatie tussen je accounts hebt geconfigureerd, kun je de synchronisatiestatus en -geschiedenis bekijken op de pagina met synchronisatiedetails:

1. Ga in je HubSpot-account naar Gegevensbeheer > Gegevensintegratie.
2. Klik onder Monitor je imports & syncs op het tabblad App syncs.
3. Klik op de zoekbalk en zoek naar Google BigQuery.
4. Klik op Google BigQuery. Merk op dat er meerdere items kunnen verschijnen als je synchronisatie in beide richtingen hebt geconfigureerd.
5. Op de pagina met synchronisatiedetails kunt u uw synchronisatie-instellingen en -geschiedenis beheren en bekijken:
   • Om synchronisatiedetails te archiveren of te bewerken, klikt u rechtsboven op Acties en selecteert u de bijbehorende optie.
   • Om onmiddellijk een synchronisatie te starten, klik je rechtsboven op Nu synchroniseren.
   • Gesynchroniseerde records, koppelingen en fouten worden bovenaan de pagina samengevat.
   • Recente synchronisatieactiviteiten verschijnen in de tabel. Klik op het tabblad Sync-geschiedenis om specifieke synchronisatiepogingen en voltooiingen te bekijken. Je kunt filteren op specifieke datumbereiken of een synchronisatiestatus.

Synchronisatiestatussen en foutafhandeling

De onderstaande tabel geeft een overzicht van de mogelijke synchronisatiestatussen:

Als een synchronisatie mislukt:

• Er verschijnt een Mislukte status op de sync detailpagina, samen met informatie over welke tabellen wel of niet gesynchroniseerd zijn.
• Er worden geen gegevens gedeeltelijk weggeschreven bij mislukking: BigQuery tabellen worden alleen bijgewerkt als de synchronisatie succesvol is voltooid.
• Bij de volgende geplande synchronisatie wordt automatisch opnieuw geprobeerd een volledige synchronisatie uit te voeren.
• Je kunt op elk moment handmatig een re-sync starten vanaf de sync detailpagina.

Netwerk toestaanlijsting

Het synchroniseren van HubSpot gegevens met externe providers zoals BigQuery wordt gerouteerd via HubSpot's proxy IP's. Deze IP reeksen worden gebruikt door andere HubSpot integraties. Deze IP reeksen worden gebruikt door andere HubSpot integraties, zoals data synchronisatie en webhooks.

Als je organisatie inkomende toegang tot je GCP resources beperkt, moet je de volgende CIDR ranges toestaan op basis van je HubSpot hublet:

Ontdek hoe u erachter kunt komen waar uw HubSpot-accountgegevens worden gehost.

Bèta beperkingen

Houd tijdens deze bèta rekening met de volgende beperkingen:

• Synchronisatiefrequentie: er is slechts een beperkte set synchronisatiefrequenties beschikbaar, waaronder eenmaal, elke 6 uur, elke 12 uur, dagelijks, wekelijks en maandelijks. Je kunt op elk moment handmatig een hersynchronisatie starten vanaf de synchronisatie details pagina in HubSpot.
• Eén export per gegevenstype: elk objecttype, gebeurtenistype of associatiepaar kan maar in één synchronisatieconfiguratie per HubSpot account worden geëxporteerd.
  
  • Als contactpersonen bijvoorbeeld al worden geëxporteerd naar één BigQuery-bestemming, kunnen ze niet worden toegevoegd aan een tweede configuratie totdat de oorspronkelijke bestemming is gearchiveerd.
  • Dit voorkomt dubbele datapijplijnen en zorgt voor één bron van waarheid per datatype in je datawarehouse.
• Beperkte ondersteuning voor gevoelige gegevens: je kunt gevoelige gegevens opslaan en synchroniseren met je HubSpot-account, maar je kunt geen gevoelige gegevens synchroniseren met je BigQuery-account.
• Geen ondersteuning voor object_x_views: het object_x_views object wordt momenteel niet ondersteund voor synchronisatie met BigQuery. Gebruik object_with_object_properties, of join objects met object_properties om gelijkwaardige per-record weergaven te krijgen.

Volgende stappen

Nadat je de BigQuery integratie hebt aangesloten en je synchronisatie-instellingen hebt ingesteld, leer je meer over het schema voor gesynchroniseerde tabellen in BigQuery.