Yhdistä HubSpot ja AWS S3 (BETA)

Opi yhdistämään HubSpot ja AWS S3 synkronoimaan HubSpot-tiedot S3-ämpäriin.

Yhdistä HubSpot ja AWS S3

Jos haluat yhdistää HubSpotin ja AWS S3:n, sinun on noudatettava alla olevia ohjeita järjestyksessä:

1. Määritä AWS S3 -kauhan käyttöoikeudet.
2. Luo IAM-käytäntö
3. Luo IAM-rooli AWS:ssä
4. Yhdistä HubSpot ja AWS S3
5. Myönnä IAM-käyttäjälle käyttöoikeudet S3-kauhan objektien käyttämiseen.

1. Määritä S3-ämpärin käyttöoikeudet.

HubSpot tarvitsee seuraavat oikeudet AWS S3 -kauhaan ja kansioon, jotta se voi käyttää kansiossa ja alikansioissa olevia tiedostoja:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:PutObject
• s3:DeleteObject

2. Luo IAM-käytäntö

• Kirjaudu AWS Management Consoleen.
• Valitse aloituskojelaudassa Palvelut > Suojaus, identiteetti ja vaatimustenmukaisuus > IAM.
• Valitse vasemmanpuoleisesta sivupalkista Tiliasetukset.
• Etsi Security Token Service (STS) -osiosta AWS-alue, joka vastaa aluetta, jolla AWS-tilisi sijaitsee. Aktivoi alue napsauttamalla kytkintä päälle.
• Napsauta vasemmanpuoleisessa paneelissa Policies (Käytännöt).
• Valitse Luo käytäntö.
• Napsauta JSON-välilehdellä Lisää uusi lauseke.
• Lisää alla oleva käytäntöasiakirja, joka antaa HubSpotille tarvittavat oikeudet ladata tai purkaa tietoja yhden kauhan ja kansiopolun avulla. Voit myös tyhjentää datatiedostot käyttämällä PURGE-kopiointivaihtoehtoa.

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

• Napsauta Seuraava.
• Lisää Review and create (Tarkista ja luo ) -osioon käytäntöjen nimi ja valinnainen kuvaus.
• Valitse Luo käytäntö.

3. Luo IAM-rooli AWS:ssä

HubSpotin käyttöoikeuksien määrittäminen AWS Management Consolessa:

• Kirjaudu AWS Management Consoleen.
• Valitse aloituskojelaudassa Palvelut > Suojaus, identiteetti ja vaatimustenmukaisuus > IAM.
• Valitse vasemmanpuoleisesta sivupalkista Roolit.
• Valitse Luo rooli.
• Valitse Luottamuksellisen yksikön tyyppi -osiossa AWS-tili.
• Valitse An AWS acount (AWS-tili ) -osiossa Another AWS account (Toinen AWS-tili ) ja kirjoita oman AWS-tilisi tunnus. Muutat myöhemmin luottamussuhdetta niin, että HubSpotille annetaan pääsy.
• Valitse Vaadi ulkoinen tunnus ja syötä kenttätunnus, kuten 0000. Myöhemmin muutat IAM-roolisi luottamussuhdetta ja määrität ulkoisen ID:n tallennusintegraatiota varten. Ulkoista ID:tä käytetään, kun myönnetään pääsy AWS-resursseihisi kolmannen osapuolen sovellukselle, kuten HubSpotille.

• Napsauta Seuraava.
• Valitse vaiheessa 1 luotu käytäntö ja valitse Seuraava.
• Kirjoita Roolien tiedot -osioon Roolien nimi ja Kuvaus roolin yksilöimiseksi.
• Valitse Luo rooli.
• Kopioi ARN-arvo Roolien yhteenvetosivulla. Käytät tätä arvoa seuraavassa vaiheessa.

4. Yhdistä HubSpot ja AWS S3

• Varmista, että HubSpot-tilisi on valittuna tähän betatestiin: Pääsy HubSpotin tietoihin AWS S3:ssa.
• Siirry tähän URL-osoitteeseen ja valitse HubSpot-tilisi.
• Napsauta oikeassa yläkulmassa Asenna sovellus.
• Kirjoita vaiheessa 3 määritetty IAM-roolin nimi ja S3-URL-polku sille kauhalle, johon tiedot halutaan siirtää.
• Napsauta Seuraava.
• Tarkista ja kopioi AWS IAM User- ja AWS External ID -arvot, koska tarvitset niitä seuraavassa vaiheessa. Valitse sitten Continue to Connected Apps.

5. Myönnä IAM-käyttäjälle oikeudet käyttää kauhan objekteja.

• Kirjaudu AWS Management Consoleen.
• Valitse aloituskojelaudassa Palvelut > Suojaus, identiteetti ja vaatimustenmukaisuus > IAM.
• Valitse vasemmassa sivupalkissa Roolit.
• Valitse vaiheessa 3 luotu rooli.
• Valitse Luottamussuhteet-välilehti ja valitse Muokkaa luottamuskäytäntöä.
• Muokkaa vakuutusasiakirjoja vaiheessa 3 tallentamillasi arvoilla.

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

Vaihda yllä olevan käytännön kaksi seuraavaa kenttää vaiheessa 4 tallentamiisi arvoihin:

• hubspot_user_arn arvoon STORAGE_AWS_IAM_USER_ARN.
• hubspot_external_id arvoon STORAGE_AWS_EXTERNAL_ID.

Kun olet suorittanut edellä mainitut vaiheet, HubSpot voi synkronoida tiedot AWS S3:een.

