BètaGegevens synchroniseren met AWS S3 (oude versie)

Verbind HubSpot en AWS S3 om HubSpot gegevens te synchroniseren met een S3 emmer. Na het aansluiten van de app kan HubSpot CRM-gegevens, inclusief objecten, records, associaties, gebeurtenissen en segmenten synchroniseren met AWS S3 voor opslag, rapportage en analyse. 

Je kunt bijvoorbeeld contactgegevens en bedrijfsgegevens synchroniseren naar een S3 bucket en deze gebruiken in het datawarehouse van je organisatie, tools voor business intelligence of workflows voor gegevensverwerking.

Let op: HubSpot deelt geen HIPAA-gegevens met AWS S3.

Voordat je begint

Voordat je de integratie instelt, moet je je HubSpot account aanmelden voor de Access HubSpot data in AWS S3 beta.

HubSpot en AWS S3 verbinden

Om HubSpot en AWS S3 te verbinden, moet je de onderstaande stappen in volgorde volgen: 

1. Configureer de toegangsrechten voor de AWS S3 emmer. 
2. Maak een IAM-beleid aan. 
3. Maak de IAM-rol aan in AWS. 
4. Verbind HubSpot en AWS S3. 
5. Geef de IAM-gebruiker rechten om toegang te krijgen tot S3 emmerobjecten. 

1. Configureer toegangsrechten voor de S3 emmer

HubSpot heeft de volgende rechten nodig op een AWS S3 bucket en map om toegang te krijgen tot bestanden in de map en submappen:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:LijstBucket
• s3:PutObject
• s3:VerwijderObject

2. Een IAM-beleid maken

1. Log in op de AWS Management Console.
2. Klik op het homedashboard op Services > Security, Identity, & Compliance > IAM.
3. Klik in de linkerzijbalk op Accountinstellingen.
4. Zoek in het gedeelte Security Token Service (STS) naar de AWS-regio die overeenkomt met de regio waarin uw AWS-account zich bevindt. Klik om de schakelaar aan te zetten om de regio te activeren.
5. Klik in het linkerpaneel op Beleid. 
6. Klik op Beleid maken. 
7. Klik op het tabblad JSON op Nieuwe verklaring toevoegen. 
8. Voeg het onderstaande beleidsdocument toe dat HubSpot de rechten geeft die het nodig heeft om gegevens te laden of te lossen met behulp van een enkele emmer en mappad. Je kunt ook gegevensbestanden wissen met de optie PURGE copy. 

{
 "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>/*"
 ]
 }
 }
 }
 ]}

9. Klik op Volgende.
10. Voeg in het gedeelte Beoordelen en maken de Beleidsnaam en een optionele beschrijving toe.
11. Klik op Beleid maken. 

3. Maak de IAM-rol aan in AWS

Om toegangsrechten voor HubSpot te configureren in de AWS Management Console:

1. Log in op de AWS Management Console.
2. Klik op het homedashboard op Services > Security, Identity, & Compliance > IAM.
3. Klik in de linkerzijbalk op Rollen. 
4. Klik op Rol maken. 
5. Selecteer AWS-account in de sectie Type vertrouwde entiteit .
6. Selecteer in het gedeelte Een AWS-account de optie Een ander AWS-account en voer je eigen AWS-account-ID in. Later verander je de vertrouwensrelatie om HubSpot toegang te geven. 
7. Selecteer Vereis externe ID en voer een tijdelijke ID in zoals 0000. Later zult u de vertrouwensrelatie voor uw IAM-rol wijzigen en de externe ID voor uw opslagintegratie specificeren. Een externe ID wordt gebruikt om een app van derden, zoals HubSpot, toegang te geven tot je AWS-bronnen. 

8. Klik op Volgende. 
9. Selecteer het beleid dat in stap 1 is gemaakt en klik op Volgende.
10. Voer in het gedeelte Roldetails een Rolnaam en Beschrijving in om de rol te identificeren. 
11. Klik op Rol maken. 
12. Kopieer de ARN-waarde op de pagina Overzicht rol. Je zult deze waarde in de volgende stap gebruiken. 

4. HubSpot en AWS S3 verbinden

1. Klik in je HubSpot-account op het Marktplaats-pictogram in de bovenste navigatiebalk en selecteer vervolgens HubSpot-marktplaats.
2. Zoek en selecteer AWS S3. 
3. Klik op Installeren. 
4. Voer de IAM Role Name in die geconfigureerd is in stap 3 en het S3 URL Path voor de bucket waarin je de gegevens wilt opslaan.
5. Klik op Volgende.
6. Bekijk en kopieer de AWS IAM User en AWS External ID waarden omdat u deze nodig hebt in de volgende stap. Klik vervolgens op Doorgaan naar Aangesloten Apps.

5. Geef de IAM-gebruiker rechten om toegang te krijgen tot bucket-objecten

1. Log in op de AWS Management Console.
2. Klik op het homedashboard op Services > Security, Identity, & Compliance > IAM.
3. Klik in de linkerzijbalk op Rollen.
4. Selecteer de rol die je in stap 3 hebt gemaakt. 
5. Selecteer het tabblad Vertrouwensrelaties en klik op Vertrouwensbeleid bewerken. 
6. Pas de beleidsdocumenten aan met de waarden die u in stap 3 hebt vastgelegd. 

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Sid": "",
 "Effect": "Allow",
 "Principal": {
 "AWS": "<hubspot_user_arn>"
 },
 "Action": "sts:AssumeRole",
 "Condition": {
 "StringEquals": {
 "sts:ExternalId": "<hubspot_external_id>"
 }
 }
 }
 ]
}

