Sådan opretter du brugerdefinerede begivenheder

Oversigt

Brug brugerdefinerede begivenheder i HubSpot til at definere og spore begivenheder, der er unikke for din virksomhed. Brugerdefinerede begivenheder kan knyttes til begivenhedsegenskaber, som du derefter kan bruge på tværs af HubSpots værktøjer. Du kan f.eks. ønske at spore offlinebegivenheder, såsom deltagelse i en fysisk produktlancering.

Lær de tre forskellige metoder til at oprette brugerdefinerede begivenheder. Du kan sende brugerdefinerede begivenheder via en API, uploade et regneark med begivenhedsdata eller bruge webhooks (kunData Hub Professional og Enterprise ).

Når du har oprettet en brugerdefineret begivenhed, kan du gennemgå dataene for den på tværs af forskellige værktøjer. Du kan oprette rapporter med data fra brugerdefinerede begivenheder, se forekomster af brugerdefinerede begivenheder på kontaktpersoners tidslinjer og bruge brugerdefinerede begivenheder i arbejdsgange.

Til sidst kan du spore resultaterne af dine brugerdefinerede begivenheder i værktøjet til styring af brugerdefinerede begivenheder. Du kan også få brug for at løse fejl med ukendte egenskaberi værktøjet til styring af brugerdefinerede begivenheder.

Hvilke forskellige metoder findes der til at oprette brugerdefinerede begivenheder?

Processen til oprettelse af begivenheder består af to dele:

• Definer begivenheden i HubSpot, herunder eventuelle brugerdefinerede begivenhedsegenskaber.
• Opret et JavaScript-kodestykke, eller definer det API-kald, der skal udløse begivenheden.

Der er forskellige måder at oprette brugerdefinerede begivenheder på: 

• Send via API: Brug endpointet til definition af brugerdefinerede begivenheder til at oprette din begivenhed. Brug derefter dit begivenheds-ID sammen med endpointet til afsendelse af brugerdefinerede begivenheder til at sende begivenhedsforekomster til HubSpot.
• Indsaml data fra din hjemmeside uden API:
  • Javascript-kode: Ved hjælp af brugerdefineret Javascript kan du indsætte brugerdefineret kode i dit HubSpot-sporingsscript ved hjælp af kodeditoren.
  • Brug begivenhedsvisualisatoren: Spor sidevisninger eller elementer, der er blevet klikket på, ved at vælge dem på din hjemmeside. Få mere at vide om oprettelse af brugerdefinerede begivenheder med begivenhedsvisualisatoren.
• Importer regneark: Upload et regneark med begivenhedsdata for at indsamle offlineaktivitet, udfylde manglende data eller manuelt integrere ethvert værktøj med HubSpot.
• Opsæt webhooks (Data Hub kun Professional og Enterprise ): Tilpas de betingelser, der udløser en webhook, samt de data, der skal sendes. 

Bemærk: Begivenheder, der er oprettet i det gamle værktøj til brugerdefinerede begivenheder, vil ikke længere fungere efter den 1. august 2025.

Hvordan opretter jeg brugerdefinerede begivenheder ved hjælp af API'en?

Hvis du sender data til HubSpot via API, kan du brugeindstillingen Send via API eller bruge endpointet Custom event definition til at oprette din begivenhed. Få mere at vide om, hvordan du definerer dit API-kald, i HubSpots udviklerdokumentation.

Du skal bruge nogle oplysninger til dit API-kald, som du kan hente inde i HubSpot:

• Begivenhedsnavn: det interne navn på begivenheden. 
• Egenskabsnavne: De interne navne på de egenskaber, du vil sende data til.

Sådan færdiggør du oprettelsen af din begivenhed for at sende data via API:

• Vælg Send data til HubSpot, og kopier sporings-ID'et.
• Klik på Opret.

Sådan finder du det interne begivenhedsnavn for en eksisterende begivenhed og egenskabsnavne:

