Skapa anpassade händelser

Anpassade händelser gör att du kan definiera och spåra händelser som är unika för ditt företag. Anpassade händelser kan knytas till egenskaper för händelser, 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 Anpassad händelse definition för att skapa din händelse. Därefter använder du ditt händelse-ID med slutpunkten send Anpassad händelse för att skicka slutförda händelser till HubSpot.
• Samla in data från din webbplats utan API:
  • Koda Javascript: med hjälp av Kundkod Javascript kan du infoga anpassad kod i ditt HubSpot-skript för spårning med hjälp av kodredigeraren.
  • Använd event visualizer (endastMarketing Hub Enterprise ): spåra sidvyer eller klickade element genom att välja dem på din webbplats. Läs mer om hur du skapar Anpassade händelser med Event visualizer.
• Import av kalkylblad: ladda upp ett kalkylblad med data om händelser för att fånga upp aktiviteter offline, fylla på data eller manuellt integrationera ett verktyg med HubSpot.
• Konfigurera webhooks (endastOperations Hub Professional och Enterprise): anpassa de villkor som utlöser en webhook och de data som ska skickas.

Observera: verktyget för anpassade händelser ersätter det tidigare verktyget för händelser. Händelser som skapats i det tidigare verktyget kommer att fortsätta att fungera och du kan fortfarande hantera och analysera dessa händelser i det tidigare verktyget.

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

• Definiera händelsen i HubSpot, inklusive eventuella anpassade egenskaper för händelsen.
• 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ända alternativet Skicka via API eller använda Anpassad händelse definition slutpunkt 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 få inifrån HubSpot:

• Händelsens namn: det interna namnet för händelsen.
• Namn på Egenskap: de interna namnen på de egenskaper som du ska skicka data till.

Avsluta med att skapa din händelse för att skicka data via API:

• Välj Skicka data till HubSpot och kopiera Spårning ID.
• Klicka på Skapa.

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

1. I ditt HubSpot-konto navigerar du till Datahantering > Anpassade händelser.
2. Klicka på namnet på händelsen. Du kommer då till sidan med information om händelsen.
3. Längst upp hittar du namnet på händelsen under Internt namn. Om du vill kopiera det interna namnet klickar du på kopieringsikonen bredvid namnet.
   
   
4. För att hitta de interna namnen för de egenskaper som du ska uppdatera, klicka på namnet på en egenskap.
5. I den högra panelen klickar du på kodikonen och visar sedan namnet under Internt namn.

Skapa händelser med ett kodavsnitt i Javascript

1. I ditt HubSpot-konto navigerar du till Datahantering > Anpassade händelser.
2. Klicka på Skapa en händelse längst upp till höger.
3. Välj Kod Javascript.

4. Ange ett namn på händelsen och eventuellt en beskrivning av händelsen.
5. Välj ett Associated object (associerat objekt). Detta gör att du kan associera dina händelser med olika objekt i HubSpot, inklusive Kontakter, Företag, Affärer och Supportä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 dina egna anpassade egenskaper. Egenskaperna för händelsen lagras separat från andra egenskaper i CRM och är unika för händelsen (dvs. du kan inte redigera dessa egenskaper från dina kontoinställningar).

1. I ditt HubSpot-konto navigerar du till Datahantering > Anpassade händelser.
2. Klicka på Skapa en händelse längst upp till höger.
3. Välj Kod Javascript.
4. Ange ett namn på händelsen och eventuellt en beskrivning av händelsen.
5. Om du vill stänga av skapandet av standardmässiga egenskaper för händelsen växlar du Default event properties till off.
6. Om du vill skapa anpassade egenskaper väljer du egenskapstyp genom att klicka på Fälttyp för din egenskap. Bland alternativen finns:
   • Egenskap för anpassad sträng: skapa en egenskap som är en ren textsträng.
   • Egenskap för nummer: skapa en egenskap som är ett nummervärde.
   • Egenskap för anpassad tidsstämpel: skapa en egenskap som är ett datumvärde. Du måste skicka dina data i formuläret epoch millisekunder eller ISO8601.
   • Egenskap för anpassat datum: skapa en egenskap som är ett datumvärde.
   • Egenskap för boolean: skapa en egenskap som är ett booleanskt värde.
   • Egenskap för enumeration: skapa en egenskap med en uppsättning fördefinierade värden.
