Zum Hauptinhalt
Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt. Er wurde automatisch mit einer Software übersetzt und unter Umständen nicht korrekturgelesen. Die englischsprachige Fassung gilt als offizielle Version und Sie können dort die aktuellsten Informationen finden. Hier können Sie darauf zugreifen.

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: 

  1. Konfigurieren Sie die Zugriffsberechtigungen für den AWS S3-Bucket
  2. Eine IAM-Richtlinie erstellen
  3. Erstellen Sie die IAM-Rolle in AWS
  4. HubSpot und AWS S3 verbinden
  5. 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. 

an-aws-account

  • 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. 

arn-wert

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 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.

HubSpot Objekttyp

ObjectTypeId

Beschreibung

KONTAKT

0–1

Informationen über Personen, die mit Ihrem Unternehmen interagieren

UNTERNEHMEN

0–2

Informationen über einzelne Unternehmen oder Organisationen

DEAL

0–3

Details zu Einnahmemöglichkeiten mit einem Kontakt oder einem Unternehmen. 

ENGAGEMENT

0–4

Speichert Daten aus CRM-Aktionen, einschließlich Notizen, Aufgaben, E-Mails, Besprechungen und Anrufen.

TICKET

0–5

Vertretung von Kundenanfragen nach Hilfe oder Unterstützung.

ANGEBOT

0-14

Dient der Weitergabe von Preisinformationen an potenzielle Käufer.

FORM_EINREICHUNG

0-15

Details für einzelne Übermittlungen für ein HubSpot-Formular.

LINE_ITEM

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.

CONVERSATION

0–11

Details zu eingehenden Nachrichten aus mehreren Kanälen.

LANDING_PAGE

0–25

Details zu Ihren Landing Pages

 TASK

0-27

Speichert Informationen über To-Do-Listen

FORMEL

0-28

Zum Sammeln von Lead-Informationen über Ihre Besucher und Kontakte

MARKETING_EMAIL

0-29

Details zu E-Mails von der Marketingzentrale

AD_ACCOUNT

0-30

Speichert Informationen über Ihre Werbekonten bei Linkedin, Facebook und Google

AD_CAMPAIGN

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

KAMPAGNE

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

BLOG_POST

0-39

Daten zu Blogbeiträgen

OBJEKT-LISTE

0-45

Informationen über Gruppierungen von Objektdatensätzen auf der Grundlage ihrer Eigenschaften oder Aktivitäten

ANRUFEN

0-48

Aufrufe durch andere CRM-Datensätze, zum Beispiel Kontakte

RECHNUNG

0-53

Verwalten und Synchronisieren von Rechnungen mit externen Buchhaltungssystemen

MEDIEN_BRÜCKE

0-57

Informationen über in HubSpot importierte Medienressourcen

SEQUENCE

0-58

Eine Sequenz ist eine Reihe gezielter, zeitlich abgestimmter E-Mail-Vorlagen zur Pflege von Kontakten im Laufe der Zeit

DEAL_SPLIT

0-72

Geschäftsaufteilungen werden verwendet, um Geschäftsguthaben unter mehreren Benutzern aufzuteilen

VERKAUF_DOKUMENT

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.

FEEDBACK_VORLAGE

0-19

Speichert Informationen, die im Rahmen einer Feedback-Umfrage übermittelt wurden.

ABONNIERUNG

0-69

Abonnements enthalten Details zu wiederkehrenden Zahlungen

KOMMERZIELLE ZAHLUNG

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. 

War dieser Artikel hilfreich?
Dieses Formular wird nur verwendet, um Feedback zur Dokumentation zu sammeln. Erfahren Sie, wie Sie Hilfe bei Fragen zu HubSpot erhalten können.