Sådan opretter du brugerdefinerede adfærdsbegivenheder med HubSpots kodeguide

Med brugerdefinerede begivenheder kan du 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. 

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

• Send via API: Brug slutpunktet for brugerdefineret begivenhedsdefinition til at oprette din begivenhed. Derfra skal du bruge dit begivenheds-id med slutpunktet for send brugerdefineret begivenhed til at sende begivenhedsforekomster til HubSpot.
• Indsaml data fra din hjemmeside uden API:
  • Kode Javascript: Ved hjælp af brugerdefineret Javascript kan du indsætte brugerdefineret kode i dit HubSpot-sporingsscript ved hjælp af kodeditoren.
  • Brug begivenhedsvisualisator (kunMarketing Hub Enterprise ): 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 (kunDataHub Professional og Enterprise): Tilpas de betingelser, der udløser en webhook, og de data, der sendes. 

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

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 udløser begivenheden. 

Opret begivenhed via API

Hvis du sender data til HubSpot via API, kan du brugeindstillingen Send via API eller bruge slutpunktet for definition af brugerdefinerede begivenheder 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-opkald, som du kan få inde 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. Gå tilDatastyring>Begivenhedsstyring i din HubSpot-konto.
2. Klik på navnet på begivenheden. Du bliver derefter ført til siden med begivenhedsoplysninger.
3. Øverst finder du begivenhedens navn 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 vil opdatere, skal du klikke på navnet på en egenskab.
5. Klik på kodeikonet i højre panel, og se navnet under Internt navn.

Opret begivenheder med et JavaScript-kodestykke

1. Gå tilData Management>Event Management i din HubSpot-konto.
2. Klik påOpret en begivenhed øverst til højre, og vælg derefter Opret brugerdefineret begivenhed.
3. VælgKode Javascript.

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 Billetter. 

6. Klik påNæste.

Tilføj egenskaber

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å Feltetype 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 datoværdi. Du skal sende dine data i form af epokemillisekunder 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 egenskaben i højre panel:

8. Indtast et navn for 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 af værdier skal du aktivere knappenUnderstøt flerværdi.

• • • 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 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 din websides sporingskode ved at vælge Javascript-kodestykke.
11. Klik påFærdig.

Når du opretter 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. Alle brugerdefinerede egenskaber, der oprettes, vil være foruddefinerede i kodestykket. 
2. Rediger koden 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.
    
   

Importer begivenhedsdata

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. 

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

Eksempel på fil

Sådan importeres brugerdefinerede begivenheder:

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ælgImporter regneark.
4. Indtast et begivenhedsnavn, og angiv eventuelt en beskrivelse af begivenheden.
5. Vælg et Tilknyttet objekt. På nuværende tidspunkt kan begivenheder, der oprettes via import, kun knyttes til kontakter.
6. Upload filen. Vælg , hvordan objekterne skal importeres, og filens sprog, og klik derefter på Næste.
7. Knyt kolonner til begivenheds- og kontaktattributter, og klik derefter på Næste.
8. Bekræft navnet på din importfil.
9. 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.
10. Vælg datoformatet for egenskaben Forekommet kl.
11. Klik på Afslut import.

Opret begivenheder via API

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 brugerdefinerede begivenhedsegenskaber:
   • 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 linker du objekter:
   • 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.
   • Klik påTilpas matchningen, og vælg dit matchende ID mellem din begivenhed og objektposterne. Begivenheden linkes kun 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. For at spore begivenheden i HubSpot skal du klikke påKopier ud for sporings-id'et.
9. Klik påOpret begivenhed.

Opsæt 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 tredjepartswebhook, der passer nøjagtigt til en HubSpot-objektegenskab. 

Brug brugerdefinerede begivenhedsdata

Brugerdefinerede begivenhedsdata kan ses og bruges på tværs af HubSpots værktøjer. Nedenfor kan du 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 med rullemenuen med handlinger i din begivenhedsliste, visningen af enkeltbegivenheder eller øverst til højre i diagrammerne i fanen Analyse.

Rapporter om brugerdefinerede begivenheder

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

Få mere at vide om analyse af dine brugerdefinerede begivenheder.

Se begivenhedsforekomster på kontaktens tidslinje

Begivenheder vises på kontaktens tidslinje sammen med alle egenskaber, der er udfyldt.

Sådan vises begivenhedsdetaljer på kontaktens tidslinje:

1. Naviger til en kontaktpost, hvor en brugerdefineret begivenhed har fundet sted.
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 begivenhedens detaljer.

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

Brug brugerdefinerede begivenheder i arbejdsgange

I en arbejdsgang kan du udskyde baseret på brugerdefinerede begivenheder ved hjælp af en Forsink indtil begivenheden finder sted handling eller en begivenhedsregistreringsudløser.

1. På din HubSpot-konto skal du gå til Automatisering > Arbejdsgange.
2. Klik på navnet på en workflow. Eller lær, hvordan du opretter en ny workflow.
3. Sådan tilføjes en trigger:
   • Klik på Opsæt triggere i workflow-editoren.
   • Vælg Når en begivenhed opstår i venstre panel. 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 vil tilmelde i workflowet.
   • Som standard tilmeldes poster kun 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øjes en forsinkelse:
   • Klik på + plus-ikonet 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.
     • 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 begivenhedsregistreringsudløsere adskilles ved hjælp af OR-operatoren. Det betyder, at kun én af begivenhedsregistreringsudløserne skal forekomme, for at posten kan registreres i arbejdsgangen.

Workflowet vil derefter udsætte registrerede poster, indtil de opfylder de angivne brugerdefinerede begivenhedskriterier, eller vil blive udløst, når begivenheden indtræffer.