I betaForbind HubSpot med Google BigQuery

Synkroniser data fra Google BigQuery med HubSpot CRM-objekter, f.eks. kontakter, virksomheder, tilbud, foreninger og andre data fra din konto.

Afsnittene nedenfor gennemgår, hvordan du godkender Google BigQuery-appen og derefter konfigurerer synkroniseringsindstillinger mellem din Google Cloud-konto og HubSpot.

Tilslut og konfigurer Google BigQuery-integrationen

Sådan forbinder du din Google BigQuery-konto til HubSpot:

1. På din HubSpot-konto skal du klikke på Marketplace-ikonet i den øverste navigationslinje og derefter vælge HubSpot Marketplace.
2. Klik på søgefeltet, og indtast Google BigQuery.
3. Klik på Google BigQuery på listens side.
4. Klik på Installer.
5. Klik på Fortsæt opsætning.

Du bliver omdirigeret til dataintegrationsværktøjet, hvor en siderude vil guide dig gennem synkronisering af data mellem dine HubSpot- og BigQuery-konti, baseret på de retninger, du vil synkronisere:

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

Synkroniser Google BigQuery-data til din HubSpot-konto

For at sende Google BigQuery-data til HubSpot skal du tilføje og konfigurere en ny bruger med de nødvendige roller i din BigQuery-konto:

1. I højre rude skal du vælge Google BigQuery → HubSpot.
2. Kopier e-mailen til Google-servicekontoen, som HubSpot genererer.

3. I din Google Cloud-konto skal du navigere til dit projekts IAM-indstillinger, oprette en ny bruger med den servicekonto-e-mail, du kopierede fra HubSpot, og derefter tilføje rollerne BigQuery Data Viewer og BigQuery Job User til den nyoprettede bruger.

4. Kopier projekt-id' et fra din Google Cloud-konto.
5. Tilbage i HubSpot skal du indsætte projekt-id'et og derefter klikke på Test forbindelse.
6. Når forbindelsen er bekræftet, skal du klikke på Næste for at afslutte opsætningen.

Synkroniser HubSpot-data til din Google BigQuery-konto

For at sende HubSpot-data til Google BigQuery skal du konfigurere en bruger med de nødvendige tilladelser på din Google Cloud-konto samt angive det tilknyttede GCP-projekt og GCS bucket URI.

Bemærk: Du skal have Google Cloud-administratoradgang til det GCP-projekt, hvor BigQuery-datasættet skal ligge, og en Google Cloud Storage (GCS)-bucket, hvor HubSpot skal lagre Parquet-filer.

1. I højre rude skal du vælge HubSpot → Google BigQuery.
2. Kopier den e-mail til Google-tjenestekontoen, som HubSpot genererer.

3. I din Google Cloud-konto skal du navigere til dit projekts IAM-indstillinger, oprette en ny bruger med den servicekonto-e-mail, du kopierede fra HubSpot, og derefter tilføje rollerne BigQuery Data Viewer, BigQuery Job User og Storage object owner til den nyoprettede bruger.
   

4. Kopier projekt-id' et fra din Google Cloud-konto.
5. Indsæt projekt-id'et i HubSpot.
6. Tilføj din Google Cloud Storage (GCS) bucket URI:
   • URI'en til GCS-bucketen skal følge strukturen: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Eksterne BigQuery-tabeller oprettes i et dedikeret datasæt i GCP-projektet og følger formatet: hubspot_data_set_{hubId}
   • Data vil blive skrevet til GCS-bucketen, og de tilknyttede tabeller vil henvise til parketfiler i GCS.
   • Læs mere om oprettelse af GCS-buckets i Googles dokumentation.
7. Klik på Test forbindelse.
8. Når forbindelsen er bekræftet, skal du klikke på Næste.
9. Marker afkrydsningsfelterne ud for de datakilder, du gerne vil synkronisere (f.eks. Kontakter, Foreninger, Begivenheder osv.).
10. Konfigurer synkroniseringsfrekvensen og tidsplanen.
11. Klik på Start synkronisering.