1. I din HubSpot-konto skal du gå tilDatastyring>Begivenhedsstyring.
2. Klik på navnet på begivenheden. Du bliver derefter ført til siden med begivenhedsoplysninger.
3. Øverst finder du begivenhedsnavnet under Internt navn. For at kopiere det interne navn skal du klikke på kopieringsikonet ved siden af navnet. 
   
   
4. For at finde de interne navne på de egenskaber, du skal opdatere, skal du klikke på navnet på en egenskab.
5. Klik på kodeikonet i panelet til højre, og se derefter navnet under Internt navn.

Hvordan opretter jeg brugerdefinerede begivenheder med JavaScript-kode?

1. I din HubSpot-konto skal du gå tilDatastyring>Begivenhedsstyring.
2. Klik øverst til højre påOpret en begivenhed, og vælg derefter Opret brugerdefineret begivenhed.
3. Vælg"Javascript-kode".

4. Indtast et begivenhedsnavn, og angiv eventuelt en beskrivelse af begivenheden.
5. Vælg et tilknyttet objekt. Dette giver dig mulighed for at knytte dine begivenhedsforekomster til forskellige objekter i HubSpot, herunder kontakter, virksomheder, aftaler og tickets. 

6. Klik påNæste.

Hvordan tilføjer jeg egenskaber til min begivenhed?

Når en begivenhed oprettes, vil der være standardegenskaber til rådighed. Du kan også oprette dine egne brugerdefinerede egenskaber. Begivenhedsegenskaber gemmes separat fra andre CRM-egenskaber og er unikke for begivenheden (dvs. du kan ikke redigere disse egenskaber fra dine kontoindstillinger). 

1. For at deaktivere oprettelsen af standardbegivenhedsegenskaber skal du slå "Standardbegivenhedsegenskaber " fra.
2. For at oprette brugerdefinerede egenskaber skal du vælge egenskabstypen ved at klikke på feltetypen for din egenskab. Valgmulighederne omfatter: 
   • Brugerdefineret strengegenskab: Opret en egenskab, der er en almindelig tekststreng. 
   • Brugerdefineret talegenskab: Opret en egenskab, der er en talværdi.
   • Brugerdefineret tidsstempelegenskab: Opret en egenskab, der er en dato. Du skal sende dine data i form af epoch-millisekunder eller ISO8601.
   • Brugerdefineret datoegenskab: Opret en egenskab, der er en datoværdi.
   • Brugerdefineret boolsk egenskab: Opret en egenskab, der er en boolsk værdi. 
   • Brugerdefineret opregningsegenskab: Opret en egenskab med et sæt foruddefinerede værdier.
3. Når du har valgt din egenskab, skal du konfigurere den i panelet til højre:

8. Indtast et navn på egenskaben og en beskrivelse af egenskaben.
   • For enum-egenskaber skal du klikke på Næste og indtaste egenskabens etiketter og værdier.
     • Enumerationsegenskaber kan være enkelt- eller flervalg. For at aktivere flervalg skal du slå knappenUnderstøtter flervalg til.

• • • Du skal indstille dine værdier og etiketter, før du sender data til dem. Hvis dette trin ikke er gennemført, før du sender data, der ikke er på listen, vil dataene ikke være tilgængelige til brug. For at sende flere værdier via API skal du adskille dem med et semikolon.

9. Klik på Næste.
10. Når du har konfigureret begivenheden og dens egenskaber, kan du tilføje denne begivenhed til dit websteds sporingskode ved at vælge "Javascript-kodestykke".
11. Klik på "Færdig".

Ved at oprette begivenheder med et JavaScript-kodestykke kan du automatisk tilføje JavaScript til din HubSpot-sporingskode. Dette kan bruges til at indsamle mere komplekse begivenhedsdata, som sporingskoden ikke indsamler som standard. 

1. Vælg "Javascript-kodestykke". Brug kodestykket i det højre panel til at spore begivenheden i HubSpot. Eventuelle brugerdefinerede egenskaber, der oprettes, vil være foruddefineret i kodestykket. 
2. Rediger kodestykket efter behov ved at indtaste tekst i panelet til højre. Al kode, du tilføjer, vil automatisk blive inkluderet som en del af din HubSpot-sporingskode.
3. Når du er færdig, skal du klikke på Opret for at færdiggøre din begivenhed og automatisk starte sporing.
    
   

