HubSpot und Google BigQuery verbinden (BETA)

Erfahren Sie, wie Sie HubSpot und Google BigQuery verbinden, um HubSpot-Daten mit Ihrer Google BigQuery-Instanz zu synchronisieren. 

HubSpot und BigQuery verbinden

Um HubSpot und Google BigQuery miteinander zu verbinden, müssen Sie die folgenden Schritte der Reihe nach durchführen:

1. Installieren Sie Google BigQuery über den HubSpot App Marketplace
2. Erstellen einer benutzerdefinierten IAM-Rolle in der Google Cloud Plattform
3. Zuweisen der benutzerdefinierten Rolle an das Google Service-Konto
4. Erteilen Sie dem von HubSpot erstellten Google BigQuery Account die Berechtigung, BigQuery-Tabellen zu ändern
5. Vollständiges Setup in HubSpot

1. Installieren Sie Google BigQuery über den HubSpot App Marketplace

Es wird empfohlen, dass Sie Ihr HubSpot-Konto und Ihr Google BigQuery-Konto in separaten Tabs geöffnet haben, wenn Sie die beiden Apps verbinden. 

• Vergewissern Sie sich, dass Ihr HubSpot Account für diese Beta aktiviert ist: Zugriff auf HubSpot Daten in Google BigQuery. 
• Navigieren Sie zu this link und wählen Sie Ihren HubSpot Account aus. 
• Klicken Sie oben rechts auf App installieren.
• Geben Sie Ihre Bucket URI und Projekt-ID ein. 
• Klicken Sie auf Weiter. 

• Überprüfen und notieren Sie sich die Accounts von Google Service und BigQuery, da Sie diese im nächsten Schritt benötigen. Navigieren Sie dann zu Ihrer Google Cloud-Konsole, um den nächsten Schritt auszuführen. 

2. Erstellen einer benutzerdefinierten IAM-Rolle in der Google Cloud Plattform

• Melden Sie sich bei Ihrer Google Cloud-Konsole an. 
• Klicken Sie auf das linke Navigationsmenü und wählen Sie IAM & Admin > Rollen. 
• Klicken Sie oben auf Rolle erstellen.
• Geben Sie einen Titel, optional Beschreibung und ID für die Rolle ein. 
• Klicken Sie auf +Hinzufügen von Berechtigungen. 

• Wählen Sie in der Tabelle die folgenden Berechtigungen aus und klicken Sie auf Hinzufügen:

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
Bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list

• Klicken Sie auf Erstellen. 

3. Zuweisen der benutzerdefinierten Rolle an das Cloud Storage Service-Konto

• Klicken Sie auf das linke Navigationsmenü und wählen Sie Cloud Storage > Buckets. 
• Wählen Sie einen Bucket zur Konfiguration aus. 
• Klicken Sie auf die Registerkarte Berechtigungen.
• Klicken Sie auf der Registerkarte Anzeigen als auf Zugriff gewähren. 

• Geben Sie im rechten Feld New principals den Namen Google Service Account aus Schritt 2 ein.
• Klicken Sie im Abschnitt Rollen zuweisen auf das Dropdown-Menü und wählen Sie Benutzerdefiniert > <role>, wobei <role> die in Schritt 1 erstellte benutzerdefinierte IAM-Rolle ist. 
• Klicken Sie auf Speichern. Das Google-Service-Konto wird der Rolle Storage Object Viewer hinzugefügt. 

4. Erteilen Sie dem von HubSpot erstellten Google BigQuery Account die Berechtigung, BigQuery-Tabellen zu ändern

• Klicken Sie auf das linke Navigationsmenü und wählen Sie IAM & Admin > IAM. 
• Klicken Sie auf Zugriff gewähren.
• Geben Sie im rechten Feld New principals den Namen Google Service Account aus Schritt 2 ein.
• Klicken Sie im Abschnitt Rollen zuweisen auf das Dropdown-Menü und wählen Sie Benutzerdefiniert > <role>, wobei <role> die in Schritt 1 erstellte benutzerdefinierte IAM-Rolle ist. 

5. Vollständiges Setup in HubSpot

• Klicken Sie in Ihrem HubSpot Account auf Weiter zu Verknüpfte Apps. 

• Aktivieren Sie im Dialogfeld die Kontrollkästchen und klicken Sie dann auf Zulassen und installieren. 

Datenformat für die Synchronisation mit HubSpot und Google BigQuery

Verfügbare Daten für die Synchronisation

Sie können die folgenden Daten von HubSpot mit Google BigQuery synchronisieren: 