Overvåg synkroniseringen

Når du har konfigureret synkronisering mellem dine konti, kan du se synkroniseringsstatus og -historik på siden med synkroniseringsoplysninger:

1. På din HubSpot-konto skal du gå til Datahåndtering > Dataintegration.
2. Under Overvåg dine importer og synkroniseringer skal du klikke på fanen App-synkroniseringer.
3. Klik på søgefeltet, og søg efter Google BigQuery.
4. Klik på Google BigQuery. Bemærk, at der kan vises flere poster, hvis du har konfigureret synkronisering i begge retninger.
5. På siden med synkroniseringsoplysninger kan du administrere og gennemgå dine synkroniseringsindstillinger og -historik:
   • Hvis du vil arkivere eller redigere synkroniseringsoplysninger, skal du klikke på Handlinger øverst til højre og derefter vælge den tilsvarende mulighed.
   • Klik på Synkroniser nu øverst til højre for at udløse en synkronisering med det samme.
   • Synkroniserede poster, tilknytninger og fejl opsummeres øverst på siden.
   • Den seneste synkroniseringsaktivitet vises i tabellen. Klik på fanen Synkroniseringshistorik for at gennemgå specifikke synkroniseringsforsøg og -afslutninger. Du kan filtrere efter bestemte datointervaller eller en synkroniseringsstatus.

Synkroniseringsstatusser og fejlhåndtering

Tabellen nedenfor viser mulige synkroniseringsstatusser:

Hvis en synkronisering mislykkes:

• En mislykket status vises på siden med synkroniseringsoplysninger sammen med oplysninger om, hvilke tabeller der blev synkroniseret eller ikke blev synkroniseret.
• Ingen data skrives delvist ved fejl: BigQuery-tabeller opdateres kun, når en synkronisering er gennemført.
• Den næste planlagte synkronisering vil automatisk forsøge at lave en fuld synkronisering igen.
• Du kan til enhver tid udløse en ny synkronisering manuelt fra siden med synkroniseringsoplysninger.

Liste over tilladte netværk

Synkronisering af HubSpot-data til tredjepartsudbydere som BigQuery dirigeres gennem HubSpots proxy-IP'er. Disse IP-intervaller bruges af andre HubSpot-integrationer, såsom datasynkronisering og webhooks.

Hvis din organisation begrænser indgående adgang til dine GCP-ressourcer, skal du tillade følgende CIDR-intervaller baseret på din HubSpot-hublet:

Lær, hvordan du finder ud af , hvor dine HubSpot-kontodata er hostet.

Beta-begrænsninger

Hav følgende begrænsninger i tankerne under denne beta:

• Synkroniseringsfrekvens: Der er kun et begrænset antal synkroniseringsfrekvenser til rådighed, herunder én gang, hver 6. time, hver 12. time, dagligt, ugentligt og månedligt. Du kan til enhver tid manuelt udløse en ny synkronisering fra siden med synkroniseringsdetaljer i HubSpot.
• Én eksport pr. datatype: Hver objekttype, hændelsestype eller associationspar kan kun eksporteres i én synkroniseringskonfiguration pr. HubSpot-konto.
  
  • Hvis kontakter f.eks. allerede eksporteres til en BigQuery-destination, kan de ikke føjes til en anden konfiguration, før den oprindelige destination er arkiveret.
  • Dette forhindrer dobbelte datapipelines og sikrer en enkelt sandhedskilde pr. datatype i dit datalager.
• Begrænset understøttelse af følsomme data: Du kan gemme og synkronisere følsomme data til din HubSpot-konto, men du kan ikke synkronisere følsomme data til din BigQuery-konto.
• Ingen understøttelse af object_x_views: object_x_views-objektet understøttes i øjeblikket ikke til synkronisering med BigQuery. Brug object_with_object_properties, eller forbind objects med object_properties for at få tilsvarende visninger pr. post.

Næste skridt

Når du har tilsluttet BigQuery-integrationen og konfigureret dine synkroniseringsindstillinger, kan du lære mere om skemaet for synkroniserede tabeller i BigQuery.