TestversionAnslut HubSpot till Google BigQuery

Synkronisera data från Google BigQuery med HubSpot CRM-objekt, till exempel kontakter, företag, affärer, kopplingar och annan data från ditt konto.

I avsnitten nedan beskrivs hur du auktoriserar Google BigQuery-appen och sedan konfigurerar synkroniseringsinställningarna mellan ditt Google Cloud-konto och HubSpot.

Anslut och konfigurera Google BigQuery-integrationen

Så här ansluter du ditt Google BigQuery-konto till HubSpot:

1. I ditt HubSpot-konto klickar du på Marketplace-ikonen i det övre navigeringsfältet och väljer sedan HubSpot Marketplace.
2. Klicka på sökfältet och skriv in Google BigQuery.
3. Klicka på Google BigQuery på listningssidan.
4. Klicka på Installera.
5. Klicka på Fortsätt installationen.

Du omdirigeras till verktyget för dataintegration, där en sidofält guidar dig genom synkroniseringen av data mellan dina HubSpot- och BigQuery-konton, utifrån de riktlinjer du vill synkronisera:

• Google BigQuery → HubSpot: konfigurera synkronisering från BigQuery till HubSpot.
• HubSpot → Google BigQuery: konfigurera synkronisering från HubSpot till BigQuery.

Synkronisera data från Google BigQuery till ditt HubSpot-konto

För att skicka data från Google BigQuery till HubSpot måste du lägga till och konfigurera en ny användare med de nödvändiga rollerna i ditt BigQuery-konto:

1. I den högra rutan väljer du Google BigQuery → HubSpot.
2. Kopiera e-postadressen till det Google-tjänstekonto som HubSpot genererar.

3. I ditt Google Cloud-konto navigerar du till IAM-inställningarna för ditt projekt, skapar en ny användare med e-postadressen till tjänstekontot som du kopierade från HubSpot och lägger sedan till rollerna BigQuery Data Viewer och BigQuery Job User för den nyskapade användaren.

4. Kopiera projekt-ID:t från ditt Google Cloud-konto.
5. Gå tillbaka till HubSpot, klistra in projekt-ID:t och klicka sedan på Testa anslutningen.
6. När anslutningen har verifierats klickar du på Nästa för att slutföra konfigurationen.

Synkronisera HubSpot-data till ditt Google BigQuery-konto

För att skicka HubSpot-data till Google BigQuery måste du konfigurera en användare med nödvändiga behörigheter i ditt Google Cloud-konto samt ange det tillhörande GCP-projektet och GCS-bucket-URI:n.

Observera: du behöver administratörsbehörighet i Google Cloud till det GCP-projekt där BigQuery-datauppsättningen ska lagras, samt en Google Cloud Storage (GCS)-bucket där HubSpot ska placera Parquet-filerna.

1. I den högra rutan väljer du HubSpot → Google BigQuery.
2. Kopiera e-postadressen till det Google-tjänstekonto som HubSpot genererar.

3. I ditt Google Cloud-konto navigerar du till IAM-inställningarna för ditt projekt, skapar en ny användare med e-postadressen till tjänstekontot som du kopierade från HubSpot och lägger sedan till rollerna BigQuery Data Viewer, BigQuery Job User och Storage object owner för den nyskapade användaren.

4. Kopiera projekt-ID:t från ditt Google Cloud-konto.
5. Gå tillbaka till HubSpot och klistra in projekt-ID:t.
6. Lägg till URI:n för din Google Cloud Storage (GCS)-bucket:
   • URI:n för GCS-bucket ska följa följande struktur: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Externa BigQuery-tabeller skapas i en dedikerad dataset i GCP-projektet och följer formatet: hubspot_data_set_{hubId}
   • Data skrivs till GCS-bucket, och de tillhörande tabellerna refererar till Parquet-filer i GCS.
   • Läs mer om hur du skapar GCS-buckets i Googles dokumentation.
7. Klicka på Testa anslutningen.
8. När anslutningen har verifierats klickar du på Nästa.
9. Markera kryssrutorna bredvid de datakällor du vill synkronisera (t.ex. Kontakter, Associeringar, Händelser osv.).
10. Konfigurera synkroniseringsfrekvensen och schemat.
11. Klicka på Starta synkronisering.