Hvordan importerer jeg brugerdefinerede begivenhedsdata fra regneark?

Upload dine deltagerdata fra fysiske begivenheder, tidsstemplede data fra apps, som du ikke har integreret med HubSpot, engangsdata om leads eller kampagner fra en leverandør eller andre begivenhedsdata i regnearksformat. Begivenheder giver dig mulighed for at indsamle adfærdsdata og derefter anvende disse data på tværs af HubSpot. 

Import kan oprette og opdatere følgende poster:

• Kontakter

• Virksomheder
• Aftaler
• Billetter
• Tjenester
• Projekter
• Aftaler
• Kurser
• Oversigter 
• Bestillinger
• Brugerdefinerede objekter

De påkrævede egenskaber varierer afhængigt af objekttypen.

Begivenhedsimport kan kun bruges til begivenheder, der allerede har fundet sted. Følgende skal være inkluderet i en brugerdefineret begivenhedsimportfil:

• Kontakt-e-mailadresse.
• Fandt sted på tidsstemplet. Få mere at vide om formatering af datoegenskaber i importfiler.

Eksempelfil

Sådan importeres brugerdefinerede begivenheder:

1. Klik på Mere på din HubSpot-konto, og navigér derefter til Datastyring > Begivenhedsstyring. Hvis Mere ikke vises på din konto, skal du navigere direkte til Datastyring > Begivenhedsstyring.
2. Klik påOpret en begivenhed øverst til højre, og vælg derefterOpret brugerdefineret begivenhed.
3. Vælg "Importer regneark".
4. Klik enten på Opret en ny begivenhed eller Importer til en eksisterende begivenhed.
   • Hvis du vælger "Importer til en eksisterende begivenhed", skal du bruge rullemenuen til at vælge den eksisterende begivenhed og derefter fortsætte med trinene for at uploade dit regneark.
   • Hvis du vælger Opret en ny begivenhed, skal du fortsætte med trinene nedenfor.
5. Indtast et begivenhedsnavn, og angiv eventuelt en beskrivelse af begivenheden.
6. Vælg et tilknyttet objekt. På nuværende tidspunkt kan begivenheder, der oprettes via import, kun knyttes til kontakter.
7. Upload dit regneark, eller indsæt data direkte fra regnearket. Vælg, hvordan objekterne skal importeres, og vælg filens sprog, og klik derefter på " Næste".
8. Knyt kolonner til begivenheds- og kontaktegenskaber, og klik derefter på Næste.
9. Bekræft navnet på din importfil.
10. Markér afkrydsningsfeltet for at bekræfte, at kontakterne forventer at høre fra dig, og at din importfil ikke indeholder en købt liste. Få mere at vide om HubSpots politik for acceptabel brug.
11. Vælg datoformatet for egenskaben " Fandt sted den ".
12. Klik på Afslut import.

Hvordan sender jeg brugerdefinerede begivenheder via API-endpoint?

1. Gå tilDatastyring>Begivenhedsstyring i din HubSpot-konto.
2. Klik påOpret en begivenhed øverst til højre, og vælg derefterOpret brugerdefineret begivenhed.
3. VælgSend via API.

4. Indtast et begivenhedsnavn, og angiv eventuelt en beskrivelse af begivenheden. 

5. Sådan tilføjer du egenskaber til en brugerdefineret begivenhed:
   • Indtast etegenskabsnavn. Dette navn vilogsåblive anvendt som detinterne navn.
   • Klik på rullemenuen"Felttype", og vælg en felttype.
   • Du kan eventuelt tilføje enbeskrivelse.
   • Hvis du vil tilføje flere brugerdefinerede egenskaber, skal du klikke på+ Tilføj brugerdefineret egenskab.
   • Klik påNæste.

