Så här skapar du anpassade beteendehändelser med HubSpots kodguide

Med anpassade händelser kan du definiera och spåra händelser som är unika för ditt företag. Anpassade händelser kan kopplas till händelseegenskaper, som du sedan kan använda i HubSPots verktyg. 

Det finns olika sätt att skapa anpassade händelser: 

• Skicka via API: använd slutpunkten för anpassad händelsedefinition för att skapa din händelse. Därifrån använder du ditt händelse-ID med slutpunkten för att skicka anpassade händelser för att skicka händelseinträffar till HubSpot.
• Samla in data från din webbplats utan API:
  • Kod Javascript: med hjälp av anpassad Javascript kan du infoga anpassad kod i ditt HubSpot-spårningsskript med hjälp av kodredigeraren.
  • Använd händelsevisualiseraren (endastMarketing Hub Enterprise ): spåra sidvisningar eller klickade element genom att välja dem på din webbplats. Läs mer om hur du skapar anpassade händelser med händelsevisualiseraren.
• Importera kalkylblad: ladda upp ett kalkylblad med händelsedata för att samla in offlineaktivitet, fylla i data eller manuellt integrera valfritt verktyg med HubSpot.
• Konfigurera webhooks (endastDataHub Professional och Enterprise): anpassa villkoren som utlöser en webhook och de data som ska skickas. 

Observera: alla händelser som skapats i det gamla verktyget för anpassade händelser kommer inte längre att fungera efter den 1 augusti 2025.

Processen för att skapa händelser består av två delar:

• Definiera händelsen i HubSpot, inklusive eventuella anpassade händelseegenskaper.
• Skapa ett Javascript-kodavsnitt eller definiera API-anropet som kommer att utlösa händelsen. 

Skapa händelse via API

Om du skickar data till HubSpot via API kan du användaalternativet Skicka via API eller använda slutpunkten för definition av anpassade händelser för att skapa din händelse. Läs mer om hur du definierar ditt API-anrop i HubSpots utvecklardokumentation.

Du behöver några uppgifter för ditt API-anrop, som du kan hämta inifrån HubSpot:

• Händelsens namn: det interna namnet på händelsen. 
• Egenskapsnamn: de interna namnen på de egenskaper som du kommer att skicka data till.

Så här avslutar du skapandet av ditt evenemang för att skicka data via API:

• Välj Skicka data till HubSpot och kopiera spårnings-ID.
• Klicka på Skapa.

Så här hittar du det interna händelsenamnet för en befintlig händelse och egenskapsnamn:

1. I ditt HubSpot-konto navigerar du tillDatahantering>Händelsehantering.
2. Klicka på händelsens namn. Du kommer då till sidan med händelsens detaljer.
3. Högst upp hittar du händelsens namn under Internt namn. För att kopiera det interna namnet klickar du på kopieringsikonen bredvid namnet. 
   
   
4. För att hitta de interna namnen på de egenskaper du ska uppdatera klickar du på namnet på en egenskap.
5. Klicka på kodikonen i den högra panelen och visa sedan namnet under Internt namn.

Skapa händelser med ett JavaScript-kodavsnitt

1. I ditt HubSpot-konto navigerar du tillDatahantering>Händelsehantering.
2. Klicka påSkapa en händelse längst upp till höger och välj sedan Skapa anpassad händelse.
3. VäljKod Javascript.

4. Ange ett evenemangsnamn och eventuellt en beskrivning av evenemanget.
5. Välj ett associerat objekt. Detta gör att du kan associera dina händelser med olika objekt i HubSpot, inklusive kontakter, företag, affärer och ärenden. 

6. Klicka påNästa.

Lägg till egenskaper

När en händelse skapas kommer standardegenskaper för händelsen att vara tillgängliga. Du kan också skapa egna anpassade egenskaper. Händelseegenskaper lagras separat från andra CRM-egenskaper och är unika för händelsen (dvs. du kan inte redigera dessa egenskaper från dina kontoinställningar). 

1. Om du vill inaktivera skapandet av standardhändelseegenskaper, växlaStandardhändelseegenskaper till av.
2. Om du vill skapa anpassade egenskaper väljer du egenskapstyp genom att klicka på Fälttyp för din egenskap. Alternativen är: 
   • Anpassad strängegenskap: skapa en egenskap som är en vanlig textsträng. 
   • Anpassad nummeregenskap: skapa en egenskap som är ett numeriskt värde.
   • Anpassad tidsstämpelseegenskap: skapa en egenskap som är ett datumvärde. Du måste skicka dina data i form av millisekunder eller ISO8601.
   • Anpassad datumegenskap: skapa en egenskap som är ett datumvärde.
   • Anpassad boolesk egenskap: skapa en egenskap som är ett booleskt värde. 
   • Anpassad uppräkningsegenskap: skapa en egenskap med en uppsättning fördefinierade värden.
