Koble HubSpot til Google BigQuery

Synkroniser data fra Google BigQuery med HubSpot CRM-objekter, for eksempel kontakter, selskaper, avtaler, tilknytninger og andre data fra kontoen din.

Avsnittene nedenfor viser deg hvordan du autoriserer Google BigQuery-appen og deretter konfigurerer synkroniseringsinnstillingene mellom Google Cloud-kontoen din og HubSpot.

Koble til og konfigurer Google BigQuery-integrasjonen

Slik kobler du Google BigQuery-kontoen din til HubSpot:

1. På HubSpot-kontoen din klikker du på Marketplace-ikonet i den øverste navigasjonslinjen, og deretter velger du HubSpot Marketplace.
2. Klikk på søkefeltet og skriv inn Google BigQuery.
3. Klikk på Google BigQuery på oversiktssiden.
4. Klikk på Installer.
5. Klikk på «Fortsett konfigurasjonen».

Du blir omdirigert til verktøyet for dataintegrasjon, der et sidepanel vil veilede deg gjennom synkroniseringen av data mellom HubSpot- og BigQuery-kontoene dine, basert på hvilke retninger du ønsker å synkronisere:

• Google BigQuery → HubSpot: Konfigurer synkronisering fra BigQuery til HubSpot.
• HubSpot → Google BigQuery: Konfigurer synkronisering fra HubSpot til BigQuery.

Synkroniser data fra Google BigQuery til HubSpot-kontoen din

For å sende Google BigQuery-data til HubSpot må du legge til og konfigurere en ny bruker med de nødvendige rollene i BigQuery-kontoen din:

1. I høyre rute velger du Google BigQuery → HubSpot.
2. Kopier e-postadressen til Google-tjenestekontoen som HubSpot genererer.

3. I Google Cloud-kontoen din går du til IAM-innstillingene for prosjektet, oppretter en ny bruker med e-postadressen til tjenestekontoen du kopierte fra HubSpot, og tilordner deretter rollene «BigQuery Data Viewer» og «BigQuery Job User» til den nyopprettede brukeren.

4. Kopier prosjekt-ID -en fra Google Cloud-kontoen din.
5. Gå tilbake til HubSpot, lim inn prosjekt-ID-en og klikk deretter på Test tilkobling.
6. Når tilkoblingen er bekreftet, klikker du på «Neste» for å fullføre konfigurasjonen.

Synkroniser HubSpot-data til Google BigQuery-kontoen din

For å sende HubSpot-data til Google BigQuery må du opprette en bruker med de nødvendige tillatelsene i Google Cloud-kontoen din, samt angi det tilknyttede GCP-prosjektet og GCS-bucket-URI-en.

Merk: Du trenger administratorrettigheter i Google Cloud til GCP-prosjektet der BigQuery-datasettet skal ligge, samt en Google Cloud Storage (GCS)-bucket der HubSpot skal lagre Parquet-filer.

1. I høyre rute velger du HubSpot → Google BigQuery.
2. Kopier e-postadressen til Google-tjenestekontoen som HubSpot genererer.

3. I Google Cloud-kontoen din går du til IAM-innstillingene for prosjektet, oppretter en ny bruker med e-postadressen til tjenestekontoen du kopierte fra HubSpot, og legger deretter til rollene «BigQuery Data Viewer», «BigQuery Job User» og «Storage object owner» for den nyopprettede brukeren.

4. Kopier prosjekt-ID -en fra Google Cloud-kontoen din.
5. Gå tilbake til HubSpot og lim inn prosjekt-ID-en.
6. Legg til URI-en for Google Cloud Storage (GCS)-bøtten din:
   • URI-en for GCS-bucket skal følge denne strukturen: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Eksterne BigQuery-tabeller opprettes i et dedikert datasett i GCP-prosjektet og følger dette formatet: hubspot_data_set_{hubId}
   • Dataene skrives til GCS-bucket, og de tilknyttede tabellene refererer til Parquet-filer i GCS.
   • Les mer om hvordan du oppretter GCS-bøtter i Googles dokumentasjon.
7. Klikk på Test tilkobling.
8. Når tilkoblingen er bekreftet, klikker du på «Neste».
9. Merk av i boksene ved siden av datakildene du vil synkronisere (f.eks. Kontakter, Tilknytninger, Hendelser osv.).
10. Konfigurer synkroniseringsfrekvensen og tidsplanen.
11. Klikk på «Start synkronisering».