7. När du har valt din egenskap konfigurerar du egenskapen 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 en- eller flervalsegenskaper. Om du vill aktivera flervalsvärden växlar du till Stöd för flervalsvärden.

• • • Du måste ställa in dina värden och etiketter innan du skickar data till dem. Om detta steg inte slutförs innan du skickar data som inte finns på listan kommer data inte att kunna användas. Om du vill skicka flera värden via API separerar du dem med ett semikolon.

9. Klicka på Nästa.
10. När du har konfigurerat händelsen och dess egenskaper kan du lägga till den här händelsen i webbplatsens kod för spårning genom att välja Javascript kodavsnitt.
11. Klicka på Done.

Om du skapar 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 fånga mer komplexa data om händelser som spårningskoden inte fångar som standard.

• Välj Javascript kodavsnitt. Använd avsnittet i den högra panelen för att spåra händelsen i HubSpot. Alla anpassade egenskaper som skapas kommer att vara fördefinierade i kodavsnittet.
• Ändra avsnittet 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årning.
• När du är klar klickar du på Skapa för att slutföra händelsen och automatiskt starta spårning.
  

Importera data om händelser

Ladda upp dina närvarodata från personliga händelser, tidsstämplade data som kommer från Appar som du inte integrationer med HubSpot, enstaka potentiell kund eller kampanjdata från en leverantör, eller någon annan händelse data i spreadsheet form. Händelser gör att du kan fånga upp beteende och sedan använda beteendet i hela HubSpot.

• Kontaktens e-postadress.
• Inträffade vid tidsstämpel. Läs mer om hur du formaterar egenskaper för datum i filer som importeras.

Exempel på fil

För att importera anpassade händelser:

1. . I ditt HubSpot-konto navigerar du till Datahantering > Anpassade händelser.
2. Klicka på Skapa en händelse längst upp till höger.
3. Välj Import av kalkylblad.