7. Wijzig in het bovenstaande beleid de volgende twee velden in de waarden die u in stap 4 hebt vastgelegd:

• • hubspot_user_arn naar de waarde STORAGE_AWS_IAM_USER_ARN
  • hubspot_external_id naar de waarde STORAGE_AWS_EXTERNAL_ID  

Na het voltooien van de bovenstaande stappen kan HubSpot gegevens synchroniseren met AWS S3.

Gegevensindeling voor synchronisatie tussen HubSpot en AWS S3

Beschikbare gegevens voor synchronisatie

Je kunt de volgende gegevens synchroniseren van HubSpot naar AWS S3: 

• Objecten: standaard en aangepaste objecten, zoals contactpersonen, bedrijven, tickets of producten.
• Records: individuele objectrecords. 
• Associaties: alle associatietypen en bijbehorende records.
• Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen als aangepaste gedragsevents. 
• Segmenten: HubSpot contact- en bedrijfssegmenten.
• Eigenaren: geregistreerde eigenaars. 
• Pijplijnen: deal- en ticketpijplijnen en pijplijnfasen. 
• Eigenschappen: eigenschappen en hun waarden op de objectrecords, inclusief de geschiedenis van de eigenschappen. 

Objectgegevens van verschillende types zijn op twee manieren georganiseerd en beschikbaar:

• Individueel: eelk objecttype wordt opgeslagen in zijn eigen tabel en bevat alleen records van hetzelfde objecttype. Bijvoorbeeld, objects_contacts bevat alleen contactrecords.
• Gecombineerd: allerecords voor alle objecttypes worden gecombineerd in één databaseobject. Bij het queryen moet je dus een filter opgeven zoals "WHERE objectTypeId='0-1'"

Aangepaste objecten krijgen een ID toegewezen op het moment van creatie en worden geïdentificeerd als 2-unique_ID. Bijvoorbeeld 2-12345. 

objecten_x tabellen

Elk beschikbaar objecttype, inclusief aangepaste objecten, heeft zijn eigen specifieke tabel. Deze tabellen worden benoemd volgens het formaat OBJECTS_<object type name> waarbij <object type name> het meervoudsvormlabel van de objecttype. Merk op dat als het objecttype geen meervoudsvorm heeft, dan <object type name> het label van de enkelvoudsvorm van de objecttypenaam aaneengesloten met "S".

Hieronder vind je een complete lijst met beschikbare HubSpot objecttypen, een korte beschrijving van de gegevens die ze vertegenwoordigen en de bijbehorende tabellen.

object_met_object_eigenschappen

Deze tabel bevat gegevens uit je HubSpot records. U kunt een rij krijgen voor elke record binnen een objecttype (bijv. alle contactrecords in het objecttype Contacten). 

object_eigenschappen_geschiedenis

Deze tabel bevat historische vastgoedwaarden. Voor contactpersonen bevat het de meest recente 45 waarden. Voor alle andere objecten bevat het de meest recente 20 waarden. De tabel heeft een rij voor elke historische eigendomswaarde. De huidige waarde van een eigenschap wordt bepaald door de meest recente UPDATEDAT tijdstempel in de geschiedenis van de eigenschap.

Verenigingsvragen

Net als objectgegevens worden associatiegegevens op twee manieren georganiseerd:

• Individueel: elk associatietype wordt opgeslagen in zijn eigen tabel en bevat alleen records van dat type. Bijvoorbeeld, associations_contacts_to_deals bevat alleen associatierecords tussen contact- en dealobjecten. T
• Gecombineerd: alle records voor alle associatietypen worden gecombineerd in één tabel.

associaties_x_tot_y 

Elk associatietype heeft zijn eigen weergave, gelabeld als associations_<association type name> bijv. associations_contacts_to_deals. 

associatie_definities

Deze tabel bevat informatie over alle beschikbare associatietypen tussen HubSpot-objecten, met één rij per associatietype.

eigendom_definities

Deze tabel bevat informatie over objecteigenschappen en gebeurteniseigenschappen in je HubSpot account. Gebeurteniseigenschappen omvatten standaardgebeurtenissen, zoals e-mail openen en klikken, en aangepaste gedragseigenschappen voor gebeurtenissen. Deze informatie kan nuttig zijn voor het definiëren van waarden in object_eigenschappen en gebeurtenisgegevens.

Evenementen

Gebeurtenissen omvatten standaard HubSpot-gebeurtenissen en aangepaste gedragsgebeurtenissen. Elke gebeurtenis heeft zijn eigen tabel, gelabeld als events_eventname.

object_en_gebeurtenis_type_definities

Deze tabel bevat definities voor alle objecten en gebeurtenissen die beschikbaar zijn in je HubSpot-account.

Synchronisatiefrequentie en gegevensorganisatie

Gegevens worden dagelijks gesynchroniseerd tussen HubSpot en AWS S3. Er wordt een map aangemaakt voor elke dag dat de gegevens worden gesynchroniseerd. Elk van de volgende tabellen zal beschikbaar zijn als een map met gecomprimeerde CSV-bestanden:

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

Er zullen verschillende submappen zijn voor elke tabel. Als de tabel groter is dan 15 MB, zullen er meerdere CSV-bestanden onder elke tabelmap staan.