Miten luoda mukautettuja käyttäytymistapahtumia HubSpotin Code Wizard -ohjelmiston avulla?

Mukautettujen tapahtumien avulla voit määritellä ja seurata yrityksellesi ominaisia tapahtumia. Mukautetut tapahtumat voidaan liittää tapahtumien ominaisuuksiin, joita voit sitten käyttää HubSpotin työkaluissa. 

Mukautettuja tapahtumia voi luoda eri tavoin: 

• Lähetä API:n kautta: luo tapahtumakäyttämällä mukautetun tapahtuman määritelmän päätepistettä. Käytä sitten tapahtuman tunnusta mukautetun tapahtuman lähetyspäätepisteessä lähettääksesi tapahtumat HubSpotiin.
• Kerää tietoja verkkosivustoltasi ilman API:ta:
  • Javascript-koodi: Mukautetun Javascriptin avulla voit lisätä mukautetun koodin HubSpot-seurantaskriptiin koodieditorin avulla.
  • Käytä tapahtumavisualisoijaa (vainMarketing Hub Enterprise ): seuraa sivun katselukertoja tai napsautettuja elementtejä valitsemalla ne verkkosivustoltasi. Lisätietoja mukautettujen tapahtumien luomisesta tapahtumavisualisoijalla.
• Tuo taulukkolaskenta: lataa tapahtumatietojen taulukkolaskenta offline-toiminnan keräämiseksi, tietojen täyttämiseksi tai minkä tahansa työkalun manuaaliseksi integroimiseksi HubSpotiin.
• Määritä webhookit (vainDataHub Professional ja Enterprise): mukauta webhookin laukaisemisen ehtoja ja lähetettäviä tietoja. 

Huomaa: vanhassa mukautettujen tapahtumien työkalussa luodut tapahtumat eivät enää toimi 1.8.2025 jälkeen.

Tapahtuman luominen tapahtuu kahdessa vaiheessa:

• Määritä tapahtuma HubSpotissa, mukaan lukien kaikki mukautetut tapahtumaominaisuudet.
• Luo Javascript-koodinpätkä tai määritä API-kutsu, joka laukaisee tapahtuman. 

Luo tapahtuma API:n kautta

Jos lähetät tietoja HubSpotiin API:n kautta, voit käyttääLähetä API:n kautta -vaihtoehtoa tai luoda tapahtumanMukautetun tapahtuman määritelmän päätepisteen avulla. Lisätietoja API-kutsun määrittämisestä on HubSpotin kehittäjädokumentaatiossa.

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

• Tapahtuman nimi: tapahtuman sisäinen nimi. 
• Ominaisuusnimet: sisäiset nimet ominaisuuksille, joihin lähetät tietoja.

Voit luoda tapahtuman tietojen lähettämistä varten API:n kautta seuraavasti:

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

Olemassa olevan tapahtuman sisäisen nimen ja ominaisuusnimien löytäminen:

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. Löydät päivitettävien ominaisuuksien sisäiset nimet napsauttamalla ominaisuuden nimeä.
5. Napsauta oikeanpuoleisessa paneelissa koodikuvaketta ja katso nimi kohdasta Sisäinen nimi.

Luo tapahtumia Javascript-koodinpätkällä

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. Anna tapahtuman nimi ja halutessasi myös kuvaus.
5. Valitse Liitetty objekti. Näin voit liittää tapahtumasi eri objekteihin HubSpotissa, kuten yhteystietoihin, yrityksiin, kauppoihin ja lippuihin. 

6. NapsautaSeuraava.

Lisää ominaisuuksia

Kun tapahtuma luodaan, oletusarvoiset tapahtumaominaisuudet ovat käytettävissä. 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 oletusarvoisten tapahtumaominaisuuksien luomisen käytöstä kytkemälläOletustapahtumaominaisuudet 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 tavallinen tekstimerkkijono. 
   • Mukautettu numeromääritte: luo ominaisuus, joka on numeron arvo.
   • Mukautettu aikaleimamääritte: luo määritte, joka on päivämääräarvo. Sinun on lähetettävä tiedot epoch-millisekunteina tai ISO8601-muodossa.
   • Mukautettu päivämääräominaisuus: luo ominaisuus, joka on päivämääräarvo.
   • Mukautettu boolen ominaisuus: luo ominaisuus, joka on boolen arvo. 
   • Mukautettu luettelomääritte: luo ominaisuus, jossa on joukko ennalta määriteltyjä arvoja.
