BetaHubSpot mit Google BigQuery verknüpfen

Synchronisieren Sie Daten aus Google BigQuery mit HubSpot CRM-System-Objekten wie Kontakten, Unternehmen, Deals, Zuordnungen und anderen Daten aus Ihrem Account.

In den folgenden Abschnitten erfahren Sie, wie Sie die Google BigQuery-App autorisieren und dann die Synchronisierungseinstellungen zwischen Ihrem Google Cloud-Konto und HubSpot konfigurieren.

Google BigQuery-Integration verknüpfen und konfigurieren

So verknüpfen Sie Ihr Google BigQuery-Konto mit HubSpot:

1. Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Marketplace-Symbol und wählen Sie dann HubSpot Marketplace aus.
2. Klicken Sie auf die Suchleiste und geben Sie Google BigQuery ein.
3. Klicken Sie auf der Listing-Seite auf Google BigQuery.
4. Klicken Sie auf „Installieren“.
5. Klicken Sie auf Setup fortsetzen.

Sie werden zum Datenintegrationstool weitergeleitet, wo Sie in einem Seitenbereich durch die Synchronisierung von Daten zwischen Ihren HubSpot- und BigQuery-Accounts geführt werden, je nachdem, in welcher Richtung Sie die Synchronisierung durchführen möchten:

• Google BigQuery → HubSpot: Konfigurieren Sie die Synchronisierung von BigQuery mit HubSpot.
• HubSpot → Google BigQuery: Konfigurieren Sie die Synchronisierung von HubSpot mit BigQuery.

Synchronisieren Sie Google BigQuery-Daten mit Ihrem HubSpot-Account

Um Google BigQuery-Daten an HubSpot zu senden, fügen Sie in Ihrem BigQuery-Konto einen neuen Benutzer mit den erforderlichen Rollen hinzu und konfigurieren Sie ihn:

1. Wählen Sie im rechten Bereich Google BigQuery → HubSpot aus.
2. Kopieren Sie die E-Mail für das Google-Dienstkonto, die HubSpot generiert.

3. Gehen Sie in Ihrem Google Cloud-Konto zu Ihren Projekt-IAM-Einstellungen, erstellen Sie einen neuen Benutzer mit der Dienstkonto-E-Mail, die Sie von HubSpot kopiert haben, und fügen Sie dann die Rollen BigQuery-Datenviewer und BigQuery-Job-Benutzer für den neu erstellten Benutzer hinzu.

4. Kopieren Sie die Projekt-ID aus Ihrem Google Cloud-Konto.
5. Fügen Sie zurück in HubSpot die Projekt-ID ein und klicken Sie dann auf Verbindung testen.
6. Sobald die Verbindung verifiziert ist, klicken Sie auf Weiter , um die Einrichtung abzuschließen.

HubSpot-Daten mit Ihrem Google BigQuery-Konto synchronisieren

Um HubSpot-Daten an Google BigQuery zu senden, konfigurieren Sie in Ihrem Google Cloud-Konto einen Benutzer mit den erforderlichen Berechtigungen und geben das zugehörige GCP-Projekt und den GCS-Bucket-URI an.

Bitte beachten: Sie benötigen Google Cloud-Administratorzugriff auf das GCP-Projekt, in dem sich der BigQuery-Datensatz befindet, und einen Google Cloud Storage (GCS)-Bucket, in dem HubSpot Parquet-Dateien bereitstellt.

1. Wählen Sie im rechten Bereich HubSpot → Google BigQuery aus.
2. Kopieren Sie die E-Mail für das Google-Dienstkonto, die HubSpot generiert.

3. Gehen Sie in Ihrem Google Cloud-Konto zu Ihren Projekt-IAM-Einstellungen, erstellen Sie einen neuen Benutzer mit der Dienstkonto-E-Mail, die Sie von HubSpot kopiert haben, und fügen Sie dann die Rollen BigQuery Data Viewer, BigQuery-Auftragsbenutzer und Speicherobjektbesitzer für den neu erstellten Benutzer hinzu.
   

4. Kopieren Sie die Projekt-ID aus Ihrem Google Cloud-Konto.
5. Zurück in HubSpot fügen Sie die Projekt-ID ein.
6. Fügen Sie Ihren Google Cloud Storage (GCS)-Bucket-URI hinzu:
   • Der URI für den GCS-Bucket sollte der Struktur folgen:gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Externe BigQuery-Tabellen werden in einem dedizierten Dataset im GCP-Projekt erstellt und weisen das folgende Format auf:hubspot_data_set_{hubId}
   • Die Daten werden in den GCS-Bucket geschrieben, und die zugehörigen Tabellen verweisen auf Parquet-Dateien in GCS.
   • Erfahren Sie in der Google-Dokumentation mehr über das Erstellen von GCS-Buckets.
7. Klicken Sie auf Verbindung testen.
8. Sobald die Verbindung verifiziert ist, klicken Sie auf Weiter.
9. Aktivieren Sie die Kontrollkästchen neben den Datenquellen, die Sie synchronisieren möchten (z. B. Kontakte, Zuordnungen, Events usw.).
10. Konfigurieren Sie die Synchronisierungshäufigkeit und den Zeitplan.
11. Klicken Sie auf Synchronisierung starten.

