TestversionAnslut HubSpot till Google BigQuery

Synkronisera data från Google BigQuery med HubSpot CRM-objekt, t.ex. kontakter, företag, affärer, associationer och andra data från ditt konto.

I avsnitten nedan går vi igenom hur du auktoriserar Google BigQuery-appen och sedan konfigurerar synkroniseringsinställningar mellan ditt Google Cloud-konto och HubSpot.

Ansluta 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 ange Google BigQuery.
3. Klicka på Google BigQuery från listningssidan.
4. Klicka på Installera.
5. Klicka på Fortsätt installationen.

Du kommer att omdirigeras till verktyget för dataintegration, där en sidofönster kommer att vägleda dig genom att synkronisera data mellan dina HubSpot- och BigQuery-konton, baserat på de anvisningar du vill synkronisera:

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

Synkronisera Google BigQuery-data till ditt HubSpot-konto

För att skicka Google BigQuery-data till HubSpot lägger du till och konfigurerar en ny användare med de roller som krävs i ditt BigQuery-konto:

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

3. I ditt Google Cloud-konto navigerar du till projektets IAM-inställningar, skapar en ny användare med e-postmeddelandet för servicekontot 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. Tillbaka i HubSpot klistrar du in projekt-ID:t och klickar sedan på Testa anslutningen.
6. När anslutningen har verifierats klickar du på Nästa för att slutföra installationen.

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, tillsammans med att ange det associerade GCP-projektet och GCS bucket URI.

Observera: du behöver Google Cloud-adminåtkomst till GCP-projektet där BigQuery-datasetet kommer att finnas, och en Google Cloud Storage (GCS) bucket där HubSpot kommer att lagra Parquet-filer.

1. I den högra rutan väljer du HubSpot → Google BigQuery.
2. Kopiera e-postmeddelandet för Google-tjänstkontot som HubSpot genererar.

3. I ditt Google Cloud-konto navigerar du till dina IAM-inställningar för projektet, skapar en ny användare med e-postmeddelandet för servicekontot 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. Tillbaka i HubSpot klistrar du in projekt-ID:t.
6. Lägg till din Google Cloud Storage (GCS) bucket URI:
   • URI:n för GCS-bucketen bör följa strukturen: 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 kommer att skrivas till GCS-bucket och de associerade tabellerna kommer att referera till parkettfiler 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å Next.
9. Markera kryssrutorna bredvid de datakällor som du vill synkronisera (t.ex. Kontakter, Associationer, Händelser etc.).
10. Konfigurera synkroniseringsfrekvensen och schemat.
11. Klicka på Starta synkronisering.

Övervaka synkroniseringen

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

1. I ditt HubSpot-konto, navigera till Datahantering > Dataintegrering.
2. Under Övervaka dina importer och synkroniseringar klickar du på fliken Appsynkroniseringar.
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 historik:
   • Om du vill arkivera eller redigera synkroniseringsdetaljer 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, associationer och fel sammanfattas högst upp på sidan.
   • Den senaste synkroniseringsaktiviteten visas i tabellen. Klicka på fliken Synkningshistorik för att granska specifika synkroniseringsförsök och slutförda synkroniseringar. Du kan filtrera efter specifika datumintervall eller en synkroniseringsstatus.

Synkroniseringsstatusar och felhantering

I tabellen nedan beskrivs möjliga synkroniseringsstatusar:

Om en synkronisering misslyckas:

• Statusen Misslyckades visas på sidan med synkroniseringsdetaljer, tillsammans med information om vilka tabeller som synkroniseringen lyckades eller misslyckades med.
• Inga data skrivs delvis vid misslyckande: BigQuery-tabeller uppdateras endast när en synkronisering har slutförts.
• Vid nästa schemalagda synkronisering görs automatiskt ett nytt försök till fullständig synkronisering.
• Du kan utlösa en ny synkronisering manuellt när som helst från sidan med synkroniseringsinformation.

Nätverk tillåterlistning

Synkronisering av HubSpot-data till tredjepartsleverantörer som BigQuery dirigeras via HubSpots proxy-IP:er. Dessa IP-intervall 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 tillåta följande CIDR-områden baserat på din HubSpot-hublet:

Lär dig hur du tar reda på var dina HubSpot-kontodata finns.

Beta-begränsningar

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

• Synkroniseringsfrekvens: endast en begränsad uppsättning 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 utlösa en ny synkronisering manuellt från sidan med synkroniseringsdetaljer i HubSpot.
• En export per datatyp: varje objekttyp, händelsetyp eller associationspar kan endast exporteras i en synkroniseringskonfiguration per HubSpot-konto.
  
  • Om till exempel kontakter 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 sanningskälla 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å likvärdiga 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.