3. Kun olet valinnut ominaisuuden, määritä sen asetukset oikeassa paneelissa:

8. Anna ominaisuudelle nimi ja kuvaus.
   • Luettelomääritteiden osalta napsauta Seuraava ja kirjoita ominaisuuden nimikkeet ja arvot.
     • Luettelominaisuudet voivat olla yksittäisiä tai monivalintaisia. Voit ottaa monivalintaiset arvot käyttöön kytkemälläMoniarvoinen-kytkimen päälle.

• • • Sinun on asetettava arvot ja nimikkeet ennen tietojen lähettämistä niille. Jos tätä vaihetta ei suoriteta ennen luettelossa olevien tietojen lähettämistä, tietoja ei voi käyttää. Jos haluat lähettää useita arvoja API:n kautta, erota ne toisistaan 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ä.
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 seuraamiseen HubSpotissa. Kaikki luodut mukautetut ominaisuudet määritetään ennalta koodinpätkässä. 
2. Muokkaa koodinpätkää tarpeen mukaan kirjoittamalla tekstiä oikeanpuoleiseen paneeliin. Lisäämäsi koodi lisätään automaattisesti osaksi HubSpot-seurantakoodiasi.
3. Kun olet valmis, napsauta Luo lopettaaksesi tapahtuman ja aloittaaksesi seurannan automaattisesti.
    
   

Tuo tapahtumatietoja

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

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

Esimerkkitiedosto

Mukautettujen tapahtumien tuonti:

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sittenLuo mukautettu tapahtuma.
3. ValitseTuo taulukko.
4. Anna tapahtuman nimi ja halutessasi kuvaus.
5. Valitse Liitetty objekti. Tällä hetkellä tuonnin kautta luodut tapahtumat voidaan liittää vain yhteystietoihin.
6. Lataa tiedosto. Valitse, miten objektit tuodaan, ja tiedoston kieli, ja napsauta sitten Seuraava.
7. Määritä sarakkeet tapahtuman ja yhteystiedon ominaisuuksille ja napsauta Seuraava.
8. Vahvista tuontitiedoston nimi.
9. Valitse valintaruutu, jos hyväksyt, 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ännöistä.
10. Valitse Occurred at -ominaisuuden päivämäärämuoto.
11. Napsauta Lopeta tuonti.

Luo tapahtumat API:n 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. Anna tapahtuman nimi ja halutessasi myös 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.
   • Lisää halutessasikuvaus.
   • Jos haluat lisätä lisää mukautettuja ominaisuuksia, napsauta+ Lisää mukautettu ominaisuus.
   • NapsautaSeuraava.

6. Objektien linkittäminen:
   • Napsauta Valitseensisijainen objekti -pudotusvalikkoa ja valitse sitten liitetty objekti. Näin voit liittää tapahtumasi eri objekteihin, kuten yhteystietoihin, yrityksiin, kauppoihin ja lippuihin.
   • NapsautaMukauta vastaavuus ja valitse tapahtuman ja objektin tietueiden välinen vastaava tunnus. Tapahtuma linkitetään objektin tietueeseen vain, jos niiden vastaavat tunnukset ovat identtiset. Jos käytät mukautettua vastaavaa tunnusta, valitsemasi objektin ominaisuuden on oltava yksilöllinen.
7. NapsautaSeuraava.
8. Voit seurata tapahtumaa HubSpotissa napsauttamallaKopioi seurantatunnuksen vieressä.
9. NapsautaLuo tapahtuma.

Määritä webhookit

Aseta 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. Annatapahtuman nimi ja valitseliitetty objekti.
5. NapsautaSeuraava.
6. Määritä testitapahtuma:
   • KopioiWebhook-URL. 
   • Siirrywebhook-asetussivullekolmannen osapuolen sovelluksessa, jonka haluat integroida.
   • Liitä kopioitu URL-osoite.
   • Napsauta Lähetä testitapahtuma.
7. NapsautaSeuraava.
8. Tarkista webhookin ominaisuudet. NapsautaOminaisuuden tyyppi -pudotusvalikkoaja valitse ominaisuuden tyyppi. 

