HubSpotin ja Google BigQueryn Yhdistäminen

Opi yhdistäminen HubSpot ja Google BigQuery, jotta voit synkronoida HubSpot-tiedot Google BigQuery -instanssiin.

Huomaa: HubSpot ei jaa HIPAA-tietoja Google BigQuerylle.

Yhdistäminen HubSpot ja BigQuery

Jos haluat yhdistäminen HubSpotin ja Google BigQueryn, sinun on suoritettava nämä vaiheet järjestyksessä:

1. Asenna Google BigQuery HubSpot sovelluskauppa
2. Luo mukautettu IAM-rooli Google Cloud Platformissa
3. Määritä mukautettu rooli Tili
4. Myönnä HubSpotin luomalle Google BigQuery tili oikeudet muokata BigQuery-taulukoita
5. Täydellinen käyttöönotto HubSpotissa

1. Asenna Google BigQuery HubSpot sovelluskauppa

On suositeltavaa, että tili ja Google BigQuery tili ovat avoinna erillisissä välilehdissä, kun yhdistät nämä kaksi sovellusta.

1. Varmista, että tili on valittuna tähän betatestiin: Pääsy HubSpotin tietoihin Google BigQueryssä.
2. Siirry tähän linkkiin ja valitse tili.
3. Napsauta oikeassa yläkulmassa Asenna sovellus.
4. Syötä Bucket URI ja Project ID.
5. Napsauta Seuraava.

6. Arvostelu ja ota huomioon Google Service- ja BigQuery-tilit, sillä tarvitset niitä seuraavassa vaiheessa. Siirry sitten Google Cloud -konsoliin ja suorita seuraava vaihe.

2. Mukautetun IAM-roolin luominen Google Cloud Platformissa

1. Kirjaudu Google Cloud -konsoliin.
2. Napsauta vasenta navigointivalikkoa ja valitse IAM & Admin > Roolit.
3. Valitse yläreunasta Create Role (Luo rooli).
4. Kirjoita roolin nimi, valinnainen kuvaus ja ID .
5. Napsauta Lisää käyttöoikeudet.

6. Valitse taulukosta seuraavat käyttöoikeudet ja napsauta Lisää:

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.luettelo

7. Napsauta Luo.

3. Myönnä Tili käyttöoikeudet Cloud Storage Buckets -palvelun käyttämiseen

1. Napsauta vasenta navigointivalikkoa ja valitse Cloud Storage > Buckets.
2. Valitse määritettävä ämpäri.
3. Napsauta Permissions-välilehteä.
4. Valitse Näytä päämiesten mukaan -välilehdellä Anna käyttöoikeus .

5. Kirjoita oikeanpuoleisessa paneelissa Uusi pääkäyttäjä -kenttään vaiheessa 1 annetun Tili nimi .

Huomaa: varmista, että määrität Tili, etkä tili.

6. Napsauta Assign roles (Roolien määrittäminen ) -osiossa pudotusvalikkoa ja valitse Custom > <role> ( Mukautettu > <rooli> ), jossa <role> on vaiheessa 2 luotu mukautettu IAM-rooli.
7. Napsauta Tallenna. Google Service tili lisätään Storage Objekti Viewer -rooliin.

4. Myönnä HubSpotin luomalle Google BigQuery Tili oikeudet muokata BigQuery-taulukoita

1. Napsauta vasenta navigointivalikkoa ja valitse IAM & Admin > IAM.
2. Napsauta Grant Access (Myönnä käyttöoikeus).
3. Kirjoita oikeassa paneelissa New principals (Uusi pääkäyttäjä ) -kenttään HubSpotin luoma Google BigQuery Tili (Google BigQuery -tili ) vaiheesta 1.
4. Napsauta Assign roles (Määritä roolit ) -osiossa pudotusvalikkoa ja valitse Custom > <role> ( Mukautettu > <rooli> ), jossa <role> on vaiheessa 2 luotu mukautettu IAM-rooli.