HubSpotin ja AWS S3:n välisen synkronoinnin dataformaatti

Synkronoitavat tiedot

Voit synkronoida seuraavat tiedot HubSpotista AWS S3:een:

• Kohteet: vakio- ja mukautetut kohteet, kuten yhteystiedot, yritykset, liput tai tuotteet.
• Tietueet: yksittäisten kohteiden tietueet.
• Yhdistelmät: kaikki yhdistelmätyypit ja niihin liittyvät tietueet.
• Tapahtumat: tapahtumatiedot sekä HubSpotin vakiotapahtumista että mukautetuista käyttäytymistapahtumista.
• Luettelot: HubSpotin yhteyshenkilö- ja yritysluettelot.
• Omistajat: omistajat.
• Putket: sopimusten ja lippujen putket ja putkivaiheet.
• Ominaisuudet: objektitietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuuksien historia.

Erityyppiset objektitiedot on järjestetty ja saatavilla kahdella tavalla:

• Yksilöllinen: kukin objektityyppi tallennetaan omaan tauluunsa, ja siinä on vain saman objektityypin tietueita. Esimerkiksi objects_contacts sisältää vain yhteystietoja.
• Yhdistetty: kaikkienkohdetyyppienkaikkitietueet yhdistetään yhdeksi tietokantaobjektiksi. Näin ollen kyselyä tehdessäsi sinun on määritettävä suodatin, kuten "WHERE objectTypeId='0-1'".

Mukautetuille objekteille annetaan tunniste luontihetkellä, ja sen tunniste on 2-unique_ID. Esimerkiksi 2-12345.

objects_x taulukot

Jokaisella käytettävissä olevalla objektityypillä, mukaan lukien mukautetut objektit, on oma erityinen taulukkonsa. Nämä taulukot nimetään muotoa OBJECTS_<object type name> noudattaen, jossa <object type name> on objecttype:n monikkomuotoinen nimitys (huomaa, että jos objektityypillä ei ole monikkomuotoa, <object type name> on objektityypin nimen yksikkömuotoinen nimitys, johon on liitetty "S").

Alla on täydellinen luettelo käytettävissä olevista HubSpot-objektityypeistä, lyhyt kuvaus niiden edustamista tiedoista ja niitä vastaavat taulukot.

object_with_object_properties (objekti_objektien_ominaisuuksilla)

Tämä taulukko sisältää tietoja HubSpot-tietueistasi. Voit saada yhden rivin jokaisesta tietueesta objektityypin sisällä (esim. kaikki kontaktitietueet kontaktit-objektityypissä).

object_properties_history

Tämä taulukko sisältää kiinteistöjen historialliset arvot. Yhteystietojen osalta se sisältää viimeisimmät 45 arvoa. Kaikkien muiden kohteiden osalta se sisältää viimeisimmät 20 arvoa. Taulukossa on rivi kullekin historialliselle ominaisuuden arvolle. Ominaisuuden tämänhetkinen arvo määräytyy ominaisuuden historian viimeisimmän UPDATEDAT-aikaleiman perusteella.

Yhdistyksen kyselyt

Kuten objektitiedot, myös assosiaatiotiedot on järjestetty kahdella tavalla:

• Yksilöllinen: Kukin assosiaatiotyyppi tallennetaan omaan tauluunsa, joka sisältää vain kyseisen tyypin tietueita. Esimerkiksi associations_contacts_to_deals sisältää vain yhteystieto- ja sopimusobjektien välisiä assosiaatiotietueita. T
• Yhdistetty: kaikkien yhdistystyyppien kaikki tietueet yhdistetään yhteen taulukkoon.

assosiaatio_x_y

Kullakin assosiaatiotyypillä on oma näkymänsä, joka on merkitty osoitteella associations_<association type name> esim. associations_contacts_to_deals.

association_definitions

Tämä taulukko sisältää tietoja kaikista HubSpot-objektien välisistä käytettävissä olevista assosiaatiotyypeistä, ja siinä on yksi rivi kutakin assosiaatiotyyppiä kohti.

property_definitions

Tämä taulukko sisältää tietoja HubSpot-tilisi objekti- ja tapahtumaominaisuuksista. Tapahtumaominaisuuksiin kuuluvat vakiotapahtumat, kuten sähköpostin avaukset ja napsautukset, sekä mukautetut käyttäytymiseen liittyvät tapahtumaominaisuudet. Nämä tiedot voivat olla hyödyllisiä määriteltäessä arvoja, jotka löytyvät object_properties- ja events-tiedoista.

Tapahtumat

Tapahtumat sisältävät HubSpotin vakiotapahtumia ja mukautettuja käyttäytymistapahtumia. Jokaisella tapahtumalla on oma taulukkonsa, joka on merkitty nimellä events_eventname.

objektin_ja_tapahtuman_tyypin_määrittelyt

Tämä taulukko sisältää kaikkien HubSpot-tililläsi käytettävissä olevien objektien ja tapahtumien määritelmät.

Synkronointitaajuus ja tietojen organisointi

Tiedot synkronoidaan päivittäin HubSpotin ja AWS S3:n välillä. Kansio luodaan jokaiselle päivälle, jolloin tiedot synkronoidaan. Kukin seuraavista taulukoista on saatavilla kansiossa, jossa on gzipatut CSV-tiedostot:

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

Kullekin taulukolle on useita alikansioita. Jos taulukon koko on yli 15 Mt, kunkin taulukkokansiossa on useita pakattuja CSV-tiedostoja.