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, gennemgå 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 ukendte egenskabsfejli værktøjet til styring af brugerdefinerede begivenheder.

Hvilke forskellige metoder findes der til at oprette brugerdefinerede begivenheder?

Processen med at oprette 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 slutpunktet for definition af brugerdefinerede begivenheder til at oprette din begivenhed. Brug derefter dit begivenheds-ID med slutpunktet for 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 klikkede elementer 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 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, og de data, der sendes. 

Bemærk: Begivenheder, der er oprettet i det gamle værktøj til brugerdefinerede begivenheder, vil ikke længere fungere efter 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 slutpunktet Custom event definition til at oprette din begivenhed. Få mere at vide om, hvordan du definerer dit API-opkald, i HubSpots udviklerdokumentation.

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

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

Sådan afslutter 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 begivenhedsdetaljer.
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. Gå tilDatastyring>Begivenhedsstyring i din HubSpot-konto.
2. Klik påOpret en begivenhed øverst til højre, og vælg derefter Opret brugerdefineret begivenhed.
3. VælgKod Javascript.

4. Indtast et Begivenhedsnavn, og angiv eventuelt en beskrivelse af din begivenhed.
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 standardbegivenhedsegenskaber være tilgængelige. 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å Felt-typen 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 til egenskaben og indtast en beskrivelse for egenskaben.
   • For opregningsegenskaber skal du klikke på Næste og indtaste dine egenskabsbetegnelser og værdier.
     • Enumerationsegenskaber kan være enkelt- eller flervalg. For at aktivere flervalg skal du slå knappenUnderstøt flerværdier til.

• • • Du skal indstille dine værdier og etiketter, før du sender data til dem. Hvis dette trin ikke er afsluttet, før du sender data, der ikke er på listen, vil dataene ikke være tilgængelige. 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 højre panel til at spore begivenheden i HubSpot. Eventuelle brugerdefinerede egenskaber, der oprettes, vil være foruddefineret i kodestykket. 
2. Rediger uddraget 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 afslutte din begivenhed og automatisk starte sporing.
    
   

Hvordan importerer jeg brugerdefinerede begivenhedsdata fra regneark?

Upload dine deltagelsesdata fra fysiske begivenheder, tidsstemplede data fra apps, som du ikke integrerer med HubSpot, engangs-lead- eller kampagnedata fra en leverandør eller andre begivenhedsdata i regnearksform. Begivenheder giver dig mulighed for at indsamle adfærdsdata og derefter bruge 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 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 kl. Læs mere om formatering af datoegenskaber i importfiler.

Eksempelfil

Sådan importeres brugerdefinerede begivenheder:

1. På din HubSpot-konto skal du gå til Datahåndtering > Event Management.
2. Klik påOpret en begivenhed øverst til højre, og vælg derefterOpret brugerdefineret begivenhed.
3. VælgImporter 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 nedenstående trin.
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 direkte fra dit regneark. Vælg, hvordan objekterne skal importeres, og filsproget, 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. Klik på afkrydsningsfeltet for at acceptere, 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. I din HubSpot-konto skal du gå tilDatastyring>Begivenhedsstyring.
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å rullemenuenFelt type, 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 begivenhedsforekomster til forskellige objekter, herunder kontakter, virksomheder, aftaler og billetter.
   • Klikpå Tilpas matchningen, og vælg dit matchende ID mellem dine begivenheds- og objektposter. Begivenheden vil kun blive knyttet til objektposten, når deres 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 udløser 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ælgOpsæt 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-objektets egenskab 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 dine 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 brugerdefinerede begivenhedsdata?

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.

Få mere at vide 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 vises 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 begivenhedsforekomster skal du klikke på Filtrer aktivitet og derefter vælge Brugerdefineret begivenhed.
3. Klik på begivenheden i kontaktens tidslinje for at udvide den og få vist begivenhedsdetaljerne.

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

Hvordan bruger jeg brugerdefinerede begivenheder i arbejdsgange?

I en arbejdsgang kan du udskyde handlinger baseret på forekomster af brugerdefinerede begivenheder ved hjælp af en Forsink indtil begivenhed finder sted -handling eller en begivenhedstilmeldingsudløser.

1. På din HubSpot-konto skal du gå 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.
   • I venstre panel skal du vælge Når en begivenhed opstår. Konfigurer triggeren, og klik derefter på Anvend filter.
   • For at finjustere din trigger yderligere skal du klikke på Tilføj finjusteringsfiltre. Du kan vælge yderligere egenskaber for at finjustere de objekter, du gerne vil tilmelde til arbejdsgangen.
   • Som standard tilmeldes poster kun til en arbejdsgang, første gang de opfylder tilmeldingstriggerne. For at aktivere genindmeldelse skal du under afsnittet Skal [objekt] genindmeldes i denne arbejdsgang? vælge Ja, genindmeld hver gang triggeren opstår.
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 begivenhed finder sted.
   • 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 begivenhedsregistreringstriggere adskilles ved hjælp af OR-operatoren. Det betyder, at kun én af begivenhedsregistreringstriggerne skal forekomme, for at posten kan registreres i 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 jeg og sporer min brugerdefinerede begivenheds status 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åg i værktøjet Begivenhedsstyring.

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

• Tendenser for gennemførelse: På din HubSpot-konto skal du gå til Datahåndtering > Event Management. Klik på fanen Overvåg for at sammenligne antallet af gennemførte begivenheder på tværs af forskellige tidsperioder.

• Fejlfinding af leveringsfejl: På din HubSpot-konto skal du gå til Datahåndtering > Event Management. 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 administration af brugerdefinerede begivenheder?

Hvis der sendes data via API 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 Fejllog.

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.