9. NapsautaSeuraava.
10. Valitse kolmannen osapuolen webhookista ominaisuus, joka vastaa tarkalleen HubSpot-objektin ominaisuutta. 

Käytä mukautettuja tapahtumatietoja

Mukautettuja tapahtumatietoja voi tarkastella ja käyttää HubSpotin työkaluissa. Alla kerrotaan, missä tapahtumien esiintymisiä voi tarkastella ja miten voit sisällyttää nämä tiedot muihin työkaluihin.

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

Raportoi mukautetuista tapahtumista

Mukautettujen tapahtumien esiintymisiä voidaan analysoida mukautettujen tapahtumien työkalulla, ja tapahtumadata on saatavilla myös mukautetussa raporttityökalussa ja attribuutiotiedoissa.

Lisätietoja mukautettujen tapahtumien analysoinnista.

Tapahtumien esiintymien tarkastelu kontaktien aikajanalla

Tapahtumat näkyvät kontaktin aikajanalla yhdessä täytettyjen ominaisuuksien kanssa.

Tapahtuman tietojen tarkasteleminen kontaktin aikajanalla:

1. Siirry yhteystietorekisteriin, jossa mukautettu tapahtuma on tapahtunut.
2. Voit suodattaa kontaktin aikajanan tapahtumien perusteella napsauttamalla Suodata toiminta ja valitsemalla sitten Mukautettu tapahtuma.
3. Laajenna tapahtuma kontaktin aikajanalla napsauttamalla sitä, jotta tapahtuman tiedot tulevat näkyviin.

Huomaa: et voi tarkastella aikajanan toimintaa webhookeilla luotuissa mukautetuissa tapahtumissa.

Käytä mukautettuja tapahtumia työnkuluissa

Työnkulussa voit viivästyttää mukautettujen tapahtumien perusteella käyttämällä Viivästys, kunnes tapahtuma tapahtuu -toimintoa tai tapahtuman rekisteröintikytkimen avulla.

1. Siirry HubSpot-tililläsi kohtaan Automaatio > Työnkulut.
2. Napsauta työnkulun nimeä. Tai lue, miten luodaan uusi työnkulku.
3. Lisääksesi laukaisimen:
   • Napsauta työnkulun editorissa Aseta laukaisimet.
   • Valitse vasemmasta paneelista Kun tapahtuma tapahtuu. Määritä laukaisija ja napsauta sitten Käytä suodatinta.
   • Voit tarkentaa laukaisinta napsauttamalla Lisää tarkennussuodattimia. Voit valita lisäominaisuuksia tarkentaaksesi kohteita, jotka haluat rekisteröidä työnkulkuun.
   • Oletusarvoisesti tietueet lisätään työnkulkuun vain ensimmäisellä kerralla, kun ne täyttävät lisäystriggerit. Voit ottaa uudelleenlisäyksen käyttöön valitsemalla kohdassa Pitäisikö [objekti] lisätä uudelleen tähän työnkulkuun? vaihtoehdon Kyllä, lisää uudelleen joka kerta, kun triggeri tapahtuu.
4. Viiveen lisääminen:
   • Napsauta työnkulun editorissa +-kuvaketta lisätäksesi työnkulun toiminnon.
   • Valitse oikeanpuoleisesta paneelista Viivästys, kunnes tapahtuma tapahtuu.
   • Määritä viive:
     • Napsauta Tapahtuma -pudotusvalikkoa ja valitse mukautettu tapahtuma.
     • Valitse sitten tapahtuman ominaisuus, jota haluat viivästyttää.
     • Valitse tapahtuman ominaisuuden suodatin.
     • Napsauta Käytä suodatinta.
   • • Valitse enimmäisodotusaika tai valitse Viivästys niin kauan kuin mahdollista -valintaruutu .
5. Napsauta Tallenna.

Huomaa:kaikki tapahtuman rekisteröinnin laukaisijat erotetaan toisistaan OR-operaattorilla. Tämä tarkoittaa, että vain yhden tapahtuman rekisteröinnin laukaisijan on tapahduttava, jotta tietue rekisteröidään työnkulkuun.

Työnkulku viivästää rekisteröityjä tietueita, kunnes ne täyttävät määritetyt mukautetun tapahtuman kriteerit, tai laukaisee ne, kun tapahtuma tapahtuu.