Luo mukautettuja tapahtumia

Käytä HubSpotin mukautettuja tapahtumia määrittääksesi ja seurataksesi juuri yrityksellesi ominaisia tapahtumia. Mukautetut tapahtumat voidaan liittää tapahtuman ominaisuuksiin, joita voit sitten hyödyntää kaikissa HubSpotin työkaluissa. Voit esimerkiksi seurata offline-tapahtumia, kuten osallistumista paikan päällä järjestettävään tuotelaunchiin.

Tutustu kolmeen eri tapaan luoda mukautettuja tapahtumia. Voit lähettää mukautettuja tapahtumia API:n kautta, ladata taulukon, joka sisältää tapahtumatiedot, tai käyttää webhookeja (vainData Hub Professional- ja Enterprise-versioissa ).

Kun olet määrittänyt mukautetun tapahtuman, voit tarkastella sen tietoja eri työkaluissa. Voit luoda raportteja mukautettujen tapahtumien tiedoista, tarkastella tapahtumien esiintymisiä kontaktien aikajanoilla ja käyttää mukautettuja tapahtumia työnkuluissa.

Seuraa lopuksi mukautettujen tapahtumien suorituskykyä mukautettujen tapahtumien hallintatyökalussa. Saatat joutua myös korjaamaan tuntemattomia ominaisuusvirheitä mukautettujen tapahtumien hallintatyökalussa. 

Eri menetelmät mukautettujen tapahtumien luomiseen

Tapahtuman luominen koostuu kahdesta osasta:

• Määrittämällä tapahtuman HubSpotissa, mukaan lukien mahdolliset mukautetut tapahtumaominaisuudet.
• Luo JavaScript-koodinpätkä tai määritä API-kutsu, joka laukaisee tapahtuman.

Mukautettuja tapahtumia voidaan luoda eri tavoin: 

• Lähetä API:n kautta: luo tapahtuma käyttämällä mukautetun tapahtuman määrittelypäätepistettä. Käytä sen jälkeen tapahtuman tunnusta mukautetun tapahtuman lähetyspäätepisteessä lähettääksesi tapahtumat HubSpotille.
• Kerää tietoja verkkosivustoltasi ilman API:ta:
  • Javascript-koodi: mukautetun Javascriptin avulla voit lisätä mukautettua koodia HubSpot-seurantaskriptiin koodieditorin avulla.
  • Käytä tapahtumien visualisointityökalua: seuraa sivun katselukertoja tai napsautettuja elementtejä valitsemalla ne verkkosivustoltasi. Lue lisää mukautettujen tapahtumien luomisesta tapahtumien visualisointityökalun avulla.
• Tuo taulukkolaskentaohjelma: lataa taulukkolaskentaohjelma, jossa on tapahtumatietoja, kerätäksesi offline-toimintaa, täyttääksesi puuttuvia tietoja tai integroidaaksesi minkä tahansa työkalun manuaalisesti HubSpotin kanssa.
• Määritä webhookit (Data Hub vain Professional- ja Enterprise-versioissa ): mukauta ehdot, jotka laukaisevat webhookin, sekä lähetettävät tiedot. 

Huomaa: vanhassa mukautettujen tapahtumien hallintatyökalussa luodut tapahtumat eivät enää toimi 1. elokuuta 2025 jälkeen.

Mukautettujen tapahtumien luominen API:n avulla

Jos lähetät tietoja HubSpotille API:n kautta, voit käyttääLähetä API:n kautta -vaihtoehtoa kohdass tai luoda tapahtuman Custom event definition -päätelaitteenavulla . Lisätietoja API-kutsun määrittämisestä löytyy HubSpotin kehittäjädokumentaatiosta.

Tarvitset API-kutsua varten muutamia tietoja, jotka saat HubSpotista:

• Tapahtuman nimi: tapahtuman sisäinen nimi. 
• Ominaisuuksien nimet: niiden ominaisuuksien sisäiset nimet, joihin lähetät tietoja.

Voit viimeistellä tapahtuman luomisen tietojen lähettämiseksi API:n kautta seuraavasti:

• Valitse ”Lähetä tiedot HubSpotille” ja kopioi seurantatunnus.
• Napsauta Luo.

