- Kunnskapsdatabase
- Data
- Dataadministrasjon
- Slik oppretter du egendefinerte atferdshendelser ved hjelp av HubSpots kodeveiviser
Slik oppretter du egendefinerte atferdshendelser ved hjelp av HubSpots kodeveiviser
Sist oppdatert: 26 november 2025
Tilgjengelig med et av følgende abonnementer, unntatt der det er angitt:
-
Markedsføring Hub Enterprise
-
Salg Hub Enterprise
-
Service Hub Enterprise
-
Data Hub Enterprise
-
Content Hub Enterprise
-
Smart CRM Enterprise
Med tilpassede hendelser kan du definere og spore hendelser som er unike for din virksomhet. Tilpassede hendelser kan knyttes til hendelsesegenskaper, som du deretter kan bruke på tvers av HubSpots verktøy.
Det finnes forskjellige måter å opprette tilpassede hendelser på:
- Send via API: bruk endepunktet for definisjon av tilpasset hendelse til å opprette hendelsen. Derfra bruker du hendelses-ID-en din med endepunktet for sending av tilpasset hendelse til å sende hendelsesforekomster til HubSpot.
- Hent data fra nettstedet ditt uten API:
- Javascript-kode: ved hjelp av tilpasset Javascript kan du sette inn tilpasset kode i HubSpot-sporingskriptet ved å bruke kodeditoren.
- Bruk hendelsesvisualiserer (kunMarketing Hub Enterprise ): spor sidevisninger eller klikkede elementer ved å velge dem på nettstedet ditt. Lær mer om hvordan du oppretter tilpassede hendelser med hendelsesvisualisereren.
- Importer regneark: Last opp et regneark med hendelsesdata for å fange opp offlineaktivitet, fylle ut data eller integrere et hvilket som helst verktøy manuelt med HubSpot.
- Konfigurer webhooks (kunDataHub Professional og Enterprise): tilpass betingelsene som utløser en webhook og dataene som skal sendes.
Merk: Alle hendelser som er opprettet i det gamle verktøyet for tilpassede hendelser, vil ikke lenger fungere etter 1. august 2025.
Prosessen for å opprette hendelser består av to deler:
- Definere hendelsen i HubSpot, inkludert eventuelle tilpassede hendelsesegenskaper.
- Opprette et Javascript-kodesnipp eller definere API-kallet som vil utløse hendelsen.
Opprett hendelse via API
Hvis du sender data til HubSpot via API, kan du brukealternativet Send via API eller bruke endepunktet for definering av tilpassede hendelser til å opprette hendelsen. Les mer om hvordan du definerer API-kallet i HubSpots utviklerdokumentasjon.
Du trenger noen opplysninger for API-kallet ditt, som du kan få fra HubSpot:
- Hendelsesnavn: det interne navnet på hendelsen.
- Egenskapsnavn: de interne navnene på egenskapene du vil sende data til.
For å fullføre opprettelsen av hendelsen for å sende data via API:
- Velg Send data til HubSpot og kopier sporings-ID-en.
- Klikk på Opprett.
For å finne det interne hendelsesnavnet for en eksisterende hendelse og egenskapsnavn:
- I HubSpot-kontoen din navigerer du tilDatahåndtering>Hendelseshåndtering.
- Klikk på navnet på hendelsen. Du blir da ført til siden med detaljer om hendelsen.
- Øverst finner du hendelsens navn under Internt navn. For å kopiere det interne navnet, klikker du på kopieringsikonet ved siden av navnet.

