Slik oppretter du egendefinerte hendelser

Sammendrag

Bruk tilpassede hendelser i HubSpot til å 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. Du kan for eksempel ønske å spore offline-hendelser, som deltakelse på en fysisk produktlansering.

Lær deg de tre ulike metodene for å opprette tilpassede hendelser. Du kan sende tilpassede hendelser via en API, laste opp et regneark med hendelsesdata eller bruke webhooks (kunData Hub Professional og Enterprise ).

Etter at du har konfigurert en tilpasset hendelse, kan du se på dataene for den tilpassede hendelsen i forskjellige verktøy. Du kan lage rapporter med data fra tilpassede hendelser, se på forekomster av tilpassede hendelser på kontakters tidslinjer og bruke tilpassede hendelser i arbeidsflyter.

Til slutt kan du spore resultatene for dine tilpassede hendelser i verktøyet for administrasjon av tilpassede hendelser. Du må kanskje også løse ukjente egenskapsfeili verktøyet for administrasjon av tilpassede hendelser.

Hva er de ulike metodene for å opprette tilpassede hendelser?

Prosessen med å opprette hendelser består av to deler:

• Definer hendelsen i HubSpot, inkludert eventuelle tilpassede hendelsesegenskaper.
• Opprett et JavaScript-kodestykke eller definer API-kallet som vil utløse hendelsen.

Det finnes ulike måter å opprette tilpassede hendelser på: 

• Send via API: bruk endepunktet for definisjon av tilpassede hendelser til å opprette hendelsen. Derfra bruker du hendelses-ID-en din med endepunktet for sending av tilpassede hendelser 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-sporingsskriptet ved å bruke kodeditoren.
  • Bruk hendelsesvisualiserer: Spor sidevisninger eller klikkede elementer ved å velge dem på nettstedet ditt. Lær mer om å opprette tilpassede hendelser med hendelsesvisualisereren.