6. Sådan knytter du objekter sammen:
   • Klik på rullemenuen Vælg etprimært objekt, og vælg derefter et tilknyttet objekt. Dette giver dig mulighed for at knytte dine hændelser til forskellige objekter, herunder kontakter, virksomheder, aftaler og tickets.
   • Klikpå Tilpas matchningen, og vælg det matchende ID mellem dine begivenheds- og objektposter. Begivenheden knyttes kun til objektposten, når de matchende ID'er er identiske. Hvis du bruger et brugerdefineret matchende ID, skal den objektegenskab, du vælger, kræve unikke værdier.
7. Klik på "Næste".
8. Sådan sporer du begivenheden i HubSpot: Klik på "Kopier " ved siden af sporings-ID'et.
9. Klik påOpret begivenhed.

Hvordan opretter jeg brugerdefinerede begivenheder ved hjælp af webhooks?

Indstil de betingelser, der skal udløse en webhook.

1. Gå tilDatastyring>Begivenhedsstyring i din HubSpot-konto.
2. Klik påOpret en begivenhed øverst til højre, og vælg derefterOpret brugerdefineret begivenhed.
3. VælgKonfigurer webhooks.
4. Indtast etbegivenhedsnavn, og vælg ettilknyttet objekt.
5. Klik påNæste.
6. Opsæt en testbegivenhed:
   • Kopierwebhook-URL'en. 
   • Gå tilsiden med webhook-indstillingeri den tredjepartsapp, du vil integrere med.
   • Indsæt den kopierede URL.
   • Klik på Send en testbegivenhed.
7. Klik påNæste.
8. Gennemgå egenskaberne for din webhook. Klik pårullemenuen Egenskabstypefor at vælge en egenskabstype. 

9. Klik på»Næste«.
10. Vælg en egenskab fra din tredjeparts-webhook, der matcher en HubSpot-objektegenskab nøjagtigt. 

Hvor kan jeg se og bruge data fra brugerdefinerede begivenheder i HubSpot?

Data fra brugerdefinerede begivenheder kan ses og bruges på tværs af HubSpots værktøjer. Nedenfor kan du læse, hvor du kan se begivenhedsforekomster, og hvordan du kan integrere disse data i andre værktøjer.

Du kan åbne de valgte begivenheder direkte i udvalgte HubSpot-værktøjer via rullemenuen med handlinger i din begivenhedsliste, visningen af den enkelte begivenhed eller i øverste højre hjørne af diagrammerne på fanen "Analyser".

Hvordan opretter jeg rapporter med data fra brugerdefinerede begivenheder?

Forekomster af brugerdefinerede begivenheder kan analyseres fra værktøjet til brugerdefinerede begivenheder, og begivenhedsdata vil også være tilgængelige i værktøjet til oprettelse af brugerdefinerede rapporter og i attributionsrapporter.

Læs mere om analyse af dine brugerdefinerede begivenheder.

Hvordan gennemgår jeg begivenhedsforekomster på kontaktens tidslinje?

Begivenhedsforekomster vises på kontaktens tidslinje sammen med eventuelle egenskaber, der er udfyldt.

Sådan viser du begivenhedsdetaljer på kontaktens tidslinje:

1. Gå til en kontaktpost, hvor der er opstået en brugerdefineret begivenhed.
2. For at filtrere en kontakt-tidslinje efter hændelsesforekomster skal du klikke på " Filtrer aktivitet" og derefter vælge " Brugerdefineret hændelse".
3. Klik på begivenheden i kontaktens tidslinje for at udvide den og få vist begivenhedsdetaljerne.

Bemærk: Du kan ikke se tidslinjeaktivitet for brugerdefinerede begivenheder, der er oprettet ved hjælp af webhooks.

Hvordan bruger jeg brugerdefinerede begivenheder i arbejdsgange?

I en arbejdsgang kan du indstille en forsinkelse baseret på forekomster af brugerdefinerede begivenheder ved hjælp af en Forsink indtil begivenheden finder sted -handlingen eller en udløser for begivenhedstilmelding.