- For å finne de interne navnene på egenskapene du skal oppdatere, klikker du på navnet på en egenskap.
- I høyre panel klikker du på kodeikonet og ser navnet under Internt navn.
Når du sender data til hendelsen din, gjelder følgende begrensninger:
- Egenskapsnavnene er begrenset til 50 tegn.
- URL- og referanseegenskaper kan motta opptil 1024 tegn, mens alle andre egenskaper kan motta opptil 256 tegn.
- Hver hendelse kan inneholde data for opptil 50 egenskaper.
- Interne egenskapsnavn må begynne med en bokstav og kun inneholde små bokstaver a-z, tall 0-9 og understreker. Egenskaper med samme interne navn etter konvertering til små bokstaver betraktes som duplikater, og kun én av egenskapene vil bli brukt etter forekomsten.
Opprett hendelser med et JavaScript-kodestykke
- I HubSpot-kontoen din går du tilDatahåndtering>Hendelseshåndtering.
- Øverst til høyre klikker du påOpprett en hendelse, og velger deretter Opprett tilpasset hendelse.
- VelgKode Javascript.
- Skriv inn et navn på hendelsen og eventuelt en beskrivelse av hendelsen.
- Velg et tilknyttet objekt. Dette lar deg knytte hendelsene dine til forskjellige objekter i HubSpot, inkludert kontakter, selskaper, avtaler og billetter.
- Klikk påNeste.
Legg til egenskaper
Når en hendelse opprettes, vil standardhendelsesegenskaper være tilgjengelige. Du kan også opprette dine egne egenskaper. Hendelsesegenskaper lagres separat fra andre CRM-egenskaper og er unike for hendelsen (dvs. du kan ikke redigere disse egenskapene fra kontoinnstillingene dine).
- For å deaktivere opprettelsen av standard hendelsesegenskaper, slå avStandard hendelsesegenskaper.
- For å opprette egendefinerte egenskaper, velg egenskapstypen ved å klikke på Feltetype for egenskapen din. Alternativene inkluderer:
- Egendefinert strengegenskap: opprett en egenskap som er en ren tekststreng.
- Egendefinert tallegenskap: Opprett en egenskap som er en tallverdi.
- Egendefinert tidsstempelegenskap: Opprett en egenskap som er en datoverdi. Du må sende dataene dine i form av epokemillisekunder eller ISO8601.
- Egendefinert datoegenskap: Opprett en egenskap som er en datoverdi.
- Egendefinert boolsk egenskap: Opprett en egenskap som er en boolsk verdi.
- Egendefinert oppregningsegenskap: Opprett en egenskap med et sett forhåndsdefinerte verdier.
- Når du har valgt egenskapen, konfigurerer du den i høyre panel:

- Skriv inn et navn for egenskapen og skriv inn en beskrivelse for egenskapen.
- For oppregningsegenskaper klikker du på Neste og skriver inn egenskapens etiketter og verdier.
- Oppregningsegenskaper kan være enkelt- eller flervalg. For å aktivere flervalg, slå på bryterenStøtt flervalg.
- For oppregningsegenskaper klikker du på Neste og skriver inn egenskapens etiketter og verdier.
-
-
- Du må angi verdier og etiketter før du sender data til dem. Hvis dette trinnet ikke er fullført før du sender data som ikke er i listen, vil dataene ikke være tilgjengelige for bruk. For å sende flere verdier via API, skiller du dem med semikolon.
-
- Klikk på Neste.
- Når du har konfigurert hendelsen og egenskapene, kan du legge til denne hendelsen i sporingskoden til nettstedet ditt ved å velge Javascript-kodebit.
- Klikk påFerdig.
Når du oppretter hendelser med et JavaScript-kodestykke, kan du automatisk legge til JavaScript i HubSpot-sporingskoden din. Dette kan brukes til å fange opp mer komplekse hendelsesdata som sporingskoden ikke fanger opp som standard.
- Velg Javascript-kodebit. Bruk kodebiten i høyre panel til å spore hendelsen i HubSpot. Alle tilpassede egenskaper som opprettes, vil være forhåndsdefinert i kodebiten.
- Endre utdraget etter behov ved å skrive inn tekst i høyre panel. All kode du legger til, blir automatisk inkludert som en del av HubSpot-sporingskoden din.
- Når du er ferdig, klikker du på Opprett for å fullføre hendelsen og automatisk starte sporing.

