HubSpot und AWS S3 verbinden (BETA)
Zuletzt aktualisiert am: September 25, 2024
Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):
Operations Hub Enterprise |
Erfahren Sie, wie Sie HubSpot und AWS S3 verbinden, um HubSpot-Daten mit Ihrem S3-Bucket zu synchronisieren.
HubSpot und AWS S3 verbinden
Um HubSpot und AWS S3 zu verbinden, müssen Sie die folgenden Schritte der Reihe nach ausführen:
- Konfigurieren Sie die Zugriffsberechtigungen für den AWS S3-Bucket
- Eine IAM-Richtlinie erstellen
- Erstellen Sie die IAM-Rolle in AWS
- HubSpot und AWS S3 verbinden
- Erteilen Sie dem IAM-Benutzer Berechtigungen für den Zugriff auf S3-Bucket-Objekte
1. Konfigurieren Sie die Zugriffsberechtigungen für den S3-Bucket
HubSpot benötigt die folgenden Berechtigungen für einen AWS S3-Bucket und -Ordner, um auf Dateien im Ordner und in Unterordnern zuzugreifen:
- s3:GetBucketLocation
- s3:GetObject
- s3:GetObjectVersion
- s3:ListBucket
- s3:PutObject
- s3:DeleteObject
2. Eine IAM-Richtlinie erstellen
- Melden Sie sich bei der AWS Management Console an.
- Klicken Sie auf dem Home Dashboard auf Services > Security, Identity, & Compliance > IAM.
- Klicken Sie in der linken Seitenleiste auf Kontoeinstellungen.
- Suchen Sie im Abschnitt Security Token Service (STS) nach der AWS-Region, die der Region entspricht, in der sich Ihr AWS Account befindet. Klicken Sie auf den Schalter , um ihn auf umzuschalten und die Region zu aktivieren.
- Klicken Sie im linken Seitenbereich auf Policies.
- Klicken Sie auf Richtlinie erstellen.
- Klicken Sie auf der Registerkarte JSON auf Neue Anweisung hinzufügen.
- Fügen Sie das unten stehende Richtliniendokument hinzu, das HubSpot die erforderlichen Berechtigungen zum Laden oder Entladen von Daten über einen einzelnen Bucket und einen Ordnerpfad erteilt. Sie können Datendateien auch mit der Kopieroption PURGE bereinigen.
Bitte beachten:
- Ersetzen Sie
<bucket>
und<prefix>
durch Ihren tatsächlichen Bucket-Namen und das Präfix für den Ordnerpfad. Tie Amazon Resource Names (ARN) für Buckets in Regierungsregionen haben ein arn:aws-us-gov:s3::: Präfix. - Einstellung der Bedingung
s3:prefix
auf entweder ["*"] oder ["<path>/*"] gewährt Zugriff auf alle Präfixe im angegebenen Bereich bzw. Pfad im Bereich.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:GetObjectVersion",
"s3:DeleteObject",
"s3:DeleteObjectVersion"
],
"Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
},
{
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource": "arn:aws:s3:::<bucket>",
"Condition": {
"StringLike": {
"s3:prefix": [
"<prefix>/*"
]
}
}
}
]
}
- Klicken Sie auf Weiter.
- Fügen Sie im Abschnitt Überprüfen und veröffentlichen Sie den Richtliniennamen und eine optionale Beschreibung hinzu.
- Klicken Sie auf Richtlinie erstellen.
3. Erstellen Sie die IAM-Rolle in AWS
So konfigurieren Sie die Zugriffsberechtigungen für HubSpot in der AWS Management Console:
- Melden Sie sich bei der AWS Management Console an.
- Klicken Sie auf dem Home Dashboard auf Services > Security, Identity, & Compliance > IAM.
- Klicken Sie in der linken Seitenleiste auf Rollen.
- Klicken Sie auf Rolle erstellen.
- Wählen Sie im Abschnitt Trusted entity type AWS Account aus.
- Wählen Sie im Abschnitt Ein AWS-Konto die Option Ein anderes AWS-Konto und geben Sie Ihre eigene AWS-Konto-ID ein. Sie werden die Vertrauensbeziehung später ändern, um HubSpot Zugang zu gewähren.
- Wählen Sie Require external ID und geben Sie eine Platzhalter-ID wie 0000 ein. Sie werden später die Vertrauensbeziehung für Ihre IAM-Rolle ändern und die externe ID für Ihre Speicherintegration angeben. Eine externe ID wird verwendet, um einer Drittanbieter-App wie HubSpot Zugriff auf Ihre AWS-Ressourcen zu gewähren.
- Klicken Sie auf Weiter.
- Wählen Sie die in Schritt 1 erstellte Richtlinie aus und klicken Sie auf Next.
- Geben Sie im Abschnitt Rollendetails einen Rollennamen und Beschreibung ein, um die Rolle zu identifizieren.
- Klicken Sie auf Rolle erstellen.
- Kopieren Sie den Wert ARN auf die Zusammenfassungsseite Role. Sie werden diesen Wert im nächsten Schritt verwenden.
4. HubSpot und AWS S3 verbinden
- Vergewissern Sie sich, dass Ihr HubSpot Account für diese Beta freigeschaltet ist: Zugriff auf HubSpot-Daten in AWS S3.
- Navigieren Sie zu this URL und wählen Sie Ihren HubSpot Account aus.
- Klicken Sie oben rechts auf App installieren.
- Geben Sie den in Schritt 3 konfigurierten IAM-Rollennamen und den S3-URL-Pfad für den Bucket ein, in den Sie die Daten auslagern möchten.
- Klicken Sie auf Weiter.
- Überprüfen und kopieren Sie die Werte AWS IAM User und AWS External ID , da Sie diese im nächsten Schritt benötigen. Klicken Sie dann auf Weiter zu Verknüpfte Apps.
5. Erteilen Sie dem IAM-Benutzer die Berechtigung zum Zugriff auf Bucket-Objekte
- Melden Sie sich bei der AWS Management Console an.
- Klicken Sie auf dem Home Dashboard auf Services > Security, Identity, & Compliance > IAM.
- Klicken Sie in der linken Seitenleiste auf Rollen.
- Wählen Sie die Rolle, die Sie in Schritt 3 erstellt haben.
- Wählen Sie die Registerkarte Vertrauensbeziehungen und klicken Sie auf Vertrauensrichtlinie bearbeiten.
- Ändern Sie die Policendokumente mit den Datensätzen, die Sie in Schritt 3 erfasst haben.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"AWS": "<hubspot_user_arn>"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "<hubspot_external_id>"
}
}
}
]
}
Ändern Sie in der obigen Richtlinie die folgenden beiden Felder auf die Werte, die Sie in Schritt 4 erfasst haben:
- hubspot_user_arn zum STORAGE_AWS_IAM_USER_ARN Wert
- hubspot_external_id zum STORAGE_AWS_EXTERNAL_ID Wert
Nach Abschluss der oben genannten Schritte kann HubSpot die Daten in AWS S3 synchronisieren.
Datenformat für die Synchronisation zwischen HubSpot und AWS S3
Verfügbare Daten für die Synchronisation
Sie können die folgenden Daten von HubSpot mit AWS S3 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 objecttype
ist. (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.
HubSpot Objekttyp |
ObjectTypeId |
Beschreibung |
0–1 |
Informationen über Personen, die mit Ihrem Unternehmen interagieren |
|
0–2 |
Informationen über einzelne Unternehmen oder Organisationen |
|
0–3 |
Details zu Einnahmemöglichkeiten mit einem Kontakt oder einem Unternehmen. |
|
0–4 |
Speichert Daten aus CRM-Aktionen, einschließlich Notizen, Aufgaben, E-Mails, Besprechungen und Anrufen. |
|
0–5 |
Vertretung von Kundenanfragen nach Hilfe oder Unterstützung. |
|
0-14 |
Dient der Weitergabe von Preisinformationen an potenzielle Käufer. |
|
0-15 |
Details für einzelne Übermittlungen für ein HubSpot-Formular. |
|
0–8 |
Sie stellen eine Teilmenge der in einem Geschäft verkauften Produkte dar. Wenn ein Produkt einem Deal zugeordnet wird, wird es zu einem Artikel. |
|
0–11 |
Details zu eingehenden Nachrichten aus mehreren Kanälen. |
|
0–25 |
Details zu Ihren Landing Pages |
|
0-27 |
Speichert Informationen über To-Do-Listen |
|
0-28 |
Zum Sammeln von Lead-Informationen über Ihre Besucher und Kontakte |
|
0-29 |
Details zu E-Mails von der Marketingzentrale |
|
AD_ACCOUNT |
0-30 |
Speichert Informationen über Ihre Werbekonten bei Linkedin, Facebook und Google |
0-31 |
Details zu Ihren Werbekampagnen. Eine Anzeigenkampagne kann eine oder mehrere Anzeigen enthalten |
|
AD_GRUPPE |
0-32 |
Logische Gruppierung von Anzeigen innerhalb einer Anzeigenkampagne |
ANZEIGE |
0-33 |
Details zu einzelnen Anzeigen |
0-35 |
Informationen über verwandte Marketing-Assets und -Inhalte, so dass Sie die Effektivität Ihrer kollektiven Marketingbemühungen leicht messen können. |
|
SITE_PAGE |
0-38 |
Daten über einzelne Seiten auf Ihren Websites |
0-39 |
Daten zu Blogbeiträgen |
|
0-45 |
Informationen über Gruppierungen von Objektdatensätzen auf der Grundlage ihrer Eigenschaften oder Aktivitäten |
|
0-48 |
Aufrufe durch andere CRM-Datensätze, zum Beispiel Kontakte |
|
RECHNUNG |
0-53 |
Verwalten und Synchronisieren von Rechnungen mit externen Buchhaltungssystemen |
0-57 |
Informationen über in HubSpot importierte Medienressourcen |
|
0-58 |
Eine Sequenz ist eine Reihe gezielter, zeitlich abgestimmter E-Mail-Vorlagen zur Pflege von Kontakten im Laufe der Zeit |
|
0-72 |
Geschäftsaufteilungen werden verwendet, um Geschäftsguthaben unter mehreren Benutzern aufzuteilen |
|
0-83 |
Mit Verkaufsdokumenten können Sie eine Bibliothek mit Inhalten für Ihr gesamtes Team erstellen, um Dokumente hochzuladen und mit Ihren Kontakten zu teilen. |
|
0-19 |
Speichert Informationen, die im Rahmen einer Feedback-Umfrage übermittelt wurden. |
|
0-69 |
Abonnements enthalten Details zu wiederkehrenden Zahlungen |
|
0-101 |
Enthält Daten über von Kunden eingezogene Gelder |
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 AWS S3. Für jeden Tag, an dem die Daten synchronisiert werden, wird ein Ordner erstellt. 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
Für jede Tabelle gibt es mehrere Unterordner. Wenn die Größe der Tabelle 15 MB übersteigt, befinden sich unter jedem Tabellenordner mehrere gzipped CSV-Dateien.