Voit etsiä olemassa olevan tapahtuman sisäisen nimen ja ominaisuusnimet seuraavasti:

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta tapahtuman nimeä. Siirryt tapahtuman tietosivulle.
3. Etsi yläosasta tapahtuman nimi kohdasta Sisäinen nimi. Kopioi sisäinen nimi napsauttamalla nimen vieressä olevaa kopiointikuvaketta. 
   
   
4. Voit etsiä päivitettävien ominaisuuksien sisäiset nimet napsauttamalla ominaisuuden nimeä.
5. Napsauta oikeanpuoleisessa paneelissa koodikuvaketta ja tarkastele nimeä kohdassa Sisäinen nimi.

Luo mukautettuja tapahtumia JavaScript-koodilla

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sitten Luo mukautettu tapahtuma.
3. ValitseKoodi: JavaScript.

4. Syötä Tapahtuman nimi ja kirjoita halutessasi tapahtuman kuvaus.
5. Valitse Liitetty objekti. Tämän avulla voit liittää tapahtumasi eri objekteihin HubSpotissa, kuten yhteyshenkilöihin, yrityksiin, kauppoihin ja tiketteihin. 

6. NapsautaSeuraava.

Lisää ominaisuuksia tapahtumaan

Kun tapahtuma luodaan, käytettävissä on oletusarvoisia tapahtumaominaisuuksia. Voit myös luoda omia mukautettuja ominaisuuksia. Tapahtumaominaisuudet tallennetaan erillään muista CRM-ominaisuuksista, ja ne ovat tapahtumakohtaisia (eli et voi muokata näitä ominaisuuksia tilisi asetuksista). 

1. Voit poistaa oletustapahtumaominaisuuksien luomisen käytöstä kytkemälläOletustapahtumaominaisuudet- asetuksen pois päältä.
2. Voit luoda mukautettuja ominaisuuksia valitsemalla ominaisuuden tyypin napsauttamalla ominaisuuden Kenttätyyppi-kohtaa. Vaihtoehtoja ovat: 
   • Mukautettu merkkijono-ominaisuus: luo ominaisuus, joka on pelkkää tekstiä sisältävä merkkijono. 
   • Mukautettu numeromuuttuja: luo muuttuja, joka on numeron arvo.
   • Mukautettu aikaleimapominaisuus: luo ominaisuus, joka on päivämääräarvo. Tiedot on lähetettävä epookkimillisekunteina tai ISO8601-muodossa.
   • Mukautettu päivämääräominaisuus: luo ominaisuus, joka on päivämääräarvo.
   • Mukautettu boolean-ominaisuus: luo ominaisuus, joka on boolean-arvo. 
   • Mukautettu luettelomääritteen ominaisuus: luo ominaisuus, jossa on joukko ennalta määriteltyjä arvoja.
3. Kun olet valinnut ominaisuuden, määritä sen asetukset oikeanpuoleisessa paneelissa:

8. Anna ominaisuudelle nimi ja kirjoita kuvaus.
   • Luettelomääritteiden osalta napsauta Seuraava ja syötä määritteen nimikkeet ja arvot.
     • Luettelomääritteet voivat olla yksittäisiä tai monivalintaisia. Ota monivalinta käyttöön kytkemälläTukee moniarvoa -kytkin päälle.

• • • Sinun on määritettävä arvot ja nimikkeet ennen tietojen lähettämistä niihin. Jos tätä vaihetta ei suoriteta ennen luettelossa olemattomien tietojen lähettämistä, tietoja ei voi käyttää. Jos haluat lähettää useita arvoja API:n kautta, erota ne puolipisteellä.

9. Napsauta Seuraava.
10. Kun olet määrittänyt tapahtuman ja sen ominaisuudet, voit lisätä tämän tapahtuman verkkosivustosi seurantakoodiin valitsemalla Javascript-koodinpätkän.
11. NapsautaValmis.

Tapahtumien luominen JavaScript-koodinpätkällä mahdollistaa JavaScriptin lisäämisen HubSpot-seurantakoodiin automaattisesti. Tätä voidaan käyttää monimutkaisempien tapahtumatietojen keräämiseen, joita seurantakoodi ei kerää oletusarvoisesti. 

1. Valitse JavaScript-koodinpätkä. Käytä oikean paneelin koodinpätkää tapahtuman seurantaan HubSpotissa. Mahdolliset luodut mukautetut ominaisuudet määritetään valmiiksi koodinpätkässä. 
2. Muokkaa koodinpätkää tarpeen mukaan kirjoittamalla tekstiä oikeanpuoleiseen paneeliin. Lisäämäsi koodi sisällytetään automaattisesti osaksi HubSpot-seurantakoodiasi.
3. Kun olet valmis, napsauta Luo, jolloin tapahtuma valmistuu ja seuranta alkaa automaattisesti.
    
   