5. Täydellinen käyttöönotto HubSpotissa

1. Napsauta tili Jatka yhdistettyihin sovelluksiin.

2. Valitse valintaikkunassa valintaruudut ja valitse sitten Salli ja asenna.

HubSpotin ja Google BigQueryn välisen synkronoinnin dataformaatti

Synkronoitavissa olevat tiedot

Voit synkronoida seuraavat tiedot HubSpotista Google BigQueryyn:

• Kohteet: vakio- ja mukautetut kohteet, kuten yhteystiedot, yritykset, liput tai tuotteet.
• Tietueet: yksittäisten objekti tietueet.
• Assosiaatiot: kaikki yhteys ja niihin liittyvät tietueet.
• Tapahtumat: tapahtuma sekä HubSpotin vakiotapahtumista että mukautetuista käyttäytymistapahtumista.
• Luettelot: HubSpotin yhteystieto ja yritys.
• Omistajat: tietue omistajat.
• Putket: kauppa ja palvelupyyntö sekä myyntiputki.
• Ominaisuudet: objekti ominaisuudet ja niiden arvot, mukaan lukien ominaisuus historia.

Erityyppiset Objekti on järjestetty ja saatavilla kahdella tavalla:

• Yksilöllinen: kukin objektityyppi tallennetaan omaan tauluunsa, ja siinä on vain saman objektityyppi tietueita. Esimerkiksi objects_contacts sisältää vain yhteystieto.
• Yhdistetty: kaikkien objektikaikkitietueet yhdistetään yhdeksi objekti. 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 objektityyppi, mukaan lukien mukautetut objektit, on oma erityinen taulukkonsa. Nämä taulukot nimetään muotoa OBJECTS_<objektityyppi name> jossa <objektityyppi name> on objektin objecttypelomake nimike (Huomaa, että jos objektityyppi ei ole lomake, silloin <objektityyppi name> on objektityyppi nimike lomake, johon on liitetty "S").

Alla on täydellinen luettelo käytettävissä olevista objekti, 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 tietue objektityypin sisällä (esim. kaikki yhteystieto 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 kullekin historialliselle ominaisuus arvolle. ominaisuus tämänhetkinen arvo määräytyy ominaisuus historian viimeisimmän UPDATEDAT-aikaleiman perusteella.

Yhteys kyselyt

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

• Yksilöllinen: Kukin yhteys tallennetaan omaan tauluunsa, joka sisältää vain kyseisen tyypin tietueita. Esimerkiksi associations_contacts_to_deals sisältää vain yhteystieto ja kauppa välisiä yhteys. T
• Yhdistetty: Kaikkien yhteys kaikki tietueet yhdistetään yhteen taulukkoon.

assosiaatio_x_y

Kullakin yhteys on oma näkymänsä, joka on merkitty nimellä associations_<yhteys type name> esim. associations_contacts_to_deals.

association_definitions

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

property_definitions

Tämä taulukko sisältää tietoja tili objekti ja tapahtuma. Tapahtuma kuuluvat vakiotapahtumat, kuten sähköpostin avaukset ja napsautukset, sekä mukautettu käyttäytymistapahtuma. 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 tili käytettävissä olevien objektien ja tapahtumien määritelmät.

Synkronointitaajuus ja tietojen organisointi

Tietojen synkronointi alkaa päivittäin HubSpotin ja Google BigQueryn välillä klo 0600 UTC +0. Jokaiselle synkronointipäivälle luodaan kansio, jossa on useita alikansioita kullekin taulukolle. Seitsemän viimeisintä synkronointia on saatavilla Google Cloud -alustalla, ja BigQueryn taulukot päivitetään osoittamaan viimeisimpään ämpäri-dumppiin.

Kukin seuraavista taulukoista on saatavana Parquet-muotoisena tiedostona:

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