Så här skapar du egna evenemang

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 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 anpassade händelser 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 spåra resultatet för dina anpassade händelser i verktyget för hantering av anpassade händelser. Du kan också behöva lösa okända egenskapsfeli 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 kommer att 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 eller manuellt integrera valfritt verktyg med HubSpot.
• Konfigurera webhooks (Data Hub endast 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.

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 ditt evenemang 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. Leta upp händelsens namn under Internt namn högst upp. Klicka på kopieringsikonen bredvid namnet för att kopiera det interna 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 visar 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 eventuellt till en beskrivning av händelsen.
5. Välj ett associerat objekt. Detta gör att du kan koppla dina händelser 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 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. För att inaktivera skapandet av standardegenskaper för händelser, stäng avStandardegenskaper för händelser.
2. För att skapa anpassade egenskaper väljer du egenskapstyp genom att klicka på Fälttyp för din egenskap. Alternativen inkluderar: 
   • 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 det högra fönstret:

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 flervalsbara. För att aktivera flervalsbara värden, slå på växelnStöd för flervärden.

• • • Du måste ange dina 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, 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 det högra fönstret för att spåra händelsen i HubSpot. Alla anpassade egenskaper som skapas kommer att fördefinieras 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 ditt evenemang 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 integrerar med HubSpot, engångsdata om leads eller kampanjer från en leverantör eller andra evenemangsdata i kalkylbladsform. Evenemang gör det möjligt för dig att samla in beteendedata och sedan använda dessa data i hela HubSpot. 

Import kan skapa och uppdatera följande poster:

• Kontakter

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

De nödvändiga 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 formatering av datumegenskaper i importfiler.

Exempelfil

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

1. I ditt HubSpot-konto navigerar du till Datahantering > Hantering av händelser.
2. Klicka påSkapa ett evenemang längst upp till höger och välj sedanSkapa anpassat evenemang.
3. VäljImportera kalkylblad.
4. Klicka på antingen 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 kalkylblad.
   • 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 händelser som skapas via import endast kopplas till kontakter.
7. Ladda upp ditt kalkylblad eller klistra in direkt från kalkylbladet. 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. 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 godtagbar användning.
11. Välj datumformat för egenskapen Inträffade den.
12. Klicka på Slutför import.

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

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 evenemangsnamn och, om du vill, en beskrivning av evenemanget. 

5. Så här lägger du till egna 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 ä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:
   • Kopiera webhook-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 en tredjepartsleverantör som exakt matchar en egenskap hos ett HubSpot-objekt. 

Var kan jag visa och använda data för 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 med hjälp av åtgärdsmenyn i din händelselista, vyn för enskilda händelser eller i det övre högra hörnet av diagrammen på fliken Analysera.

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 också 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 alla 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 skjuta upp åtgärder 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:
   • I arbetsflödesredigeraren klickar du på Konfigurera utlösare.
   • I den vänstra panelen väljer du När en händelse inträffar. Ställ in 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.
     • 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ändelseutlösare separeras med hjälp av operatorn ELLER. Detta innebär att endast en av händelseutlösarna behöver inträffa för att posten ska registreras i arbetsflödet.

Arbetsflödet kommer då att fördröja registrerade poster tills de uppfyller de angivna kriterierna för anpassade händelser 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 prestanda i verktyget för hantering av anpassade händelser?

• Trender för slutförande: I ditt HubSpot-konto navigerar du till Datahantering > Hantering av händelser. 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 navigerar du till Datahantering > Hantering av händelser. 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 schemabrut).

Hur löser 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.