4. Ange ett namn på händelsen och eventuellt en beskrivning av händelsen.
5. Välj ett Associated object (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 vilket språk filen ska vara på och klicka sedan på Nästa.
7. Mappa kolumner till egenskaper för händelser och kontakter och klicka sedan på Nästa.
8. Bekräfta namnet på din fil för import.
9. klicka på kryssrutan för att godkänna att kontakter 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.
10. Välj datumformat för egenskapen Inträffade vid.
11. Klicka på Slutför import.

Skapa händelser via API

1. I ditt HubSpot-konto navigerar du till Datahantering > Anpassade händelser.
2. Klicka på Skapa en händelse längst upp till höger.
3. Välj Skicka via API.

4. Ange ett namn på händelsen och eventuellt en beskrivning av händelsen.

5. För att lägga till egenskaper för anpassade händelser:
   • Skriv in ett namn på egenskapen. Detta namn kommer även att tillämpas på det interna namnet .
   • Klicka på rullgardinsmenyn Fälttyp och välj en fälttyp.
   • Lägg eventuellt till en beskrivning.
   • Om du vill lägga till fler anpassade egenskaper klickar du på + Lägg till anpassad egenskap.
   • Klicka på Nästa.

6. För att länka objekt:
   • Klicka på rullgardinsmenyn Välj ettprimärt objekt och välj sedan ett associerat objekt. Detta gör att du kan associera dina händelser med olika objekt, inklusive kontakter, företag, affärer och supportärenden.
   • Klicka på Anpassa matchningen och välj ditt matchnings-ID mellan dina händelse- och objektregister. Händelsen kommer endast att länkas till objektregistret när deras matchande ID är identiska. Om du använder ett anpassat matchnings-ID måste den egenskap för objektet som du väljer kräva unika värden.
7. Klicka på Nästa.
8. Om du vill spåra händelsen i HubSpot klickar du påKopiera bredvid spårnings-ID:t.
9. Klicka på Skapa händelse.

Konfigurera webhooks

Ange de villkor som ska utlösa en webhook.

1. I ditt HubSpot-konto navigerar du till Datahantering > Anpassade händelser.
2. Klicka på Skapa en händelse längst upp till höger.
3. Välj Setup webhooks (Konfigurera webhooks).
4. Ange ett namn på händelsen och välj ett associerat objekt.

5. Klicka på Nästa.
6. Ställ in en testhändelse:
   • Kopiera webbadressen till Webhook.
   • Navigera till inställningssidan för Webhook i den tredjepartsapp som du vill integrationera med.
   • Klistra in den kopierade URL:en.
   • Klicka på Skicka en testhändelse.
7. Klicka på Nästa.
8. Granska egenskaperna för din webhook. Klicka på rullgardinsmenyn Typ av egenskap för att välja en typ av egenskap.

9. Klicka på Nästa.
10. Välj en egenskap från din tredjeparts webhook som är en exakt matchning för en HubSpot objekt egenskap.

Använd data om anpassade händelser

Data från anpassade händelser kan visas och användas i HubSpots verktyg. Nedan kan du se var du kan se avslutade 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 rullgardinsmenyn för åtgärder i listan över händelser, vyn för enstaka händelser eller det övre högra hörnet av diagrammen på fliken Analysera.

Rapportering 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 den anpassade rapportbyggaren och attributionsrapporterna.

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

Visa händelser som slutförts på kontaktens tidslinje

Avslutade händelser visas på kontaktregistrets tidslinje, tillsammans med eventuella egenskaper som fylldes i.

För att se detaljer om händelsen på tidslinjen för kontakt:

1. Navigera till ett kontaktregister som har slutfört en anpassad händelse.
2. Om du vill filtrera en tidslinje för kontakter efter slutförda händelser klickar du på Filtrera aktivitet och väljer sedan Anpassad händelse.
3. I tidslinjen för kontakten klickar du på för att expandera händelsen och visa detaljer om händelsen.

Använda anpassade händelser i arbetsflöden

I ett arbetsflöde kan du fördröja baserat på att anpassade händelser slutförs med hjälp av en Fördröjning tills händelsen inträffar-åtgärd eller en Utlösare för registrering av händelse.

1. I ditt HubSpot-konto navigerar du till Automatisering > Arbetsflöden.
2. Klicka på namnet på ett arbetsflöde. Eller läs mer om hur du skapar ett nytt arbetsflöde.
3. Lägga till en utlösare:
   • Klicka på Ställ in utlösare i redigeraren för arbetsflöden.
   • 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.
   • Om du vill förfina utlösaren ytterligare klickar du 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 register bara i ett arbetsflöde första gången de uppfyller utlösarna för registrering. Om du vill aktivera Utlösare för omregistrering väljer du Ja under avsnittet Ska [objektet] utlösas på nytt i det här arbetsflödet? och utlösare för omregistrering varje gång utlösaren inträffar.
4. Så här lägger du till en fördröjning:
   • Klicka på + plus-ikonen i arbetsflödesredigeraren för att lägga till en arbetsflödesåtgärd.
   • I den högra panelen väljer du Fördröjning 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 egenskap för händelsen som du vill ha fördröjning på.
     • Välj filter för egenskapen för händelsen.
     • Klicka på Tillämpa filter.
   • • Välj den maximala väntetiden eller markera kryssrutan Fördröjning så länge som möjligt.
5. Klicka på Spara.

Observera: alla utlösare för registrering av händelser separeras med operatorn OR. Detta innebär att endast en av utlösarna för registrering av händelse måste inträffa för att registret ska registreras i arbetsflödet.

Arbetsflödet kommer sedan att fördröja registrerade register tills de uppfyller de angivna kriterierna för anpassad händelse eller kommer att utlösas när händelsen inträffar.