3. När du har valt din egenskap konfigurerar du den i den högra panelen:

8. Ange ett namn för egenskapen och ange en beskrivning för egenskapen.
   • För uppräkningsegenskaper klickar du på Nästa och anger egenskapens etiketter och värden.
     • Enumerationsegenskaper kan vara enkel- eller flerval. För att aktivera flerval, aktivera alternativetStöd för flervärden.

• • • Du måste ange dina värden och etiketter innan du skickar data till dem. Om detta steg inte är slutfört innan du skickar data som inte finns i listan kommer data inte att vara tillgängliga för användning. För att skicka flera värden via API separerar du dem med semikolon.

9. Klicka på Nästa.
10. När du har konfigurerat händelsen och dess egenskaper kan du lägga till händelsen i webbplatsens spårningskod genom att välja Javascript-kodsnutt.
11. Klicka påKlar.

Genom att skapa händelser med ett JavaScript-kodavsnitt kan du automatiskt lägga till JavaScript i din HubSpot-spårningskod. Detta kan användas för att samla in mer komplexa händelsedata som spårningskoden inte samlar in som standard. 

1. Välj Javascript-kodsnutt. Använd snutten i den högra panelen för att spåra händelsen i HubSpot. Alla anpassade egenskaper som skapas kommer att fördefinieras i kodsnutten. 
2. Ändra kodavsnittet efter behov genom att ange text i den högra panelen. All kod du lägger till kommer automatiskt att inkluderas som en del av din HubSpot-spårningskod.
3. När du är klar klickar du på Skapa för att slutföra händelsen och automatiskt starta spårningen.
    
   

Importera händelsedata

Ladda upp dina närvarodata från fysiska händelser, tidsstämplade data från appar som du inte integrerar med HubSpot, engångsdata om leads eller kampanjer från en leverantör eller andra händelsedata i kalkylbladsformat. Med händelser kan du samla in beteendedata och sedan använda dessa data i HubSpot. 

• Kontakt-e-postadress.
• Inträffade vid tidsstämpel. Läs mer om formatering av datumegenskaper i importfiler.

Exempelfil

För att importera anpassade händelser:

1. I ditt HubSpot-konto navigerar du tillDatahantering>Händelsehantering.
2. Klicka påSkapa ett evenemang längst upp till höger och välj sedanSkapa anpassat evenemang.
3. VäljImportera kalkylblad.
4. Ange ett händelsenamn och ange eventuellt en beskrivning av händelsen.
5. Välj ett associerat objekt. För närvarande kan händelser som skapas via import endast associeras med kontakter.
6. Ladda upp filen. Välj hur objekten ska importeras och filens språk och klicka sedan på Nästa.
7. Mappa kolumner till händelse- och kontaktegenskaper och klicka sedan på Nästa.
8. Bekräfta namnet på din importfil.
9. Klicka i kryssrutan för att godkänna att kontakterna förväntar sig att höra från dig och att din importfil inte innehåller en köpt lista. Läs mer om HubSPots policy för acceptabel användning.
10. Välj datumformat för egenskapen Inträffade den.
11. Klicka på Slutför import.

Skapa händelser via API

1. I ditt HubSpot-konto navigerar du tillDatahantering>Händelsehantering.
2. Klicka påSkapa en händelse längst upp till höger och välj sedanSkapa anpassad händelse.
3. VäljSkicka via API.

4. Ange ett evenemangsnamn och, om du vill, en beskrivning av evenemanget. 

5. Så här lägger du till anpassade händelseegenskaper:
   • Skriv in ettegenskapsnamn. Detta namn kommer även att användas sominternt namn.
   • Klicka på rullgardinsmenynFälttyp och välj en fälttyp.
   • Du kan också lägga till enbeskrivning.
   • Om du vill lägga till fler anpassade egenskaper klickar du på+ Lägg till anpassad egenskap.
   • Klicka påNästa.

6. Så här länkar du objekt:
   • Klicka på rullgardinsmenyn Välj ettprimärt objekt och välj sedan ett associerat objekt. På så sätt kan du associera dina händelser med olika objekt, inklusive kontakter, företag, affärer och biljetter.
   • Klicka påAnpassa matchningen och välj ditt matchnings-ID mellan dina händelse- och objektposter. Händelsen länkas endast till objektposten när deras matchnings-ID är identiska. Om du använder ett anpassat matchnings-ID måste den objektegenskap du väljer kräva unika värden.
