Så här skapar du egna händelser

Sammanfattning

Använd anpassade händelser i HubSpot för att 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 alla HubSpots verktyg. Du kanske till exempel vill spåra offlinehändelser, såsom deltagande vid en fysisk produktlansering.

Lär dig de tre olika metoderna för att skapa anpassade händelser. Du kan skicka anpassade händelser via ett API, ladda upp ett kalkylblad med händelsedata eller använda webhooks (endastData Hub Professional och Enterprise ).

När du har konfigurerat en anpassad händelse kan du granska data för den anpassade händelsen i olika verktyg. Du kan skapa rapporter med data för anpassade händelser, granska förekomster av anpassade händelser på kontakters tidslinjer och använda anpassade händelser i arbetsflöden.

Slutligen kan du följa resultatet för dina anpassade händelser i verktyget för hantering av anpassade händelser. Du kan också behöva åtgärda fel med okända egenskaperi verktyget för hantering av anpassade händelser.

Vilka olika metoder finns det för att skapa anpassade händelser?

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 ska utlösa händelsen.

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

• Skicka via API: använd slutpunkten för definition av anpassade händelser för att skapa din händelse. Använd sedan ditt händelse-ID med slutpunkten för att skicka anpassade händelser för att skicka händelseförekomster till HubSpot.
• Samla in data från din webbplats utan API:
  • Javascript-kod: med anpassad Javascript kan du infoga anpassad kod i ditt HubSpot-spårningsskript med hjälp av kodredigeraren.
  • Använd händelsevisualiseraren: spåra sidvisningar eller klickade element genom att markera 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 i efterhand eller manuellt integrera valfritt verktyg med HubSpot.
• Konfigurera webhooks (Data Hub endast Professional och Enterprise ): anpassa villkoren som utlöser en webhook och vilka data som ska skickas. 

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

Hur skapar jag anpassade händelser med hjälp av API:et?

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 ska skicka data till.

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

• Välj Skicka data till HubSpot och kopiera spårnings-ID:t.
• 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ändelsedetaljer.
3. Längst 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. I den högra panelen klickar du på kodikonen och ser sedan namnet under Internt namn.

Hur skapar jag anpassade händelser med JavaScript-kod?

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äljKodera JavaScript.

4. Ange ett händelsenamn och lägg gärna till en beskrivning av händelsen.
5. Välj ett associerat objekt. Detta gör att du kan koppla dina händelseförekomster till olika objekt i HubSpot, inklusive kontakter, företag, affärer och ärenden. 

6. Klicka påNästa.

Hur lägger jag till egenskaper till min händelse?

När en händelse skapas finns standardegenskaper för händelsen 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 standardegenskaper för händelser stänger du av alternativetStandardegenskaper för händelser.
2. För att skapa anpassade egenskaper väljer du egenskapstyp genom att klicka på fälttypen för din egenskap. Alternativen är: 
   • Anpassad strängegenskap: skapa en egenskap som är en vanlig textsträng. 
   • Anpassad talegenskap: skapa en egenskap som är ett talvärde.
   • Anpassad tidsstämpelegenskap: skapa en egenskap som är ett datumvärde. Du måste skicka dina data i form av epoch-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äkningsvariabel: skapa en variabel 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.
     • Uppräkningsegenskaper kan vara enkel- eller flervalsval. För att aktivera flervalsvärden, slå på växelnStöd för flervärden.

• • • Du måste ange värden och etiketter innan du skickar data till dem. Om detta steg inte slutförs 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 ska du separera 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 kodsnuttet i den högra panelen för att spåra händelsen i HubSpot. Alla anpassade egenskaper som skapats kommer att vara fördefinierade i kodsnuttet. 
2. Ändra kodavsnittet efter behov genom att skriva in 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.
    
   

Hur importerar jag anpassade händelsedata från kalkylark?

Ladda upp dina närvarodata från fysiska evenemang, tidsstämplade data från appar som du inte har integrerat med HubSpot, engångsdata om leads eller kampanjer från en leverantör eller andra evenemangsdata i kalkylbladsform. Med evenemang kan du registrera beteenden och sedan använda dessa beteenden i hela HubSpot. 

Import kan skapa och uppdatera följande poster:

• Kontakter

• Företag
• Affärer
• Biljetter
• Tjänster
• Projekt
• Tidsbokningar
• Kurser
• Listor 
• Beställningar
• Anpassade objekt

De obligatoriska egenskaperna varierar beroende på objekttyp.

Händelseimport kan endast användas för händelser som redan har inträffat. Följande måste ingå i en anpassad händelseimportfil:

• Kontakt-e-postadress.
• Inträffade vid tidsstämpel. Läs mer om hur du formaterar datumegenskaper i importfiler.

Exempelfil

Så här importerar du anpassade händelser:

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Händelsehantering. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > 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. Klicka antingen på Skapa ett nytt evenemang eller Importera till ett befintligt evenemang.
   • Om du väljer Importera till ett befintligt evenemang använder du rullgardinsmenyn för att välja det befintliga evenemanget och fortsätter sedan med stegen för att ladda upp ditt kalkylark.
   • Om du väljer Skapa ett nytt evenemang fortsätter du med stegen nedan.
