BètaHubSpot koppelen aan Google BigQuery

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

In de onderstaande paragrafen wordt uitgelegd hoe u de Google BigQuery-app autoriseert en vervolgens de synchronisatie-instellingen tussen uw Google Cloud-account en HubSpot configureert.

De Google BigQuery-integratie koppelen en configureren

Om je Google BigQuery-account aan HubSpot te koppelen:

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 typ 'Google BigQuery' in.
3. Klik op Google BigQuery op de overzichtspagina.
4. Klik op 'Installeren'.
5. Klik op 'Ga verder met de installatie'.

Je wordt doorgestuurd naar de tool voor gegevensintegratie, waar een zijpaneel 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: configureer de synchronisatie van BigQuery naar HubSpot.
• HubSpot → Google BigQuery: configureer de synchronisatie van HubSpot naar BigQuery.

Synchroniseer Google BigQuery-gegevens met je HubSpot-account

Om Google BigQuery-gegevens naar HubSpot te verzenden, voeg je een nieuwe gebruiker toe aan je BigQuery-account en configureer je deze met de vereiste rollen:

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

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

4. Kopieer de project-ID uit je Google Cloud-account.
5. Ga terug naar HubSpot, plak de project-ID en klik vervolgens op ‘Verbinding testen’.
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-gegevens naar Google BigQuery te verzenden, moet je in je Google Cloud-account een gebruiker met de vereiste machtigingen configureren en het bijbehorende GCP-project en de GCS-bucket-URI opgeven.

Let op: je hebt Google Cloud-beheerdersrechten nodig voor het GCP-project waarin de BigQuery-dataset wordt opgeslagen, en een Google Cloud Storage (GCS)-bucket waarin HubSpot Parquet-bestanden tijdelijk opslaat.

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

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

4. Kopieer de project-ID uit je Google Cloud-account.
5. Ga terug naar HubSpot en plak de project-ID.
6. Voeg de URI van je Google Cloud Storage (GCS)-bucket toe:
   • De URI voor de GCS-bucket moet de volgende structuur hebben: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Externe BigQuery-tabellen worden aangemaakt in een speciale dataset in het GCP-project en volgen de volgende indeling: hubspot_data_set_{hubId}
   • Gegevens worden naar de GCS-bucket geschreven en de bijbehorende tabellen verwijzen naar Parquet-bestanden in GCS.
   • Lees meer over het aanmaken van GCS-buckets in de documentatie van Google.
7. Klik op 'Verbinding testen'.
8. Zodra de verbinding is geverifieerd, klikt u op 'Volgende'.
9. Schakel de selectievakjes in naast de gegevensbronnen die u wilt synchroniseren (bijv. Contacten, Koppelingen, Evenementen, enz.).
10. Stel de synchronisatiefrequentie en het schema in.
11. Klik op 'Synchronisatie starten'.

De synchronisatie volgen

Nadat u de synchronisatie tussen uw accounts hebt geconfigureerd, kunt u de synchronisatiestatus en -geschiedenis bekijken op de pagina met synchronisatiegegevens:

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Gegevensbeheer > Gegevensintegratie. Als Meer niet in je account verschijnt, navigeer dan direct naar Gegevensbeheer > Gegevensintegratie.
2. Klik onder 'Uw imports en synchronisaties controleren' op het tabblad 'App-synchronisaties '.
3. Klik op de zoekbalk en zoek naar Google BigQuery.
4. Klik op Google BigQuery. Houd er rekening mee dat er meerdere vermeldingen kunnen verschijnen als u synchronisatie in beide richtingen hebt geconfigureerd.
5. Op de pagina met synchronisatiegegevens kunt u uw synchronisatie-instellingen en -geschiedenis beheren en bekijken:
   • Om synchronisatiegegevens te archiveren of te bewerken, klikt u rechtsboven op 'Acties' en selecteert u vervolgens de betreffende optie.
   • Om onmiddellijk een synchronisatie te starten, klikt u rechtsboven op 'Nu synchroniseren '.
   • Gesynchroniseerde records, koppelingen en fouten worden bovenaan de pagina samengevat.
   • Recente synchronisatieactiviteiten worden in de tabel weergegeven. Klik op het tabblad 'Synchronisatiegeschiedenis' om specifieke synchronisatiepogingen en voltooide synchronisaties te bekijken. U kunt filteren op specifieke datumbereiken of een synchronisatiestatus.

Synchronisatiestatus en foutafhandeling

In de onderstaande tabel worden de mogelijke synchronisatiestatussen weergegeven:

Als een synchronisatie mislukt:

• Op de pagina met synchronisatiegegevens verschijnt de status 'Mislukt', samen met informatie over welke tabellen wel of niet succesvol zijn gesynchroniseerd.
• Bij een mislukking worden er geen gegevens gedeeltelijk geschreven: BigQuery-tabellen worden alleen bijgewerkt als een synchronisatie succesvol is voltooid.
• Bij de volgende geplande synchronisatie wordt automatisch opnieuw een volledige synchronisatie uitgevoerd.
• U kunt op elk moment handmatig een nieuwe synchronisatie starten vanaf de pagina met synchronisatiegegevens.

Toegestane netwerken

Het synchroniseren van HubSpot-gegevens naar externe providers zoals BigQuery verloopt via de proxy-IP-adressen van HubSpot. Deze IP-reeksen worden ook gebruikt door andere HubSpot-integraties, zoals gegevenssynchronisatie en webhooks.

Als uw organisatie de inkomende toegang tot uw GCP-bronnen beperkt, moet u de volgende CIDR-bereiken op de toelatingslijst zetten op basis van uw HubSpot-hublet:

Ontdek hoe u kunt achterhalen waar de gegevens van uw HubSpot-account worden gehost.

Beperkingen van de bètaversie

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

• Synchronisatiefrequentie: er is slechts een beperkt aantal synchronisatiefrequenties beschikbaar, waaronder eenmalig, om de 6 uur, om de 12 uur, dagelijks, wekelijks en maandelijks. Je kunt op elk moment handmatig een nieuwe synchronisatie starten via de pagina met synchronisatiegegevens in HubSpot.
• Eén export per gegevenstype: elk objecttype, gebeurtenistype of koppelingspaar kan slechts in één synchronisatieconfiguratie per HubSpot-account worden geëxporteerd.
  
  • Als contacten bijvoorbeeld al naar één BigQuery-bestemming worden geëxporteerd, kunnen ze pas aan een tweede configuratie worden toegevoegd nadat de oorspronkelijke bestemming is gearchiveerd.
  • Dit voorkomt dubbele datapijplijnen en zorgt ervoor dat er per gegevenstype één enkele betrouwbare bron in je datawarehouse is.
• 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 voeg objects samen met object_properties om gelijkwaardige weergaven per record te verkrijgen.

Volgende stappen

Nadat u de BigQuery-integratie hebt gekoppeld en uw synchronisatie-instellingen hebt geconfigureerd, kunt u meer te weten komen over het schema voor gesynchroniseerde tabellen in BigQuery.