Importer hendelsesdata
Last opp deltakelsesdata fra fysiske hendelser, tidsstemplede data fra apper du ikke integrerer med HubSpot, engangsdata om potensielle kunder eller kampanjer fra en leverandør, eller andre hendelsesdata i regnearkformat. Hendelser lar deg registrere atferd og deretter bruke atferden på tvers av HubSpot.
Importene kan opprett og oppdatere kontaktoppføringer. Import av hendelser kan bare brukes for hendelser som allerede har funnet sted. Følgende må inkluderes i en tilpasset importfil for arrangementer:- Kontakt-e-postadresse.
- Oppstod ved tidsstempel. Lær mer om formatering av datoegenskaper i importfiler.

For å importere tilpassede hendelser:
- I HubSpot-kontoen din navigerer du tilDatahåndtering>Hendelsesadministrasjon.
- Øverst til høyre klikker du påOpprett en hendelse, og velger deretterOpprett tilpasset hendelse.
- VelgImporter regneark.
- Skriv inn et hendelsesnavn og eventuelt en beskrivelse av hendelsen.
- Velg et tilknyttet objekt. For øyeblikket kan hendelser som opprettes via import bare knyttes til kontakter.
- Last opp filen. Velg hvordan objektene skal importeres og filens språk, og klikk deretter på Neste.
- Tilordne kolonner til hendelses- og kontaktegenskaper, og klikk deretter på Neste.
- Bekreft navnet på importfilen.
- Klikk på avmerkingsboksen for å bekrefte at kontaktene forventer å høre fra deg og at importfilen ikke inneholder en kjøpt liste. Les mer om HubSpots retningslinjer for akseptabel bruk.
- Velg datoformatet for egenskapen Skjedde kl.
- Klikk på Fullfør import.
Opprett hendelser via API
- I HubSpot-kontoen din navigerer du tilDatahåndtering>Hendelsesadministrasjon.
- Øverst til høyre klikker du påOpprett en hendelse, og velger deretterOpprett tilpasset hendelse.
- VelgSend via API.
- Skriv inn et navn på hendelsen, og angi eventuelt en beskrivelse av hendelsen.
- Slik legger du til egenskaper for tilpasset hendelse:
- Skriv inn etegenskapsnavn. Dette navnet vil også brukes sominternt navn.
- Klikk på rullegardinmenyenFelttype, og velg en felttype.
- Du kan eventuelt legge til enbeskrivelse.
- Hvis du vil legge til flere egenskaper, klikker du på+ Legg til egenskap.
- Klikk påNeste.
- Slik kobler du objekter:
- Klikk på rullegardinmenyen Velg etprimærobjekt, og velg deretter et tilknyttet objekt. Dette lar deg knytte hendelsesforekomster til forskjellige objekter, inkludert kontakter, selskaper, avtaler og billetter.
- Klikk påTilpass samsvaret og velg samsvarende ID mellom hendelses- og objektoppføringene. Hendelsen kobles bare til objektoppføringen når de samsvarende ID-ene er identiske. Hvis du bruker en tilpasset samsvarende ID, må objektegenskapen du velger kreve unike verdier.
- Klikk påNeste.
- For å spore hendelsen i HubSpot, klikk påKopier ved siden av sporings-ID-en.
- Klikk påOpprett hendelse.
Merk
- Du kan bare matche hendelsesegenskaper og objektegenskaper av samme datatype.
- Om nødvendig kan du redigere den tilpassede samsvaringen senere, men du kan ikke endre det primære objektet som er valgt.
Konfigurer webhooks
Angi betingelsene som skal utløse en webhook.
- I HubSpot-kontoen din går du tilDatahåndtering>Hendelseshåndtering.
- Øverst til høyre klikker du påOpprett en hendelse, og velger deretterOpprett tilpasset hendelse.
- VelgKonfigurer webhooks.
- Skriv inn etnavn på hendelsen og velg ettilknyttet objekt.
- Klikk påNeste.
- Konfigurer en testhendelse:
- Kopierwebhook-URL-en.
- Gå tilinnstillingssiden for webhooki tredjepartsappen du vil integrere med.
- Lim inn den kopierte URL-adressen.
- Klikk på Send en testhendelse.
- Klikk påNeste.
- Gå gjennom egenskapene for webhooken din. Klikk pårullegardinmenyen Egenskapstypefor å velge en egenskapstype.
- Klikk påNeste.
- Velg en egenskap fra tredjeparts webhooken din som samsvarer nøyaktig med en HubSpot-objektegenskap.

