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

• Klik op Volgende.
• Voeg in het gedeelte Review and create de Policy name en een optionele beschrijving toe.
• Klik op Beleid maken.

3. Maak de IAM-rol aan in AWS

Configureer de toegangsrechten voor HubSpot in de AWS Management Console:

• Log in op de AWS Management Console.
• Klik in het hoofddashboard op Services > Security, Identity, & Compliance > IAM.
• Klik in de linker zijbalk op Rollen.
• Klik op Rol aanmaken.
• Selecteer AWS-account in de sectie Type vertrouwde entiteit.
• Selecteer in de sectie An AWS acount (Een AWS-account ) de optie Another AWS account (Een ander AWS-account ) en voer uw eigen AWS-account-ID in. Je zult later de vertrouwensrelatie wijzigen om HubSpot toegang te geven.
• Selecteer Externe ID vereisen en voer een tijdelijke ID in zoals 0000. Je zult later de vertrouwensrelatie voor je IAM-rol wijzigen en de externe ID voor je opslagintegratie opgeven. Een externe ID wordt gebruikt om toegang tot je AWS-bronnen te verlenen aan een app van derden zoals HubSpot.

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

4. HubSpot en AWS S3 verbinden

Voordat je de integratie installeert, moet je ervoor zorgen dat je HubSpot account is aangemeld voor de beta Access HubSpot data in AWS S3 .

• Zoek en selecteer AWS S3. Je kunt ook rechtstreeks naar de integratie in je account navigeren met deze URL.
• Klik rechtsboven op Install app.
• Voer de IAM-rolnaam in die is geconfigureerd in stap 3 en het S3 URL-pad voor de emmer waarin u de gegevens wilt dumpen.
• Klik op Volgende.
• Controleer en kopieer de AWS IAM User- en AWS External ID-waarden omdat u deze in de volgende stap nodig hebt. Klik vervolgens op Continue to Connected Apps.

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

• Log in op de AWS Management Console.
• Klik op het startdashboard op Services > Security, Identity, & Compliance > IAM.
• Klik in de linker zijbalk op Rollen.
• Selecteer de rol die u in stap 3 hebt aangemaakt.
• Selecteer het tabblad Vertrouwensrelaties en klik op Vertrouwensbeleid bewerken.
• Wijzig de beleidsdocumenten 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>"
 }
 }
 }
 ]
}

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 in de waarde STORAGE_AWS_EXTERNAL_ID

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

Gegevensformaat 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 gedragsgebeurtenissen.
• Lijsten: HubSpot contact- en bedrijfslijsten.
• Eigenaren: record eigenaren.
• Pijplijnen: deal en ticket pijplijnen en pijplijn stadia.
• Eigenschappen: eigenschappen en hun waarden op de objectrecords, inclusief de geschiedenis van de eigenschappen.

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

• Individueel: elk objecttype wordt opgeslagen in zijn eigen tabel en bevat alleen records van hetzelfde objecttype. Bijvoorbeeld: objects_contacts bevat alleen contactrecords.
• Gecombineerd: allerecords van alle objecttypen worden gecombineerd in één databaseobject. Wanneer je dus een query uitvoert, moet je een filter specificeren 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 label van de meervoudsvorm van de objecttype is. (Merk op dat als het objecttype geen meervoudsvorm heeft, <object type name> het label van de enkelvoudsvorm van de objecttypenaam is, aaneengesloten met "S").

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

HubSpot objecttype	ObjectTypeId	Beschrijving
CONTACT	0-1	Informatie over personen die contact hebben met uw bedrijf
BEDRIJF	0-2	Informatie over individuele bedrijven of organisaties
DEAL	0-3	Details over omzetmogelijkheden met een contactpersoon of bedrijf.
ENGAGEMENT	0-4	Slaat gegevens op van CRM-acties, waaronder notities, taken, e-mails, vergaderingen en gesprekken.
TICKET	0-5	Vertegenwoordigt verzoeken van klanten om hulp of ondersteuning.
QUOTE	0-14	Wordt gebruikt om prijsinformatie te delen met potentiële kopers.
FORMULIER_INDIENING	0-15	Details voor individuele inzendingen voor een HubSpot-formulier.
REGEL_ITEM	0-8	Vertegenwoordigen een subset van producten die in een deal worden verkocht. Wanneer een product aan een deal wordt gekoppeld, wordt het een regelitem.
CONVERSATIE	0-11	Details van inkomende berichten van meerdere kanalen.
LANDING_PAGE	0-25	Details van je landingspagina's
TASK	0-27	Slaat informatie op over takenlijsten
FORM	0-28	Wordt gebruikt om leadinformatie te verzamelen over uw bezoekers en contactpersonen
MARKETING_EMAIL	0-29	Details over e-mails van marketing hub
AD_ACCOUNT	0-30	Slaat informatie op over je advertentieaccounts op Linkedin, Facebook en Google
AD_CAMPAIGN	0-31	Informatie over je advertentiecampagnes. Een advertentiecampagne kan een of meer advertenties bevatten
AD_GROEP	0-32	Logische groepering van advertenties binnen een advertentiecampagne
AD	0-33	Details over individuele advertenties
CAMPAIGN	0-35	Informatie over gerelateerde marketingmiddelen en inhoud, zodat u eenvoudig de effectiviteit van uw gezamenlijke marketinginspanningen kunt meten.
SITE PAGINA	0-38	Gegevens over afzonderlijke pagina's op uw websites
BLOG_POST	0-39	Gegevens over blogberichten
OBJECTLIJST	0-45	Informatie over groeperingen van objectrecords gebaseerd op hun eigenschappen of activiteiten
OPROEP	0-48	Oproepen gedaan door andere CRM-records, bijvoorbeeld contactpersonen
INVOICE	0-53	Facturen beheren en synchroniseren met externe boekhoudsystemen
MEDIA_BRIDGE	0-57	Informatie over in HubSpot geïmporteerde media-assets
SEQUENCE	0-58	Een sequentie is een reeks gerichte, getimede e-mailsjablonen om contacten in de loop van de tijd te voeden.
DEAL_SPLIT	0-72	Dealsplitsingen worden gebruikt om dealtegoed te verdelen onder meerdere gebruikers
VERKOOPDOCUMENT	0-83	Verkoopdocumenten bouwen een inhoudsbibliotheek voor je hele team om documenten te uploaden en te delen met je contactpersonen.
FEEDBACK_INDIENING	0-19	Slaat informatie op die is ingediend bij een feedbackenquête.
ABONNEMENT	0-69	Abonnementen bevatten details van terugkerende betalingen
COMMERCE BETALING	0-101	Bevat gegevens over geld dat is verzameld van klanten

object_met_object_eigenschappen

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

object_eigenschappen_geschiedenis

Deze tabel bevat historische waarden van eigenschappen. 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 waarde van een eigenschap. De huidige waarde van een eigenschap wordt bepaald door de meest recente tijdstempel UPDATEDAT in de geschiedenis van de eigenschap.

Associatie-query's

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.

eigenschap_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 handig zijn bij het definiëren van waarden die gevonden worden in object_eigenschappen en gebeurtenisgegevens.

Gebeurtenissen

Gebeurtenissen omvatten standaard HubSpot-gebeurtenissen en aangepaste gedragsevents. 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 gemaakt 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 grootte van de tabel groter is dan 15MB, zullen er meerdere gecomprimeerde CSV-bestanden onder elke tabelmap staan.