HubSpot und AWS S3 verbinden (BETA)

{
 "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 zum Zeitpunkt der Erstellung eine ID zugewiesen und sie werden als 2-unique_ID identifiziert. 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
FIRMA	0–2	Informationen über einzelne Unternehmen oder Organisationen
DEAL	0–3	Details zu Einnahmemöglichkeiten mit einem Kontakt oder einem Unternehmen.
VERLOBUNG	0–4	Speichert Daten aus CRM-Aktionen, einschließlich Notizen, Aufgaben, E-Mails, Besprechungen und Anrufen.
FAHRKARTE	0–5	Vertretung von Kundenanfragen nach Hilfe oder Unterstützung.
ZITIEREN	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
FORM	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
RUFEN	0-48	Aufrufe durch andere CRM-Datensätze, zum Beispiel Kontakte
RECHNUNG	0-53	Verwalten und Synchronisieren von Rechnungen mit externen Buchhaltungssystemen
MEDIA_BRIDGE	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.
ABONNEMENT	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. Event Eigenschaften Standard-Events wie das Öffnen und Anklicken von E-Mails sowie benutzerdefiniertes Event Eigenschaften umfassen.  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.