Tuo mukautettuja tapahtumatietoja taulukoista

Lataa taulukkomuodossa olevat osallistumistiedot fyysisistä tapahtumista, aikaleimattuja tietoja sovelluksista, joita et ole integroinut HubSpotiin, kertaluonteisia liidi- tai kampanjatietoja toimittajalta tai mitä tahansa muita tapahtumatietoja. Tapahtumien avulla voit kerätä käyttäytymistietoja ja käyttää niitä sitten koko HubSpotissa. 

Tuonnin avulla voidaan luoda ja päivittää seuraavia tietueita:

• Yhteystiedot

• Yritykset
• Kaupat
• Liput
• Palvelut
• Projektit
• Tapaamiset
• Kurssit
• Luettelot 
• Tilaukset
• Mukautetut objektit

Vaaditut ominaisuudet vaihtelevat objektityypin mukaan.

Tapahtumien tuontia voidaan käyttää vain jo tapahtuneisiin tapahtumiin. Mukautetun tapahtuman tuontitiedostossa on oltava seuraavat tiedot:

• Yhteyshenkilön sähköpostiosoite.
• Tapahtui aikaleimalla. Lue lisää päivämääräominaisuuksien muotoilusta tuontitiedostoissa.

Esimerkkitiedosto

Mukautettujen tapahtumien tuominen:

1. Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Tietojenhallinta > Tapahtumanhallinta. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Tietojenhallinta > Tapahtumanhallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sittenLuo mukautettu tapahtuma.
3. ValitseTuo taulukko.
4. Napsauta joko Luo uusi tapahtuma tai Tuo olemassa olevaan tapahtumaan.
   • Jos valitset Tuo olemassa olevaan tapahtumaan, valitse avattavasta valikosta olemassa oleva tapahtuma ja jatka sitten taulukon lataamista koskevien ohjeiden mukaisesti.
   • Jos valitset Luo uusi tapahtuma, jatka alla olevien ohjeiden mukaisesti.
5. Kirjoita Tapahtuman nimi ja anna halutessasi tapahtuman kuvaus.
6. Valitse liitetty kohde. Tällä hetkellä tuonnin kautta luodut tapahtumat voidaan liittää vain yhteystietoihin.
7. Lataa taulukkolaskenta tai liitä tiedot suoraan taulukkolaskennasta. Valitse, miten objektit tuodaan, ja tiedoston kieli, ja napsauta sitten Seuraava.
8. Määritä sarakkeiden vastaavuudet tapahtuman ja yhteyshenkilön ominaisuuksiin ja napsauta sitten Seuraava.
9. Vahvista tuontitiedoston nimi.
10. Napsauta valintaruutua hyväksyäksesi, että yhteyshenkilöt odottavat sinulta yhteydenottoa ja että tuontitiedostosi ei sisällä ostettua luetteloa. Lue lisää HubSpotin hyväksyttävän käytön käytänteistä.
11. Valitse Tapahtui- ominaisuuden päivämäärämuoto.
12. Napsauta Viimeistele tuonti.

Lähetä mukautetut tapahtumat API-päätelaitteen kautta

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sittenLuo mukautettu tapahtuma.
3. ValitseLähetä API:n kautta.

4. Syötä tapahtuman nimi ja anna halutessasi tapahtuman kuvaus. 

5. Voit lisätä mukautettuja tapahtumaominaisuuksia seuraavasti:
   • Kirjoitaominaisuuden nimi. Tätä nimeä käytetäänmyös sisäisenä nimenä.
   • NapsautaKenttätyyppi -pudotusvalikkoa ja valitse kenttätyyppi.
   • Voit halutessasi lisätäkuvauksen.
   • Jos haluat lisätä lisää mukautettuja ominaisuuksia, napsauta+ Lisää mukautettu ominaisuus.
   • NapsautaSeuraava.

6. Objektien linkittäminen:
   • Napsauta Valitseensisijainen objekti -pudotusvalikkoa ja valitse sitten liitettävä objekti. Näin voit liittää tapahtumasi eri objekteihin, kuten yhteyshenkilöihin, yrityksiin, kauppoihin ja tiketteihin.
   • NapsautaMukauta vastaavuutta ja valitse vastaava tunniste tapahtuma- ja objektitietueiden välillä. Tapahtuma linkittyy objektitietueeseen vain, jos niiden vastaavat tunnukset ovat identtiset. Jos käytät mukautettua vastaavuustunnusta, valitsemasi objektin ominaisuuden on vaadittava ainutlaatuisia arvoja.