1. Klik på Mere i din HubSpot-konto, og navigér derefter til Automatisering > Arbejdsgange. Hvis Mere ikke vises på din konto, skal du navigere direkte til Automatisering > Arbejdsgange.
2. Klik på navnet på en arbejdsgang. Eller se, hvordan du opretter en ny arbejdsgang.
3. Sådan tilføjer du en trigger:
   • Klik på Opsæt triggere i workflow-editoren.
   • Vælg " Når en begivenhed opstår" i venstre panel. Konfigurer udløseren, og klik derefter på " Anvend filter".
   • For at finjustere din trigger yderligere skal du klikke på Tilføj forfiningsfiltre. Du kan vælge yderligere egenskaber for at indsnævre de objekter, du gerne vil tilmelde til arbejdsgangen.
   • Som standard inddrages poster kun i en arbejdsgang første gang, de opfylder inddragelsestriggerne. For at aktivere geninddragelse skal du under afsnittet Skal [objekt] geninddrages i denne arbejdsgang? vælge Ja, geninddrag hver gang triggeren udløses.
4. Sådan tilføjer du en forsinkelse:
   • Klik på plusikonet (+) i workflow-editoren for at tilføje en workflow-handling.
   • I panelet til højre skal du vælge " Forsink, indtil begivenheden indtræffer".
   • Konfigurer forsinkelsen:
     • Klik på rullemenuen "Begivenhed ", og vælg derefter en brugerdefineret begivenhed.
     • Vælg derefter den begivenhedsegenskab, du vil forsinke på.
     • Vælg filteret for begivenhedsegenskaben.
     • Klik på " Anvend filter".
   • • Vælg den maksimale ventetid, eller marker afkrydsningsfeltet "Forsink så længe som muligt ".
5. Klik på Gem.

Bemærk:Alle udløsere for begivenhedstilknytning adskilles ved hjælp af operatoren "ELLER". Det betyder, at kun én af udløserne for begivenhedstilknytning skal forekomme, for at posten kan tilknyttes til arbejdsgangen.

Workflowet vil derefter udskyde de tilmeldte poster, indtil de opfylder de angivne kriterier for den brugerdefinerede begivenhed, eller det vil blive udløst, når begivenheden indtræffer.

Hvordan administrerer og sporer jeg status for min brugerdefinerede begivenhed og overvåger leveringsfejl?

For at sikre, at dine data forbliver nøjagtige, og at dine integrationer fungerer som forventet, kan du bruge fanen Overvågning i værktøjet til begivenhedsstyring.

Hvordan sporer jeg ydeevnen i værktøjet til styring af brugerdefinerede begivenheder?

• Tendenser for gennemførelse: Klik på Mere på din HubSpot-konto, og navigér derefter til Datastyring > Begivenhedsstyring. Hvis Mere ikke vises på din konto, skal du navigere direkte til Datastyring > Begivenhedsstyring. Klik på fanen Overvåg for at sammenligne antallet af gennemførte begivenheder på tværs af forskellige tidsperioder.

• Fejlfinding ved leveringsfejl: Klik på Mere på din HubSpot-konto, og navigér derefter til Datastyring > Begivenhedsstyring. Hvis Mere ikke vises på din konto, skal du navigere direkte til Datastyring > Begivenhedsstyring. Vælg Leveringsfejl i venstre sidepanel på fanen Overvåg. Denne tabel identificerer begivenheder, der ikke kunne synkroniseres, og angiver den specifikke årsag til fejlen (f.eks. uoverensstemmende datatyper eller skemaovertrædelser).

Hvordan løser jeg "Unknown Property"-fejl i værktøjet til styring af brugerdefinerede begivenheder?

Hvis der via API sendes data for en egenskab, der aldrig er blevet defineret i HubSpot, vises det i fejlloggen. Du kan hurtigt løse dette:

1. Hold markøren over begivenheden i tabellen Fejllogfiler.

2. Klik på Handlinger, og vælg derefterTilføj egenskaber til begivenhed.

3. Bekræft de foreslåede felttyper, så HubSpot straks kan begynde at acceptere disse data.