Bruk tilpassede hendelsesdata
Tilpassede hendelsesdata kan vises og brukes på tvers av HubSpots verktøy. Nedenfor kan du lære hvor du kan se hendelser og hvordan du kan integrere disse dataene i andre verktøy.
Du kan åpne de valgte hendelsene direkte i utvalgte HubSpot-verktøy med handlingsmenyen i hendelseslisten, enkeltvisningen av hendelser eller øverst til høyre i diagrammene i analysefanen.
Rapporter om tilpassede hendelser
Tilpassede hendelser kan analyseres fra verktøyet for tilpassede hendelser, og hendelsesdata vil også være tilgjengelige i verktøyet for tilpassede rapporter og attribusjonsrapporter.
Lær mer om å analysere tilpassede hendelser.
Vis hendelser på kontaktens tidslinje
Hendelser vises på kontaktens tidslinje, sammen med eventuelle egenskaper som er fylt ut.
Slik viser du hendelsesdetaljer på kontaktens tidslinje:
- Naviger til en kontaktoppføring der en tilpasset hendelse har funnet sted.
- For å filtrere en kontakttidslinje etter hendelser, klikker du på Filtrer aktivitet og velger deretter Egendefinert hendelse.
- I kontakttidslinjen klikker du for å utvide hendelsen og vise hendelsesdetaljene.
Merk: Du kan ikke vise tidslinjeaktivitet på tilpassede hendelser som er opprettet ved hjelp av webhooks.
Bruk tilpassede hendelser i arbeidsflyter
I en arbeidsflyt kan du utsette basert på tilpassede hendelser ved å bruke en Forsink til hendelsen inntreffer handling eller en hendelsesregistreringstrigger.
- Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
- Klikk på navnet på en arbeidsflyt. Eller lær hvordan du oppretter en ny arbeidsflyt.
- Slik legger du til en utløser:
- I arbeidsflyteditoren klikker du på Konfigurer utløsere.
- I venstre panel velger du Når en hendelse inntreffer. Konfigurer utløseren, og klikk deretter på Bruk filter.
- For å finjustere utløseren ytterligere, klikker du på Legg til finjusteringsfiltre. Du kan velge flere egenskaper for å finjustere objektene du vil registrere i arbeidsflyten.
- Som standard vil poster bare registreres i en arbeidsflyt første gang de oppfyller registreringsutløserne. For å aktivere re-registrering, velg Ja, re-registrer hver gang utløseren oppstår under Skal [objekt] re-registreres i denne arbeidsflyten?
- Slik legger du til en forsinkelse:
- I arbeidsflyteditoren klikker du på +-ikonet for å legge til en arbeidsflytaksjon.
- I høyre panel velger du Forsink til hendelsen inntreffer.
- Konfigurer forsinkelsen:
- Klikk på rullegardinmenyen Hendelse, og velg deretter en tilpasset hendelse.
- Velg deretter hendelsesegenskapen du vil utsette.
- Velg filteret for hendelsesegenskapen.
- Klikk på Bruk filter.
-
- Velg maksimal ventetid, eller merk av for Utsett så lenge som mulig .
- Klikk på Lagre.
Merk:Alle hendelsesregistreringsutløsere vil bli skilt ved hjelp av OR-operatoren. Dette betyr at bare én av hendelsesregistreringsutløserne må inntreffe for at posten skal registreres i arbeidsflyten.
Arbeidsflyten vil da utsette registrerte poster til de oppfyller de angitte tilpassede hendelseskriteriene, eller vil utløses når hendelsen inntreffer.