7. Objektittoman tapahtuman luominen:
   
   • Napsauta Valitseensisijainen objekti -pudotusvalikkoa ja valitse sittenEi objektia. Tämä luo tapahtuman, jossa tapahtumien esiintymiä ei liitetä CRM-tietueisiin. Voit käyttää tapahtumaa työnkulkujen käynnistämiseen Agentic-automaatiosuunnittelutyökalussa.

6. NapsautaSeuraava.
7. Voit seurata tapahtumaa HubSpotissa napsauttamalla seurantatunnuksen vieressä olevaaKopioi-painiketta.
8. NapsautaLuo tapahtuma.

Luo mukautettuja tapahtumia webhookien avulla

Määritä ehdot, jotka laukaisevat webhookin.

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sittenLuo mukautettu tapahtuma.
3. ValitseMääritä webhookit.
4. SyötäTapahtuman nimi ja valitseLiitetty objekti.
5. NapsautaSeuraava.
6. Määritä testitapahtuma:
   • Kopioiwebhook-URL-osoite. 
   • Siirrywebhook-asetussivullesiinä kolmannen osapuolen sovelluksessa, johon haluat integroida webhookin.
   • Liitä kopioitu URL-osoite.
   • Napsauta Lähetä testitapahtuma.
7. NapsautaSeuraava.
8. Objektien linkittäminen:
   • Tarkista webhookin ominaisuudet. Napsauta Ominaisuustyyppi-pudotusvalikkoaja valitse ominaisuustyyppi. 
   • NapsautaSeuraava.
   • Valitse kolmannen osapuolen webhookista ominaisuus, joka vastaa tarkalleen HubSpot-objektin ominaisuutta. 

9. Objektittoman tapahtuman luominen:
   
   • Napsauta Valitseensisijainen objekti -pudotusvalikkoa ja valitse sittenEi objektia. Tämä luo tapahtuman, jossa tapahtumien esiintymiä ei liitetä CRM-tietueisiin. Voit käyttää tapahtumaa työnkulkujen käynnistämiseen Agentic-automaatiosuunnittelutyökalussa.
10. Napsauta oikeassa yläkulmassa Luo tapahtuma.

Tarkista ja käytä mukautettujen tapahtumien tietoja HubSpotissa

Mukautettujen tapahtumien tietoja voi tarkastella ja käyttää kaikissa HubSpotin työkaluissa. Alla kerrotaan, mistä voit tarkastella tapahtumien esiintymisiä ja miten voit hyödyntää näitä tietoja muissa työkaluissa.

Voit avata valitsemasi tapahtumat suoraan tietyissä HubSpot-työkaluissa tapahtumaluettelon toimintojen pudotusvalikosta, yksittäisen tapahtuman näkymästä tai Analysoi-välilehden kaavioiden oikeasta yläkulmasta.

Luo raportteja mukautettujen tapahtumien tiedoilla

Mukautettujen tapahtumien esiintymisiä voidaan analysoida mukautettujen tapahtumien työkalussa, ja tapahtumatiedot ovat käytettävissä myös mukautetun raportin luontityökalussa ja attribuutioraporteissa.

Lue lisää mukautettujen tapahtumien analysoinnista.

Tarkastele tapahtumia kontaktien aikajanoilla

Tapahtumat näkyvät kontaktitietueen aikajanalla yhdessä niiden ominaisuuksien kanssa, jotka on täytetty.

Voit tarkastella tapahtuman tietoja kontaktin aikajanalla seuraavasti:

1. Siirry yhteystietotietueeseen, jossa mukautettu tapahtuma on tapahtunut.
2. Voit suodattaa kontaktin aikajanaa tapahtumien mukaan napsauttamalla Suodata toimintaa ja valitsemalla sitten Mukautettu tapahtuma.
3. Laajenna tapahtuma kontaktin aikajanalla napsauttamalla sitä, jolloin tapahtuman tiedot tulevat näkyviin.

Huomaa: et voi tarkastella aikajanan tapahtumia webhookien avulla luoduissa mukautetuissa tapahtumissa.