Synchronisierung überwachen

Nachdem Sie die Synchronisierung zwischen Ihren Konten konfiguriert haben, können Sie den Synchronisierungsstatus und den Synchronisierungsverlauf auf der Seite mit den Synchronisierungsdetails überprüfen:

1. Klicken Sie in Ihrem HubSpot-Account auf Datenmanagement > Datenintegration.
2. Klicken Sie unter Synchronisierungen Ihrer Importe & überwachen auf die Registerkarte App-Synchronisierungen .
3. Klicken Sie auf die Suchleiste und suchen Sie nach Google BigQuery.
4. Klicken Sie auf Google BigQuery. Beachten Sie, dass mehrere Einträge angezeigt werden können, wenn Sie die Synchronisierung in beide Richtungen konfiguriert haben.
5. Auf der Seite mit den Synchronisierungsdetails können Sie Ihre Synchronisierungseinstellungen und den Verlauf verwalten und überprüfen:
   • Um Synchronisierungsdetails zu archivieren oder zu bearbeiten, klicken Sie oben rechts auf Aktionen und wählen dann die entsprechende Option aus.
   • Um sofort eine Synchronisierung auszulösen, klicken Sie oben rechts auf Jetzt synchronisieren .
   • Synchronisierte Datensätze, Zuordnungen und Fehler werden oben auf der Seite zusammengefasst.
   • Die letzten Synchronisierungs-Aktivitäten werden in der Tabelle angezeigt. Klicken Sie auf die Registerkarte Synchronisierungsverlauf , um bestimmte Synchronisierungsversuche und -abschlüsse zu überprüfen. Sie können nach bestimmten Datumsbereichen oder einem Synchronisierungsstatus filtern.

Synchronisierungsstatus und Fehlerbehandlung

In der folgenden Tabelle sind die möglichen Synchronisierungsstatus aufgeführt:

Wenn eine Synchronisierung fehlschlägt:

• Auf der Seite mit den Synchronisierungsdetails wird der Status Fehlgeschlagen angezeigt, zusammen mit Informationen darüber, welche Tabellen erfolgreich synchronisiert wurden oder nicht.
• Bei einem Fehler werden keine Daten teilweise geschrieben: BigQuery-Tabellen werden nur nach erfolgreichem Abschluss einer Synchronisierung aktualisiert.
• Bei der nächsten geplanten Synchronisierung wird automatisch erneut eine vollständige Synchronisierung versucht.
• Sie können eine erneute Synchronisierung jederzeit manuell auf der Seite mit den Synchronisierungsdetails auslösen.

Zulassungsliste für Netzwerke

Die Synchronisierung von HubSpot-Daten mit Drittanbietern wie BigQuery erfolgt über die Proxy-IPs von HubSpot. Diese IP-Bereiche werden von anderen HubSpot-Integrationen wie Datensynchronisierung und Webhooks verwendet.

Wenn Ihre Organisation den eingehenden Zugriff auf Ihre GCP-Ressourcen einschränkt, sollten Sie die folgenden CIDR-Bereiche basierend auf Ihrem HubSpot-Hublet auf die Zulassungsliste setzen:

Erfahren Sie, wie Sie herausfinden, wo Ihre HubSpot-Account-Daten gehostet werden.

Einschränkungen der Betaphase

Beachten Sie während dieser Beta die folgenden Einschränkungen:

• Synchronisierungsfrequenz: Es ist nur eine begrenzte Anzahl von Synchronisierungsfrequenzen verfügbar, darunter einmalig, alle 6 Stunden, alle 12 Stunden, täglich, wöchentlich und monatlich. Sie können eine erneute Synchronisierung jederzeit manuell über die Seite mit den Synchronisierungsdetails in HubSpot auslösen.
• Ein Export pro Datentyp: Jeder Objekttyp, Event-Typ oder jedes Zuordnungpaar kann nur in einer Synchronisierungskonfiguration pro HubSpot-Account exportiert werden.
  
  • Wenn z. B. Kontakte bereits an ein BigQuery-Ziel exportiert werden, können sie erst dann zu einer zweiten Konfiguration hinzugefügt werden, wenn das ursprüngliche Ziel archiviert ist.
  • Dies verhindert doppelte Datenpipelines und gewährleistet eine einzige Quelle der Wahrheit pro Datentyp in Ihrem Data Warehouse.
• Eingeschränkte Unterstützung vertraulicher Daten: Sie können vertrauliche Daten in Ihrem HubSpot-Account speichern und synchronisieren, aber keine vertraulichen Daten mit Ihrem BigQuery-Account.
• Keine Unterstützung für object_x_views: Das object_x_views-Objekt wird derzeit nicht für die Synchronisierung mit BigQuery unterstützt. Verwenden Sie object_with_object_properties, oder verbinden objects mit object_properties , um äquivalente Aufrufe pro Datensatz zu erhalten.

Nächste Schritte

Nachdem Sie die BigQuery-Integration verknüpft und Ihre Synchronisierungseinstellungen eingerichtet haben, erfahren Sie mehr über das Schema für synchronisierte Tabellen in BigQuery.