• Objekte: Standard- und benutzerdefinierte Objekte, wie Kontakte, Unternehmen, Tickets oder Produkte.
• Datensätze: Datensätze zu einzelnen Objekten. 
• Assoziationen: alle Assoziationstypen und zugeordneten Datensätze.
• Events: Ereignisdaten sowohl für standardmäßige HubSpot-Events als auch für benutzerdefinierte verhaltensorientierte Events. 
• Listen: HubSpot Kontakt- und Unternehmenslisten.
• Eigentümer: Datensätze Eigentümer. 
• Pipelines: Deal- und Ticket-Pipelines und Pipeline-Phasen. 
• Eigenschaften: Eigenschaften und ihre Werte in den Datensätzen des Objekts, einschließlich des Eigenschaftsverlaufs. 

Objektdaten verschiedener Typen sind auf zwei Arten organisiert und verfügbar:

• Individuell: ejeder Objekttyp wird in einer eigenen Tabelle gespeichert und hat nur Datensätze desselben Objekttyps. Zum Beispiel enthält objects_contacts nur Kontaktdatensätze.
• Kombiniert: aAlle Datensätze für alle Objekttypen werden in einem Datenbankobjekt zusammengefasst. Daher müssen Sie bei der Abfrage einen Filter wie "WHERE objectTypeId='0-1'" angeben

Benutzerdefinierten Objekten wird bei der Erstellung eine ID zugewiesen, die als 2-unique_ID bezeichnet wird. Zum Beispiel: 2-12345. 

objekte_x Tabellen

Jeder verfügbare Objekttyp, einschließlich benutzerdefinierter Objekte, hat seine eigene Tabelle. Diese Tabellen werden nach dem Format OBJECTS_<object type name> benannt, wobei <object type name> das Label der Pluralform von objecttypeist. (Beachten Sie, dass <object type name> das Label der Singularform des Formulartyps ist, wenn der Objekttyp keine Pluralform hat und mit "S" verkettet ist).

Im Folgenden finden Sie eine vollständige Liste der verfügbaren HubSpot-Objekttypen, eine kurze Beschreibung der Daten, die sie darstellen, und die entsprechenden Tabellen.

object_with_object_properties

Diese Tabelle enthält Daten aus Ihren HubSpot-Datensätzen. Sie können eine Zeile für jeden Datensatz innerhalb eines Objekttyps erhalten (z. B. alle Kontaktdatensätze im Objekttyp Kontakte). 

object_properties_history

Die Tabelle enthält historische Eigenschaftenwerte. Bei Kontakten enthält sie die letzten 45 Werte. Für alle anderen Objekte enthält sie die letzten 20 Werte. Die Tabelle enthält eine Zeile für jeden historischen Eigenschaftswert. Der aktuelle Wert einer Eigenschaft wird durch den letzten UPDATEDAT-Zeitstempel im Verlauf der Eigenschaft bestimmt.

Assoziationsanfragen

Wie die Daten von Objekten sind auch die Daten von Vereinigungen auf zwei Arten organisiert:

• Individuell: Jeder Assoziationstyp wird in seiner eigenen Tabelle gespeichert und enthält nur Datensätze dieses Typs. Zum Beispiel enthält associations_contacts_to_deals nur Datensätze, die zwischen Kontakt- und Deal-Objekten zugeordnet sind. T
• Kombiniert: werden alle Datensätze für alle Assoziationstypen in einer Tabelle zusammengefasst.

assoziationen_x_zu_y 

Jeder Assoziationstyp hat seine eigene Ansicht, die mit dem Label associations_<association type name> z.B. associations_contacts_to_deals versehen ist. 

association_definitions

Diese Tabelle enthält Informationen über alle verfügbaren Assoziationstypen zwischen HubSpot-Objekten, mit einer Zeile pro Assoziationstyp.

property_definitions

Diese Tabelle enthält Informationen über Objekteigenschaften und Event-Eigenschaften in Ihrem HubSpot Account. Zu den Event-Eigenschaften gehören Standard-Events, wie z. B. Geöffnete E-Mails und Klicks, und benutzerdefinierte verhaltensorientierte Events Eigenschaften. Diese Informationen können bei der Definition von Werten in object_properties und events data hilfreich sein.

Events

Zu den Events gehören standardmäßige HubSpot Events und benutzerdefinierte verhaltensorientierte Events. Für jedes Ereignis gibt es eine eigene Tabelle, die mit dem Label events_eventname versehen ist.

object_and_event_type_definitions

Diese Tabelle enthält Definitionen für alle Objekte und Ereignisse, die in Ihrem HubSpot Account verfügbar sind.

Synchronisationsfrequenz und Datenorganisation

Daten-Synchronisationen täglich zwischen HubSpot und Google BigQuery um 0900 UTC +0. Für jeden Tag, an dem die Daten synchronisiert werden, wird ein Ordner mit mehreren Unterordnern für jede Tabelle erstellt. Die letzten sieben Synchronisationen sind in der Google Cloud Plattform verfügbar und die Tabellen in BigQuery werden aktualisiert, um auf den letzten Bucket Dump zu verweisen.

Jede der folgenden Tabellen ist als Ordner mit gzipped CSV-Dateien verfügbar:

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS