Opprett egendefinerte hendelser

Med egendefinerte hendelser kan du definere og spore hendelser som er unike for din virksomhet. Egendefinerte hendelser kan knyttes til hendelsesegenskaper, som du deretter kan bruke på tvers av HubSpots verktøy.

Det finnes ulike måter å opprette egendefinerte hendelser på:

• Send via API: Bruk endepunktet for egendefinert hendelsesdefinisjon til å opprette hendelsen. Deretter bruker du hendelses-ID-en med endepunktet send egendefinert hendelse for å sende fullførte hendelser til HubSpot.
• Fang inn data fra nettstedet ditt uten API:
  • Kode Javascript: Ved hjelp av Custom Javascript kan du sette inn tilpasset kode i HubSpot-sporingsskriptet ditt ved å bruke kodeditoren.
  • Bruk hendelsesvisualisering (kunMarketing Hub Enterprise ): Spor sidevisninger eller klikkede elementer ved å velge dem på nettstedet ditt. Finn ut mer om hvordan du oppretter egendefinerte hendelser med hendelsesvisualiseringen.
• Importer regneark: Last opp et regneark med hendelsesdata for å fange opp frakoblet aktivitet, fylle på data eller manuelt integrere et verktøy med HubSpot.
• Konfigurerwebhooks (kunOperations Hub Professional og Enterprise): Tilpass betingelsene som utløser en webhook, og dataene som skal sendes.

Vær oppmerksom på at verktøyet for egendefinerte hendelser erstatter det tidligere verktøyet for hendelser. Eventuelle hendelser som er opprettet i det gamle verktøyet, vil fortsette å fungere, og du kan fortsatt administrere og analysere disse hendelsene i det gamle verktøyet.

Prosessen for å opprette hendelser består av to deler:

• Definere hendelsen i HubSpot, inkludert eventuelle egendefinerte hendelsesegenskaper.
• Opprette en Javascript-kodebit eller definere API-kallet som vil utløse hendelsen.

Opprett hendelse via API

Hvis du sender data til HubSpot via API, kan du bruke alternativet Send via API eller bruke endepunktet for egendefinert hendelsesdefinisjon for å opprette hendelsen. Finn ut mer om hvordan du definerer API-kallet ditt i HubSpots utviklerdokumentasjon.

Du trenger noen få opplysninger for API-kallet ditt, som du kan hente fra HubSpot:

• Hendelsesnavn: det interne navnet for hendelsen.
• Egenskapsnavn: de interne navnene for egenskapene du skal sende data til.

For å fullføre opprettelsen av hendelsen din for å sende data via API:

• Velg Send data til HubSpot , og kopier sporings-ID-en.
• Klikk på Opprett.

For å finne det interne hendelsesnavnet for en eksisterende hendelse og navn på egenskaper:

1. Gå til Datahåndtering > Tilpassede hendelser i HubSpot-kontoen din.
2. Klikk på navnet på hendelsen. Du kommer da til siden med hendelsesdetaljer.
3. Øverst finner du hendelsesnavnet under Internt navn. Hvis du vil kopiere det interne navnet, klikker du på kopieringsikonet ved siden av navnet.
   
   
4. For å finne de interne navnene for egenskapene du skal oppdatere, klikker du på navnet til en egenskap.
5. Klikk på kodeikonet i høyre panel, og vis deretter navnet under Internt navn.

Opprett hendelser med en Javascript-kodebit

1. Gå til Datahåndtering > Tilpassede hendelser i HubSpot-kontoen din.
2. Klikk på Opprett en hendelse øverst til høyre.
3. Velg Code Javascript.

4. Skriv inn et hendelsesnavn og eventuelt en hendelsesbeskrivelse.
5. Velg et tilknyttet objekt. Dette gjør at du kan knytte hendelsesavslutninger til ulike objekter i HubSpot, inkludert kontakter, selskaper, avtaler og billetter.

6. Klikk på Neste.

Legg til egenskaper

Når en hendelse opprettes, vil standard hendelsesegenskaper være tilgjengelige. Du kan også opprette dine egne tilpassede egenskaper. Hendelsesegenskaper lagres separat fra andre CRM-egenskaper, og er unike for hendelsen (du kan ikke redigere disse egenskapene fra kontoinnstillingene).

1. Gå til Datahåndtering > Tilpassede hendelser i HubSpot-kontoen din.
2. Klikk på Opprett en hendelse øverst til høyre.
3. Velg Code Javascript.
4. Skriv inn et navn på hendelsen, og angi eventuelt en beskrivelse av hendelsen.
5. Hvis du vil slå av opprettelsen av standard hendelsesegenskaper, slår du av Standard hendelsesegenskaper.
6. Hvis du vil opprette egendefinerte egenskaper, velger du egenskapstypen ved å klikke på Felttype for egenskapen din. Alternativene inkluderer:
   • Egendefinertstrengegenskap: Opprett en egenskap som er en ren tekststreng.
   • Egendefinerttallegenskap: Opprett en egenskap som er en tallverdi.
   • Egendefinerttidsstempelegenskap: Opprett en egenskap som er en datoverdi. Du må sende dataene i form av epochemillisekunder eller ISO8601.
   • Egendefinertdategenskap: Opprett en egenskap som er en datoverdi.
   • Egendefinertboolsk egenskap: Opprett en egenskap som er en boolsk verdi.
   • Egendefinertoppregningsegenskap: Opprett en egenskap med et sett forhåndsdefinerte verdier.
7. Når du har valgt egenskapen din, konfigurerer du egenskapen i høyre panel:

8. Skriv inn et navn for egenskapen, og skriv inn en Beskrivelse for egenskapen.
   • For oppregningsegenskaper klikker du på Neste og angir egenskapens Etiketter og Verdier.
     • Oppregningsegenskaper kan være enkelt- eller flervalg. Hvis du vil aktivere flervalgsverdier, slår du på Støtte for flerverdier.

• • • Du må angi verdier og etiketter før du sender data til dem. Hvis dette trinnet ikke er fullført før du sender data som ikke finnes i listen, vil dataene ikke være tilgjengelige. Hvis du vil sende flere verdier via API, må du skille dem med semikolon.

9. Klikk på Neste.
10. Når du har konfigurert hendelsen og dens egenskaper, kan du legge til denne hendelsen i sporingskoden på nettstedet ditt ved å velge Javascript-kodesnippet.
11. Klikk på Ferdig.

Hvis du oppretter hendelser med en Javascript-kodebit, kan du automatisk legge til Javascript i HubSpot-sporingskoden din. Dette kan brukes til å fange opp mer komplekse hendelsesdata som sporingskoden ikke fanger opp som standard.

• Velg Javascript-kodebit. Bruk kodebiten i høyre panel for å spore hendelsen i HubSpot. Eventuelle egendefinerte egenskaper som opprettes, vil være forhåndsdefinert i kodebiten.
• Endre kodebiten etter behov ved å skrive inn tekst i det høyre panelet. All kode du legger til, blir automatisk inkludert som en del av HubSpot-sporingskoden din.
• Når du er ferdig, klikker du på Opprett for å fullføre hendelsen og starte sporingen automatisk.
  

Importer arrangementsdata

Last opp oppmøtedata fra personlige arrangementer, tidsstemplede data fra apper du ikke integrerer med HubSpot, enkeltstående lead- eller kampanjedata fra en leverandør, eller andre hendelsesdata i regnearkform. Med hendelser kan du fange opp atferd og deretter bruke atferden på tvers av HubSpot.

• E-postadresse til kontaktperson.
• Oppstod ved tidsstempel. Finn ut mer om formatering av datoegenskaper i importfiler.

Eksempel på fil

Slik importerer du egendefinerte hendelser:

1. . Gå til Datahåndtering > Tilpassede hendelser i HubSpot-kontoen din.
2. Klikk på Opprett en hendelse øverst til høyre.
3. Velg Importer regneark.

4. Skriv inn et hendelsesnavn og eventuelt en beskrivelse av hendelsen.
5. Velg et tilknyttet objekt. For øyeblikket kan hendelser som opprettes via import, bare knyttes til kontakter.

6. Last opp filen. Velg hvordan du vil importere objektene og filspråket, og klikk deretter på Neste.
7. Tilordnekolonner til hendelses- og kontaktegenskaper, og klikk deretter på Neste.
8. Bekreft navnet på importfilen.
9. Klikk i avmerkingsboksen for å godta at kontaktene forventer å høre fra deg, og at importfilen ikke inneholder en kjøpt liste. Finn ut mer om HubSpots retningslinjer for akseptabel bruk.
10. Velg datoformatet for egenskapen Oppstod på.
11. Klikk på Fullfør import.

Opprett hendelser via API

1. Gå til Datahåndtering > Tilpassede hendelser i HubSpot-kontoen din.
2. Klikk på Opprett en hendelse øverst til høyre.
3. Velg Send via API.

4. Skriv inn et hendelsesnavn og eventuelt en hendelsesbeskrivelse.

5. Slik legger du til egendefinerte hendelsesegenskaper:
   • Skriv inn et egenskapsnavn. Dette navnet vil også bli brukt på det interne navnet .
   • Klikk på rullegardinmenyen Felttype, og velg en felttype.
   • Du kan eventuelt legge til en beskrivelse.
   • Hvis du vil legge til flere egendefinerte egenskaper, klikker du på + Legg til egendefinert egenskap.
   • Klikk på Neste.

6. Slik kobler du objekter:
   • Klikk på rullegardinmenyen Velg etprimærobjekt, og velg deretter et tilknyttet objekt. På denne måten kan du knytte hendelsesavslutninger til ulike objekter, inkludert kontakter, selskaper, avtaler og billetter.
   • Klikk på Tilpass matchingen, og velg den matchende ID-en mellom hendelses- og objektpostene. Arrangementet vil bare kobles til objektoppføringen når de matchende ID-ene er identiske. Hvis du bruker en egendefinert matchende ID, må objektegenskapen du velger, kreve unike verdier.