Käytä mukautettuja tapahtumia työnkuluissa

Työnkulussa voit viivästyttää toimintoja mukautettujen tapahtumien perusteella käyttämällä Viivytä, kunnes tapahtuma tapahtuu -toimintoa tai tapahtuman rekisteröintilaukaisinta.

1. Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Automaatio > Työnkulut. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Automaatio > Työnkulut.
2. Napsauta työnkulun nimeä. Tai lue, miten luodaan uusi työnkulku.
3. Lisää laukaisija seuraavasti:
   • Napsauta työnkulun muokkausnäkymässä Määritä laukaisijat.
   • Valitse vasemmasta paneelista Kun tapahtuma tapahtuu. Määritä laukaisija ja napsauta sitten Käytä suodatinta.
   • Voit tarkentaa laukaisijaa edelleen napsauttamalla Lisää tarkennussuodattimia. Voit valita lisäominaisuuksia tarkentaaksesi kohteita, jotka haluat liittää työnkulkuun.
   • Oletusarvoisesti tietueet liitetään työnkulkuun vain ensimmäisellä kerralla, kun ne täyttävät liittämisen laukaisuehdot. Jos haluat ottaa uudelleenliittämisen käyttöön, valitse kohdassa Pitäisikö [objekti] liittää uudelleen tähän työnkulkuun? vaihtoehto Kyllä, liitä uudelleen aina, kun laukaisija laukeaa.
4. Viiveen lisääminen:
   • Napsauta työnkulun muokkausnäkymässä +-kuvaketta lisätäksesi työnkulun toiminnon.
   • Valitse oikeanpuoleisesta paneelista Viivytä, kunnes tapahtuma tapahtuu.
   • Määritä viive:
     • Napsauta Tapahtuma -pudotusvalikkoa ja valitse sitten mukautettu tapahtuma.
     • Valitse sitten tapahtuman ominaisuus, jonka perusteella viivettä haluat asettaa.
     • Valitse suodatin tapahtuman ominaisuudelle.
     • Napsauta Käytä suodatinta.
   • • Valitse enimmäisodotusaika tai valitse Viivytä niin kauan kuin mahdollista -valintaruutu .
5. Napsauta Tallenna.

Huomaa:kaikki tapahtuman rekisteröintikynnykset erotetaan toisistaan OR-operaattorilla. Tämä tarkoittaa, että vain yhden tapahtuman rekisteröintikynnyksen on täytyttävä, jotta tietue rekisteröityy työnkulkuun.

Työnkulku viivästää sitten liitettyjä tietueita, kunnes ne täyttävät määritetyt mukautetun tapahtuman kriteerit, tai se laukeaa, kun tapahtuma tapahtuu.

Seuraa mukautettujen tapahtumien tilaa ja valvo toimitusvirheitä

Varmistaaksesi, että tietosi pysyvät tarkkoina ja integraatiosi toimivat odotetusti, voit käyttää Tapahtumien hallinta -työkalun Seuranta- välilehteä.

Seuraa suorituskykyä mukautetun tapahtumanhallintatyökalussa

• Suorittamisen trendit: Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Tietojenhallinta > Tapahtumanhallinta. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Tietojenhallinta > Tapahtumanhallinta. Napsauta Monitor-välilehteä vertaillaksesi tapahtumien suorittamismääriä eri ajanjaksojen välillä.

• Toimitusvirheiden vianmääritys: Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Tietojenhallinta > Tapahtumanhallinta. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Tietojenhallinta > Tapahtumanhallinta. Valitse Monitor-välilehden vasemmasta sivupalkista Delivery errors. Tässä taulukossa näkyvät tapahtumat, joiden synkronointi epäonnistui, sekä epäonnistumisen tarkka syy (esim. yhteensopimattomat tietotyypit tai skeemarikkomukset).

Korjaa ”Unknown Property” -virheet mukautettujen tapahtumien hallintatyökalussa

Jos API:n kautta lähetetään tietoja ominaisuudesta, jota ei ole koskaan määritelty HubSpotissa, se näkyy virhelokissa. Voit korjata tämän nopeasti:

1. Vie hiiri tapahtuman päälle Virhelokit -taulukossa.

2. Napsauta Toiminnot ja valitse sittenLisää ominaisuuksia tapahtumaan.

3. Vahvista ehdotetut kenttätyypit, jotta HubSpot voi alkaa hyväksyä kyseiset tiedot välittömästi.