Overvåk synkroniseringen

Når du har konfigurert synkroniseringen mellom kontoene dine, kan du se synkroniseringsstatus og -historikk på siden med synkroniseringsdetaljer:

1. I HubSpot-kontoen din klikker du på Mer, og så navigerer du til Dataadministrasjon > Dataintegrering. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Dataadministrasjon > Dataintegrering.
2. Under Overvåk import og synkronisering klikker du på fanen App-synkronisering.
3. Klikk på søkefeltet og søk etter Google BigQuery.
4. Klikk på Google BigQuery. Merk at det kan vises flere oppføringer hvis du har konfigurert synkronisering i begge retninger.
5. På siden med synkroniseringsdetaljer kan du administrere og se gjennom synkroniseringsinnstillingene og historikken:
   • For å arkivere eller redigere synkroniseringsdetaljer klikker du på «Handlinger» øverst til høyre og velger deretter det aktuelle alternativet.
   • For å utløse en synkronisering umiddelbart, klikker du på «Synkroniser nå» øverst til høyre.
   • Synkroniserte poster, tilknytninger og feil er oppsummert øverst på siden.
   • Nylig synkroniseringsaktivitet vises i tabellen. Klikk på fanen «Synkroniseringshistorikk» for å se på spesifikke synkroniseringsforsøk og fullførte synkroniseringer. Du kan filtrere etter bestemte datointervaller eller synkroniseringsstatus.

Synkroniseringsstatus og feilhåndtering

Tabellen nedenfor viser mulige synkroniseringsstatuser:

Hvis en synkronisering mislykkes:

• Det vises en «Mislykket»-status på siden med synkroniseringsdetaljer, sammen med informasjon om hvilke tabeller som ble synkronisert eller ikke.
• Ingen data blir delvis skrevet ved feil: BigQuery-tabeller oppdateres kun når en synkronisering er fullført.
• Den neste planlagte synkroniseringen vil automatisk forsøke en fullstendig synkronisering på nytt.
• Du kan når som helst utløse en ny synkronisering manuelt fra siden med synkroniseringsdetaljer.

Tillatelsesliste for nettverk

Synkronisering av HubSpot-data til tredjepartsleverandører som BigQuery går via HubSpots proxy-IP-adresser. Disse IP-adressene brukes av andre HubSpot-integrasjoner, for eksempel datasynkronisering og webhooks.

Hvis organisasjonen din begrenser innkommende tilgang til GCP-ressursene dine, bør du legge følgende CIDR-områder til tillatelseslisten basert på HubSpot-hubletet ditt:

Finn ut hvor dataene til HubSpot-kontoen din er lagret.

Begrensninger i betaversjonen

Vær oppmerksom på følgende begrensninger under denne betaversjonen:

• Synkroniseringsfrekvens: De tilgjengelige synkroniseringsfrekvensene avhenger av synkroniseringsretningen. Du kan når som helst utløse en ny synkronisering manuelt fra siden med synkroniseringsdetaljer i HubSpot.

  • HubSpot til Google BigQuery: én gang, hver 6. time, hver 12. time, daglig, ukentlig eller månedlig.
  • Google BigQuery til HubSpot: hvert 15. minutt, hvert 30. minutt, hver time, hver 2. time, hver 3. time, hver 6. time, hver 12. time, daglig, ukentlig eller månedlig.

• Én eksport per datatype: hver objekttype, hendelsestype eller tilknytningspar kan bare eksporteres i én synkroniseringskonfigurasjon per HubSpot-konto.
  
  • Hvis kontakter for eksempel allerede eksporteres til én BigQuery-destinasjon, kan de ikke legges til i en annen konfigurasjon før den opprinnelige destinasjonen er arkivert.
  • Dette forhindrer dupliserte datapipelines og sikrer én enkelt kilde til sannhet per datatype i datalageret ditt.
• Begrenset støtte for sensitive data: du kan lagre og synkronisere sensitive data til HubSpot-kontoen din, men du kan ikke synkronisere sensitive data til BigQuery-kontoen din.
• Ingen støtte for object_x_views: object_x_views-objektet støttes foreløpig ikke for synkronisering med BigQuery. Bruk object_with_object_properties, eller koble objects med object_properties for å få tilsvarende visninger per post.

Neste trinn

Når du har koblet til BigQuery-integrasjonen og konfigurert synkroniseringsinnstillingene, kan du lære mer om skjemaet for synkroniserte tabeller i BigQuery.