7. Klicka påNästa.
8. För att spåra händelsen i HubSpot klickar du påKopiera bredvid spårnings-ID.
9. Klicka påSkapa händelse.

Konfigurera webhooks

Ställ in villkoren som ska utlösa en webhook.

1. I ditt HubSpot-konto navigerar du tillDatahantering>Händelsehantering.
2. Klicka påSkapa en händelse längst upp till höger och välj sedanSkapa anpassad händelse.
3. VäljKonfigurera webhooks.
4. Ange etthändelsenamn och välj ettassocierat objekt.
5. Klicka påNästa.
6. Konfigurera ett testevenemang:
   • Kopierawebhook-URL:en. 
   • Navigera tillsidan för webhook-inställningari den tredjepartsapp som du vill integrera med.
   • Klistra in den kopierade URL-adressen.
   • Klicka på Skicka ett testevenemang.
7. Klicka påNästa.
8. Granska egenskaperna för din webhook. Klicka pårullgardinsmenyn Egenskapstypför att välja en egenskapstyp. 

9. Klicka påNästa.
10. Välj en egenskap från din tredjepartswebhook som exakt matchar en HubSpot-objektegenskap. 

Använd anpassade händelsedata

Anpassade händelsedata kan visas och användas i HubSpots verktyg. Nedan kan du läsa om var du kan se händelser och hur du kan integrera dessa data i andra verktyg.

Du kan öppna dina valda händelser direkt i utvalda HubSpot-verktyg med hjälp av rullgardinsmenyn för åtgärder i din händelselista, visningen för enskilda händelser eller det övre högra hörnet av diagrammen på fliken Analysera.

Rapportera om anpassade händelser

Anpassade händelser kan analyseras från verktyget för anpassade händelser, och händelsedata kommer också att finnas tillgängliga i verktyget för anpassade rapporter och attributionsrapporter.

Läs mer om hur du analyserar dina anpassade händelser.

Visa händelser på kontaktens tidslinje

Händelser visas på kontaktens tidslinje tillsammans med alla egenskaper som har fyllts i.

Så här visar du händelsedetaljer på kontaktens tidslinje:

1. Navigera till en kontaktpost där en anpassad händelse har inträffat.
2. För att filtrera en kontakttidslinje efter händelseförekomster klickar du på Filtrera aktivitet och väljer sedan Anpassad händelse.
3. I kontaktens tidslinje klickar du för att expandera händelsen och visa händelsedetaljerna.

Observera: du kan inte visa tidslinjeaktivitet för anpassade händelser som skapats med hjälp av webhooks.

Använd anpassade händelser i arbetsflöden

I ett arbetsflöde kan du fördröja baserat på anpassade händelser med hjälp av en Fördröj tills händelsen inträffar åtgärd eller en händelseanmälningsutlösare.

1. I ditt HubSpot-konto navigerar du till Automatisering > Arbetsflöden.
2. Klicka på namnet på ett arbetsflöde. Eller läs om hur du skapar ett nytt arbetsflöde.
3. Så här lägger du till en utlösare:
   • Klicka på Ställ in utlösare i arbetsflödesredigeraren.
   • Välj När en händelse inträffar i den vänstra panelen. Konfigurera utlösaren och klicka sedan på Tillämpa filter.
   • För att förfina din utlösare ytterligare, klicka på Lägg till förfiningsfilter. Du kan välja ytterligare egenskaper för att förfina de objekt som du vill registrera i arbetsflödet.
   • Som standard registreras poster endast i ett arbetsflöde första gången de uppfyller registreringsutlösarna. För att aktivera omregistrering väljer du Ja, registrera om varje gång utlösaren inträffar under avsnittet Ska [objekt] omregistreras i detta arbetsflöde?
4. Så här lägger du till en fördröjning:
   • I arbetsflödesredigeraren klickar du på plusikonen (+) för att lägga till en arbetsflödesåtgärd.
   • I den högra panelen väljer du Fördröj tills händelsen inträffar.
   • Konfigurera fördröjningen:
     • Klicka på rullgardinsmenyn Händelse och välj sedan en anpassad händelse.
     • Välj sedan den händelseegenskap som du vill fördröja.
     • Välj filtret för händelseegenskapen.
     • Klicka på Apply filter(Tillämpa filter).
   • • Välj maximal väntetid eller markera kryssrutan Fördröj så länge som möjligt .
5. Klicka på Spara.

Observera:alla händelseanmälningsutlösare separeras med hjälp av OR-operatorn. Detta innebär att endast en av händelseanmälningsutlösarna måste inträffa för att posten ska registreras i arbetsflödet.

Arbetsflödet fördröjer sedan registrerade poster tills de uppfyller de angivna kriterierna för anpassade händelser eller triggas när händelsen inträffar.