BetaHubSpotin ja AWS S3:n yhdistäminen (BETA)
Päivitetty viimeksi: helmikuuta 14, 2025
Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:
|
Opi yhdistämään HubSpot ja AWS S3 synkronoimaan HubSpot-tiedot S3-ämpäriin.
Ennen kuin aloitat
Ennen integraation määrittämistä sinun on valittava HubSpot-tilisi Access HubSpot data in AWS S3 beta -ohjelmaan.
Yhdistä HubSpot ja AWS S3
Jos haluat yhdistää HubSpotin ja AWS S3:n, sinun on noudatettava alla olevia ohjeita järjestyksessä:
- Määritä AWS S3 -kauhan käyttöoikeudet
- Luo IAM-käytäntö
- Luo IAM-rooli AWS:ssä
- Yhdistä HubSpot ja AWS S3
- Myönnä IAM-käyttäjälle käyttöoikeudet S3-ämpärin 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 aloituskojelaudalta Services > Security, Identity, & Compliance > IAM.
- Napsauta vasemmassa sivupalkissa Account settings (Tiliasetukset).
- Etsi Security Token Service (STS ) -osiosta AWS-alue, joka vastaa aluetta, jolla AWS-tilisi sijaitsee. Aktivoi alue napsauttamalla kytkintä päälle.
- Napsauta vasemmassa sivupaneelissa Policies (Käytännöt).
- Napsauta Create policy (Luo käytäntö).
- Napsauta JSON-välilehdellä Lisää uusi lauseke.
- Lisää alla oleva käytäntöasiakirja, joka antaa HubSpotille tarvittavat oikeudet tietojen lataamiseen tai purkamiseen yhdellä ämpäri- ja kansiopolulla. Voit myös tyhjentää datatiedostot PURGE-kopiointivaihtoehdon avulla.
Huom:
- Varmista, että korvaa
<bucket>
ja<prefix>
todellisella ämpäriisi nimellä ja kansiopolun etuliitteellä.Amazonin resurssinimissä (ARN) hallituksen alueiden ämpäreille on etuliitearn:aws-us-gov:s3::::. - Asettamalla
s3:prefix
-ehdon joko ["*"] tai ["<polku>"./*"] antaa pääsyn kaikkiin etuliitteisiin määritetyssä ämpäriin tai polkuun ämpäriin vastaavasti.
{
"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 ) -osiossa käytännesäännön nimi ja valinnainen kuvaus.
- Napsauta 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 aloituskojelaudalta Services > Security, Identity, & Compliance > IAM.
- Napsauta vasemmanpuoleisessa sivupalkissa Roles (Roolit).
- Napsauta 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 käyttöoikeus.
- Valitse Require external ID (Vaadi ulkoinen tunnus ) ja syötä sijoitustunnus, kuten 0000. Muutat myöhemmin luottamussuhteen IAM-rooliin ja määrität ulkoisen ID:n tallennusintegraatiota varten. Ulkoista ID:tä käytetään, kun annetaan pääsy AWS-resursseihisi kolmannen osapuolen sovellukselle, kuten HubSpotille.
- Napsauta Seuraava.
- Valitse vaiheessa 1 luotu käytäntö ja napsauta Seuraava.
- Kirjoita Role details (Roolien tiedot ) -osioon Role name (Roolin nimi ) ja Description (Kuvaus ) roolin tunnistamiseksi.
- Napsauta Luo rooli.
- Kopioi ARN-arvo Roolien yhteenvetosivulla. Käytät tätä arvoa seuraavassa vaiheessa.
4. Yhdistä HubSpot ja AWS S3
Varmista ennen integraation asentamista, että HubSpot-tilisi on valinnut .. Pääsy HubSpotin tietoihin AWS S3:ssa beeta.- Napsauta HubSpot-tilisi ylänavigointipalkin Markkinapaikka-kuvaketta marketplace ja valitse Sovelluskauppa. Etsi ja valitse AWS S3. Voit myös siirtyä integraatioon suoraan tililläsi käyttämällä tätä URL-osoitetta.
- Valitse oikeassa yläkulmassa Asenna sovellus.
- Kirjoita vaiheessa 3 määritetty IAM-roolin nimi ja S3-URL-polku sille ämpäriin, johon haluat tiedot dumpata.
- Napsauta Seuraava.
- Tarkista ja kopioi AWS IAM User- ja AWS External ID -arvot, sillä tarvitset niitä seuraavassa vaiheessa. Napsauta sitten Continue to Connected Apps (Jatka liitettyihin sovelluksiin).
5. Myönnä IAM-käyttäjälle oikeudet käyttää kauhan objekteja
- Kirjaudu AWS Management Consoleen.
- Valitse aloituskojelaudalta Services > Security, Identity, & Compliance > IAM.
- Napsauta vasemmassa sivupalkissa Roles (Roolit).
- Valitse vaiheessa 3 luomaasi roolia.
- Valitse Luottamussuhteet-välilehti ja valitse Muokkaa luottamuskäytäntöä.
- Muokkaa asiakirjat 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
Synkronoitavissa olevat 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.
- Assosiaatiot: kaikki assosiaatiotyypit ja niihin liittyvät tietueet.
- Tapahtumat: tapahtuma sekä HubSpotin vakiotapahtumista että mukautetuista käyttäytymistapahtumista.
- Luettelot: HubSpotin yhteystieto- ja yritysluettelot.
- Omistajat: tietueiden omistajat.
- Putket: kauppaputket ja lippuputket sekä myyntiputki.
- Ominaisuudet: objektitietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuus 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: kaikkienobjektityyppienkaikkitietueet 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.
HubSpotin kohdetyyppi |
ObjectTypeId |
Kuvaus |
0-1 |
Tietoja yrityksesi kanssa vuorovaikutuksessa olevista henkilöistä |
|
0-2 |
Yksittäisiä yrityksiä tai organisaatioita koskevat tiedot |
|
0-3 |
Yksityiskohtaisia tietoja tulomahdollisuuksista kontaktin tai yrityksen kanssa. |
|
0-4 |
Tallentaa tietoja CRM-toiminnoista, mukaan lukien muistiinpanot, tehtävät, sähköpostit, kokoukset ja puhelut. |
|
0-5 |
Edustaa asiakkaan avun- tai tukipyyntöjä. |
|
0-14 |
Käytetään hinnoittelutietojen jakamiseen mahdollisten ostajien kanssa. |
|
0-15 |
HubSpot-lomakkeen yksittäisten lähetysten tiedot. |
|
0-8 |
Edustaa kaupassa myytävien tuotteiden osajoukkoa. Kun tuote liitetään kauppaan, siitä tulee rivikohta. |
|
0-11 |
Yksityiskohdat useilta kanavilta saapuvista viesteistä. |
|
0-25 |
Laskeutumissivujen tiedot |
|
0-27 |
Tallentaa tietoja tehtävälistoista |
|
0-28 |
Käytetään keräämään tietoja vierailijoista ja liidi |
|
0-29 |
Tiedot markkinointikeskuksesta tulevista sähköposteista |
|
AD_ACCOUNT |
0-30 |
Tallentaa tiedot mainostileistäsi Linkedinissä, Facebookissa ja Googlessa |
0-31 |
Tiedot kampanjat. Mainoskampanja voi sisältää yhden tai useamman mainokset |
|
AD_GROUP |
0-32 |
mainokset looginen ryhmittely mainoskampanjan sisällä |
AD |
0-33 |
Yksittäisiä mainokset koskevat tiedot |
0-35 |
Tietoa markkinointiin liittyvistä markkinointivaroista ja -sisällöstä, jotta voit helposti mitta yhteisten markkinointitoimien tehokkuutta. |
|
SIVUSTO_SIVU |
0-38 |
Tiedot yksittäisistä verkkosivujen sivuista |
0-39 |
Tiedot blogikirjoituksista |
|
0-45 |
Tietoa objektitietueiden ryhmittelystä niiden ominaisuuksien tai toimintojen perusteella |
|
0-48 |
Muiden CRM-tietueiden, esimerkiksi yhteystietojen, soittamat puhelut |
|
LASKU |
0-53 |
Laskujen hallinta ja synkronointi ulkoisten kirjanpitojärjestelmien kanssa |
0-57 |
Tiedot HubSpotiin tuoduista mediavaroista |
|
0-58 |
Sekvenssi on sarja kohdennettuja, ajoitettuja sähköpostimalleja, joiden avulla kontakteja hoidetaan ajan myötä |
|
0-72 |
Diiliosuuksia käytetään jakamaan kauppahyvityksiä useiden käyttäjien kesken |
|
0-83 |
asiakirjat muodostavat koko tiimillesi sisällön kirjaston, johon voit ladata ja jakaa asiakirjat yhteystietojesi kanssa. |
|
0-19 |
Tallentaa palautekyselyyn lähetetyt tiedot. |
|
0-69 |
Tilaukset sisältävät tiedot toistuvista maksuista |
|
0-101 |
Sisältää tietoja asiakkailta kerätyistä varoista |
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ää ominaisuus 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 kutakin historiallista ominaisuus arvoa kohden. ominaisuus tämänhetkinen arvo määräytyy ominaisuus 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 kaupanteko-objektien välisiä assosiaatiotietueita. T - Yhdistetty: Kaikkien assosiaatiotyyppien 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 tapahtuma. Tapahtuma kuuluvat vakiotapahtumat, kuten sähköpostin avaukset ja napsautukset, sekä mukautetut käyttäytymiseen liittyvät tapahtuma. 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 tapahtuma 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_[Tapahtuma 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, jokaisen taulukkokansiossa on useita puristettuja CSV-tiedostoja.