7. Klikk på Neste.
8. Hvis du vil spore hendelsen i HubSpot, klikker du påKopier ved siden av sporings-ID-en.
9. Klikk på Opprett hendelse.

Sett opp webhooks

Angi betingelsene som skal utløse en webhook.

1. Gå til Datahåndtering > Tilpassede hendelser i HubSpot-kontoen din.
2. Klikk på Opprett en hendelse øverst til høyre.
3. Velg Konfigurer webhooks.
4. Skriv inn et hendelsesnavn, og velg et tilknyttet objekt.

5. Klikk på Neste.
6. Konfigurer en testhendelse:
   • Kopier URL-adressen til webhooken.
   • Naviger til innstillingssiden for webhook i tredjepartsappen du vil integrere med.
   • Lim inn den kopierte URL-adressen.
   • Klikk på Send en testhendelse.
7. Klikk på Neste.
8. Gå gjennom egenskapene for webhooken. Klikk på rullegardinmenyen Egenskapstype for å velge en egenskapstype.

9. Klikk på Neste.
10. Velg en egenskap fra tredjepartswebhooken din som er en nøyaktig match for en HubSpot-objektegenskap.

Bruk egendefinerte hendelsesdata

Egendefinerte hendelsesdata kan vises og brukes på tvers av HubSpots verktøy. Nedenfor finner du informasjon om hvor du kan se fullførte hendelser og hvordan du kan innlemme disse dataene i andre verktøy.

Du kan åpne de valgte hendelsene direkte i utvalgte HubSpot-verktøy ved hjelp av rullegardinmenyen for handlinger i hendelseslisten, visningen av enkelthendelser eller øverst i høyre hjørne av diagrammer i analysefanen.

Rapporter om egendefinerte hendelser

Gjennomførte egendefinerte hendelser kan analyseres fra verktøyet for egendefinerte hendelser, og hendelsesdata vil også være tilgjengelige i den egendefinerte rapportbyggeren og attribusjonsrapportene.

Finn ut mer om hvordan du analyserer de egendefinerte hendelsene dine.

Se fullførte hendelser på kontaktens tidslinje

Fullførte hendelser vises på tidslinjen for kontaktoppføringen, sammen med eventuelle egenskaper som ble fylt ut.

Slik viser du hendelsesdetaljer på kontaktens tidslinje:

1. Naviger til en kontaktoppføring som har fullført en egendefinert hendelse.
2. Hvis du vil filtrere en kontakttidslinje etter fullførte hendelser, klikker du på Filtrer aktivitet og velger deretter Egendefinert hendelse.
3. I kontakttidslinjen klikker du på for å utvide hendelsen for å vise hendelsesdetaljene.

Merk: Du kan ikke vise tidslinjeaktivitet på egendefinerte hendelser som er opprettet ved hjelp av webhooks.

Bruk egendefinerte hendelser i arbeidsflyter

I en arbeidsflyt kan du utsette basert på fullføring av egendefinerte hendelser ved hjelp av en Utsett til hendelsen skjer-handling eller en hendelsesregistreringsutløser.

1. Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
2. Klikk på navnet til en arbeidsflyt. Eller lær hvordan du oppretter en ny arbeidsflyt.
3. Slik legger du til en utløser:
   • Klikk på Konfigurer utløsere i arbeidsflytredigeringsprogrammet.
   • Velg Når en hendelse inntreffer i panelet til venstre. Konfigurer utløseren, og klikk deretter på Bruk filter.
   • Hvis du vil avgrense utløseren ytterligere, klikker du på Legg til avgrensningsfilter. Du kan velge flere egenskaper for å avgrense objektene du ønsker å inkludere i arbeidsflyten.
   • Som standard vil poster bare registreres i en arbeidsflyt første gang de oppfyller registreringsutløserne. Hvis du vil aktivere ny registrering, velger du Ja, registrer på nytt hver gang utløseren inntreffer under Skal [objekt] registreres på nytt i denne arbeidsflyten?
4. Slik legger du til en forsinkelse:
   • I arbeidsflytredigeringsprogrammet klikker du på plussikonet for å legge til en arbeidsflythandling.
   • I høyre panel velger du Forsinkelse til hendelsen skjer.
   • Konfigurer forsinkelsen:
     • Klikk på rullegardinmenyen Hendelse, og velg deretter en egendefinert hendelse.
     • Velg deretter hendelsesegenskapen du vil utsette forsinkelsen på.
     • Velg filteret for hendelsesegenskapen.
     • Klikk på Bruk filter.
   • • Velg maksimal ventetid, eller merk av i avmerkingsboksen Forsink så lenge som mulig.
5. Klikk på Lagre.

Merk: Alle hendelsesregistreringsutløsere blir separert ved hjelp av operatoren ELLER. Dette betyr at bare én av hendelsesregistreringsutløserne må inntreffe for at posten skal registreres i arbeidsflyten.

Arbeidsflyten vil deretter forsinke innmeldte poster til de oppfyller de angitte egendefinerte hendelseskriteriene eller utløses når hendelsen inntreffer.