5. Ange ett evenemangsnamn och lägg gärna till en beskrivning av evenemanget.
6. Välj ett associerat objekt. För närvarande kan evenemang som skapas via import endast kopplas till kontakter.
7. Ladda upp ditt kalkylark eller klistra in direkt från kalkylarket. Välj hur objekten ska importeras och filens språk, och klicka sedan på Nästa.
8. Koppla kolumnerna till händelse- och kontaktegenskaper och klicka sedan på Nästa.
9. Bekräfta namnet på din importfil.
10. Markera kryssrutan för att bekräfta 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 godtagbar användning.
11. Välj datumformat för egenskapen Inträffade den.
12. Klicka på Avsluta import.

Hur skickar jag anpassade händelser via API-ändpunkten?

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äljSkicka via API.

4. Ange ett händelsenamn och, om du vill, en beskrivning av händelsen. 

5. Så här lägger du till anpassade händelseegenskaper:
   • Skriv in ettegenskapsnamn. Detta namn kommerävenatt användas som detinterna namnet.
   • Klicka på rullgardinsmenynFälttyp och välj en fälttyp.
   • Lägg eventuellt 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. Detta gör att du kan koppla dina händelser till olika objekt, inklusive kontakter, företag, affärer och ärenden.
   • Klicka påAnpassa matchningen och välj ditt matchnings-ID mellan dina händelse- och objektregister. Händelsen länkas endast till objektregistret när deras matchnings-ID:n ä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:t.
9. Klicka påSkapa händelse.

Hur skapar jag anpassade händelser med hjälp av 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 ett evenemang längst upp till höger och välj sedanSkapa anpassat evenemang.
3. VäljKonfigurera webhooks.
4. Ange ettevenemangsnamn och välj ettassocierat objekt.
5. Klicka påNästa.
6. Konfigurera ett testevenemang:
   • Kopierawebhook-URL:en. 
   • Gå tillsidan för webhook-inställningari den tredjepartsapp som du vill integrera med.
   • Klistra in den kopierade URL:en.
   • Klicka på Skicka ett testhändelse.
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 webhook från tredje part som exakt matchar en egenskap i ett HubSpot-objekt. 

Var kan jag visa och använda data från anpassade händelser i HubSpot?

Data från anpassade händelser kan visas och användas i alla HubSpots verktyg. Nedan kan du läsa om var du kan se händelseförekomster och hur du kan integrera dessa data i andra verktyg.

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

Hur skapar jag rapporter med anpassade händelsedata?

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

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

Hur granskar jag händelser på kontaktens tidslinje?

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

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

1. Gå till en kontaktpost där en anpassad händelse har inträffat.
2. För att filtrera en kontakttidslinje efter händelser, klicka på Filtrera aktivitet och välj 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.

Hur använder jag anpassade händelser i arbetsflöden?

I ett arbetsflöde kan du lägga in en fördröjning baserad på anpassade händelser med hjälp av en Fördröj tills händelsen inträffar -åtgärd eller en utlösare för händelseanmälan.

1. I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Automatisering > Arbetsflöden. Om Mer inte visas i ditt konto navigerar du direkt 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:
   • I arbetsflödesredigeraren klickar du på Konfigurera utlösare.
   • I den vänstra panelen väljer du När en händelse inträffar. Konfigurera utlösaren och klicka sedan på Tillämpa filter.
   • För att ytterligare förfina din utlösare, 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, omregistrera 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 utifrån.
     • Välj filtret för händelseegenskapen.
     • Klicka på " Tillämpa filter".
   • • Välj den maximala väntetiden eller markera kryssrutan Fördröj så länge som möjligt .
5. Klicka på Spara.

Observera:alla händelsebaserade utlösare separeras med operatorn ELLER. Detta innebär att endast en av de händelsebaserade utlösarna behöver inträffa för att posten ska inkluderas i arbetsflödet.

Arbetsflödet kommer då att fördröja de registrerade posterna tills de uppfyller de angivna kriterierna för den anpassade händelsen eller utlöses när händelsen inträffar.

Hur hanterar och spårar jag statusen för min anpassade händelse och övervakar leveransfel?

För att säkerställa att dina data förblir korrekta och att dina integrationer fungerar som förväntat kan du använda fliken Övervaka i verktyget för händelsehantering.

Hur spårar jag prestandan i verktyget för hantering av anpassade händelser?

• Trender för slutförande: I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Händelsehantering. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > Händelsehantering. Klicka på fliken Övervaka för att jämföra volymerna för slutförda händelser över olika tidsperioder.

• Felsökning av leveransfel: I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Datahantering > Händelsehantering. Om Mer inte visas i ditt konto navigerar du direkt till Datahantering > Händelsehantering. I vänster sidofält på fliken Övervaka väljer du Leveransfel. Denna tabell identifierar händelser som inte kunde synkroniseras och anger den specifika orsaken till felet (t.ex. felaktiga datatyper eller schemabrist).

Hur åtgärdar jag fel av typen ”Okänd egenskap” i verktyget för hantering av anpassade händelser?

Om data skickas via API för en egenskap som aldrig har definierats i HubSpot kommer den att visas i felloggen. Du kan lösa detta snabbt:

1. Håll muspekaren över händelsen i tabellen Felprotokoll.

2. Klicka på Åtgärder och välj sedanLägg till egenskaper till händelse.

3. Bekräfta de föreslagna fälttyperna så att HubSpot omedelbart kan börja ta emot dessa data.