• Importer regneark: last opp et regneark med hendelsesdata for å registrere offlineaktivitet, fylle ut data eller manuelt integrere et hvilket som helst verktøy med HubSpot.
• Konfigurer webhooks (Data Hub Kun 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.

Hvordan oppretter jeg tilpassede hendelser ved hjelp av API-et?

Hvis du sender data til HubSpot via API, kan du brukealternativet Send via API eller bruke endepunktet for definisjon av tilpassede hendelser for å opprette hendelsen din. Les mer om hvordan du definerer API-kallet ditt i HubSpots utviklerdokumentasjon.

Du trenger noen opplysninger for API-kallet ditt, som du kan hente fra HubSpot:

• Hendelsesnavn: det interne navnet på hendelsen. 
• Egenskapsnavn: de interne navnene på egenskapene du skal sende data til.

Slik fullfører du opprettelsen av hendelsen for å sende data via API:

• Velg Send data til HubSpot og kopier sporings-ID-en.
• Klikk på Opprett.

Slik finner du det interne hendelsesnavnet for en eksisterende hendelse og egenskapsnavn:

1. I HubSpot-kontoen din går du tilDatahåndtering>Hendelseshåndtering.
2. Klikk på navnet på hendelsen. Du blir da ført til siden med detaljer om hendelsen.
3. Øverst finner du hendelsesnavnet under Internt navn. For å kopiere det interne navnet klikker du på kopieringsikonet ved siden av navnet. 
   
   
4. For å finne de interne navnene på egenskapene du skal oppdatere, klikker du på navnet på en egenskap.
5. I panelet til høyre klikker du på kodeikonet og ser deretter navnet under Internt navn.

Hvordan oppretter jeg tilpassede hendelser med JavaScript-kode?

1. I HubSpot-kontoen din går du tilDatahåndtering>Hendelseshåndtering.
2. Øverst til høyre klikker du påOpprett en hendelse, og velger deretter Opprett tilpasset hendelse.
3. Velg«Kode JavaScript».

4. Skriv inn et hendelsesnavn og legg eventuelt til en beskrivelse av hendelsen.
5. Velg et tilknyttet objekt. Dette lar deg knytte hendelsesforekomster til forskjellige objekter i HubSpot, inkludert kontakter, selskaper, avtaler og billetter. 

6. Klikkpå Neste.

Hvordan legger jeg til egenskaper i hendelsen min?

Når en hendelse opprettes, vil standardhendelsesegenskaper være tilgjengelige. Du kan også opprette dine egne tilpassede egenskaper. Hendelsesegenskaper lagres separat fra andre CRM-egenskaper og er unike for hendelsen (dvs. du kan ikke redigere disse egenskapene fra kontoinnstillingene dine). 

1. For å deaktivere opprettelsen av standardhendelsesegenskaper, slå avStandard hendelsesegenskaper.
2. For å opprette egendefinerte egenskaper velger du egenskapstypen ved å klikke på feltetypen for egenskapen. Alternativene inkluderer: 
   • Egendefinert strengegenskap: opprett en egenskap som er en ren tekststreng. 
   • Egendefinert tall-egenskap: opprett en egenskap som er en tallverdi.
   • Egendefinert tidsstempelegenskap: opprett en egenskap som er en datoverdi. Du må sende dataene dine i form av epoke-millisekunder 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.
3. Når du har valgt egenskapen, konfigurerer du den i panelet til høyre:

8. 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 flerverdier.

• • • 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 ikke dataene være tilgjengelige for bruk. For å sende flere verdier via API, skiller du dem med semikolon.

9. Klikk på Neste.
10. Etter at du har konfigurert hendelsen og egenskapene, kan du legge til denne hendelsen i sporingskoden til nettstedet ditt ved å velge Javascript-kodebit.
11. Klikk påFerdig.

Ved å opprette hendelser med et JavaScript-kodestykke kan du automatisk legge til JavaScript i HubSpot-sporingskoden din. Dette kan brukes til å registrere mer komplekse hendelsesdata som sporingskoden ikke registrerer som standard. 

1. Velg «Javascript-kodesnutt». Bruk kodesnutten i høyre panel til å spore hendelsen i HubSpot. Eventuelle tilpassede egenskaper som er opprettet, vil være forhåndsdefinert i kodesnutten. 
2. Endre utdraget etter behov ved å skrive inn tekst i panelet til høyre. All kode du legger til, blir automatisk inkludert som en del av HubSpot-sporingskoden din.
3. Når du er ferdig, klikker du på Opprett for å fullføre hendelsen og automatisk starte sporing.
    
   

Hvordan importerer jeg tilpassede hendelsesdata fra regneark?

Last opp deltakelsesdata fra fysiske arrangementer, tidsstemplede data fra apper du ikke integrerer med HubSpot, engangsdata om potensielle kunder eller kampanjer fra en leverandør, eller andre hendelsesdata i regnearkform. Hendelser lar deg registrere atferd og deretter bruke denne atferden i hele HubSpot. 

Import kan opprette og oppdatere følgende poster:

• Kontakter

• Bedrifter
• Avtaler
• Billetter
• Tjenester
• Prosjekter
• Avtaler
• Kurs
• Oppføringer 
• Bestillinger
• Tilpassede objekter

De nødvendige egenskapene varierer avhengig av objekttypen.

Hendelsesimport kan bare brukes for hendelser som allerede har funnet sted. Følgende må inkluderes i en tilpasset hendelsesimportfil:

• Kontakt-e-postadresse.
• Skjedde kl. tidsstempel. Lær mer om formatering av datoegenskaper i importfiler.

Eksempelfil

Slik importerer du tilpassede hendelser:

1. Gå til Dataadministrasjon > Organisering av arrangementer i HubSpot-kontoen din.
2. Klikk påOpprett en hendelse øverst til høyre, og velg deretterOpprett tilpasset hendelse.
3. VelgImporter regneark.
4. Klikk enten på Opprett et nytt arrangement eller Importer til et eksisterende arrangement.
   • Hvis du velger Importer til et eksisterende arrangement, bruker du rullegardinmenyen til å velge det eksisterende arrangementet, og fortsetter deretter med trinnene for å laste opp regnearket.
   • Hvis du velger Opprett et nytt arrangement, fortsetter du med trinnene nedenfor.
5. Skriv inn et Arrangementsnavn og legg eventuelt inn en beskrivelse av arrangementet.
6. Velg et tilknyttet objekt. Foreløpig kan hendelser opprettet via import kun knyttes til kontakter.
7. Last opp regnearket ditt eller lim det inn direkte fra regnearket. Velg hvordan objektene skal importeres og filens språk, og klikk deretter på Neste.
8. Knytt kolonner til hendelses- og kontaktegenskaper, og klikk deretter på Neste.
9. Bekreft navnet på importfilen.
10. Merk av i boksen for å bekrefte at kontaktene forventer å høre fra deg, og at importfilen din ikke inneholder en kjøpt liste. Les mer om HubSpots retningslinjer for akseptabel bruk.
11. Velg datoformatet for egenskapen Skjedde den.
12. Klikk på Fullfør import.

Hvordan sender jeg tilpassede hendelser via API-endepunkt?

1. I HubSpot-kontoen din navigerer du tilDatahåndtering>Hendelseshåndtering.
2. Klikk påOpprett en hendelse øverst til høyre, og velg deretterOpprett tilpasset hendelse.
3. VelgSend via API.

4. Skriv inn et navn på hendelsen, og legg eventuelt til en beskrivelse av hendelsen. 

5. Slik legger du til egenskaper for tilpassede hendelser:
   • Skriv inn etegenskapsnavn. Dette navnet vilogsåbrukes som detinterne navnet.
   • Klikk på rullegardinmenyenFelttype, og velg en felttype.
   • Du kan eventuelt legge til enbeskrivelse.
   • Hvis du vil legge til flere egendefinerte egenskaper, klikker du på+ Legg til egendefinert egenskap.
   • Klikkpå Neste.

6. Slik kobler du til 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.
   • Klikkpå Tilpass samsvaret og velg samsvarende ID mellom hendelses- og objektpostene dine. Hendelsen kobles bare til objektposten når de samsvarende ID-ene er identiske. Hvis du bruker en tilpasset samsvarende ID, må objektegenskapen du velger kreve unike verdier.
7. Klikk på«Neste».
8. For å spore hendelsen i HubSpot, klikk påKopier ved siden av sporings-ID-en.
9. Klikk påOpprett hendelse.

Hvordan oppretter jeg tilpassede hendelser ved hjelp av webhooks?

Angi betingelsene som skal utløse en webhook.

1. I HubSpot-kontoen din går du tilDatahåndtering>Hendelseshåndtering.
2. Klikk påOpprett en hendelse øverst til høyre, og velg deretterOpprett tilpasset hendelse.
3. VelgKonfigurer webhooks.
4. Skriv inn etnavn på hendelsen og velg ettilknyttet objekt.
5. Klikkpå Neste.
6. Konfigurer en testhendelse:
   • Kopierwebhook-URL-en. 
   • Gå tilinnstillingssiden for webhooksi tredjepartsappen du vil integrere med.
   • Lim inn den kopierte URL-en.
   • Klikk på Send en testhendelse.
7. Klikkpå Neste.
8. Gjennomgå egenskapene for webhooken din. Klikk pårullegardinmenyen Egenskapstypefor å velge en egenskapstype. 

9. Klikkpå Neste.
10. Velg en egenskap fra webhooken til tredjepartsleverandøren som samsvarer nøyaktig med en egenskap i et HubSpot-objekt. 

Hvor kan jeg se og bruke data fra tilpassede hendelser i HubSpot?

Data fra tilpassede hendelser kan vises og brukes i alle HubSpots verktøy. Nedenfor kan du lære hvor du kan se hendelsesforekomster og hvordan du kan integrere disse dataene i andre verktøy.

Du kan åpne de valgte hendelsene direkte i utvalgte HubSpot-verktøy ved hjelp av handlingsmenyen i hendelseslisten, visningen for enkeltstående hendelser eller øverst til høyre i diagrammene på fanen «Analyser».

Hvordan lager jeg rapporter med tilpassede hendelsesdata

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.

Les mer om hvordan du analyserer dine tilpassede hendelser.

Hvordan ser jeg gjennom hendelsesforekomster på kontaktens tidslinje?

Hendelser vises på tidslinjen for kontaktoppføringen, sammen med eventuelle egenskaper som er fylt ut.

Slik viser du hendelsesdetaljer på kontaktens tidslinje:

1. Gå til en kontaktoppføring der en tilpasset hendelse har funnet sted.
2. For å filtrere en kontakt-tidslinje etter hendelsesforekomster, klikker du på Filtrer aktivitet og velger deretter Tilpasset hendelse.
3. I kontaktens tidslinje klikker du for å utvide hendelsen og vise detaljene.

Merk: Du kan ikke se tidslinjeaktivitet for tilpassede hendelser som er opprettet ved hjelp av webhooks.

Hvordan bruker jeg tilpassede hendelser i arbeidsflyter?

I en arbeidsflyt kan du utsette basert på forekomster av tilpassede hendelser ved å bruke en Utsett til hendelsen inntreffer -handling eller en utløser for hendelsesregistrering.

1. Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
2. Klikk på navnet på en arbeidsflyt. Eller lær hvordan du oppretter en ny arbeidsflyt.
3. Slik legger du til en utløser:
   • I arbeidsflytredigereren klikker du på Konfigurer utløsere.
   • I panelet til venstre velger du Når en hendelse inntreffer. Konfigurer utløseren, og klikk deretter på Bruk filter.
   • For å finjustere utløseren ytterligere, klikk på Legg til finjusteringsfiltre. Du kan velge flere egenskaper for å finjustere objektene du ønsker å registrere i arbeidsflyten.
   • Som standard vil poster bare bli registrert i en arbeidsflyt første gang de oppfyller registreringsutløserne. For å aktivere omregistrering, velg Ja, omregistrer hver gang utløseren inntreffer under delen Bør [objekt] omregistreres i denne arbeidsflyten?
4. Slik legger du til en forsinkelse:
   • I arbeidsflytredigereren klikker du på +-ikonet for å legge til en arbeidsflythandling.
   • I panelet til høyre velger du Utsett 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 i boksen «Utsett så lenge som mulig ».
5. Klikk på Lagre.

Merk:Alle utløsere for hendelsesregistrering skilles ved hjelp av OR-operatoren. Dette betyr at bare én av utløserne for hendelsesregistrering må inntreffe for at posten skal registreres i arbeidsflyten.

Arbeidsflyten vil da utsette registrerte poster til de oppfyller de angitte kriteriene for tilpassede hendelser, eller den vil utløses når hendelsen inntreffer.

Hvordan administrerer jeg og sporer tilstanden til den tilpassede hendelsen min og overvåker leveringsfeil?

For å sikre at dataene dine forblir nøyaktige og at integrasjonene dine fungerer som forventet, kan du bruke fanen Overvåk i verktøyet for hendelsesadministrasjon.

Hvordan sporer jeg ytelsen i verktøyet for administrasjon av tilpassede hendelser?

• Fullføringstrender: Gå til Dataadministrasjon > Organisering av arrangementer i HubSpot-kontoen din. Klikk på fanen Overvåk for å sammenligne volumet av fullførte hendelser over ulike tidsperioder.

• Feilsøking av leveringsfeil: Gå til Dataadministrasjon > Organisering av arrangementer i HubSpot-kontoen din. I venstre sidefelt på fanen Overvåk velger du Leveringsfeil. Denne tabellen identifiserer hendelser som ikke ble synkronisert, og angir den spesifikke årsaken til feilen (f.eks. uoverensstemmende datatyper eller brudd på skjemaet).

Hvordan løser jeg «Ukjent egenskap»-feil i verktøyet for administrasjon av tilpassede hendelser?

Hvis data sendes via API for en egenskap som aldri ble definert i HubSpot, vil den vises i feilloggen. Du kan løse dette raskt:

1. Hold musepekeren over hendelsen i tabellen Feillogger.

2. Klikk på Handlinger, og velg deretterLegg til egenskaper til hendelse.

3. Bekreft de foreslåtte felttypene for å la HubSpot begynne å akseptere disse dataene umiddelbart.