Övervaka synkroniseringen

När du har konfigurerat synkroniseringen mellan dina konton kan du granska synkroniseringsstatus och historik på sidan med synkroniseringsdetaljer:

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Dataintegration. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > Data Integration.
2. Under Övervaka dina importer och synkroniseringar klickar du på fliken App-synkroniseringar.
3. Klicka på sökfältet och sök efter Google BigQuery.
4. Klicka på Google BigQuery. Observera att flera poster kan visas om du har konfigurerat synkronisering i båda riktningarna.
5. På sidan med synkroniseringsdetaljer kan du hantera och granska dina synkroniseringsinställningar och din historik:
   • Om du vill arkivera eller redigera synkroniseringsdetaljerna klickar du på Åtgärder längst upp till höger och väljer sedan motsvarande alternativ.
   • Om du vill starta en synkronisering omedelbart klickar du på Synkronisera nu längst upp till höger.
   • Synkroniserade poster, kopplingar och fel sammanfattas högst upp på sidan.
   • Senaste synkroniseringsaktiviteten visas i tabellen. Klicka på fliken Synkroniseringshistorik för att granska specifika synkroniseringsförsök och slutförda synkroniseringar. Du kan filtrera efter specifika datumintervall eller synkroniseringsstatus.

Synkroniseringsstatus och felhantering

I tabellen nedan beskrivs möjliga synkroniseringsstatusar:

Om en synkronisering misslyckas:

• Visas statusen ”Misslyckad” på sidan med synkroniseringsdetaljer, tillsammans med information om vilka tabeller som synkroniserades eller inte.
• Inga data skrivs delvis vid ett misslyckande: BigQuery-tabeller uppdateras endast när en synkronisering har slutförts framgångsrikt.
• Vid nästa schemalagda synkronisering görs automatiskt ett nytt försök att genomföra en fullständig synkronisering.
• Du kan när som helst starta en ny synkronisering manuellt från sidan med synkroniseringsdetaljer.

Vittlista för nätverk

Synkronisering av HubSpot-data till tredjepartsleverantörer som BigQuery dirigeras via HubSpots proxy-IP-adresser. Dessa IP-adressintervall används av andra HubSpot-integrationer, till exempel datasynkronisering och webhooks.

Om din organisation begränsar inkommande åtkomst till dina GCP-resurser bör du lägga till följande CIDR-intervall i tillåtelselistan utifrån din HubSpot-hublet:

Lär dig hur du tar reda på var data för ditt HubSpot-konto lagras.

Begränsningar i betaversionen

Tänk på följande begränsningar under denna betafas:

• Synkroniseringsfrekvens: endast ett begränsat antal synkroniseringsfrekvenser är tillgängliga, inklusive en gång, var 6:e timme, var 12:e timme, dagligen, veckovis och månadsvis. Du kan när som helst manuellt starta en ny synkronisering från sidan med synkroniseringsdetaljer i HubSpot.
• En export per datatyp: varje objekttyp, händelsetyp eller kopplingspar kan endast exporteras i en synkroniseringskonfiguration per HubSpot-konto.
  
  • Om kontakter till exempel redan exporteras till en BigQuery-destination kan de inte läggas till i en andra konfiguration förrän den ursprungliga destinationen har arkiverats.
  • Detta förhindrar dubbla datapipelines och säkerställer en enda källa till sanning per datatyp i ditt datalager.
• Begränsat stöd för känsliga data: du kan lagra och synkronisera känsliga data till ditt HubSpot-konto, men du kan inte synkronisera känsliga data till ditt BigQuery-konto.
• Inget stöd för object_x_views: objektet object_x_views stöds för närvarande inte för synkronisering med BigQuery. Använd object_with_object_properties eller koppla ihop objects med object_properties för att få motsvarande vyer per post.

Nästa steg

När du har anslutit BigQuery-integrationen och konfigurerat dina synkroniseringsinställningar kan du läsa mer om schemat för synkroniserade tabeller i BigQuery.