Opprett egendefinerte aktiviteter

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

Det finnes forskjellige måter å opprette egendefinerte aktiviteter på: 

• Send via API: bruk sluttpunktet for egendefinert hendelsesdefinisjon til å opprette hendelsen. Derfra bruker du aktivitets-ID-en sammen med sluttpunktet for send egendefinert aktivitet for å sende aktivitetsfullføringer til HubSpot.
• Hent data fra nettstedet ditt uten API:
  • Kode-Javascript: Ved hjelp av egendefinert Javascript kan du sette inn egendefinert kode i HubSpot-sporingsskriptet ved hjelp av kodeeditoren.
  • Bruk aktivitetsvisualisering (kun Marketing Hub Enterprise): Spor sidevisninger eller elementer du klikker på, ved å velge dem på nettstedet ditt. Finn ut mer om hvordan du oppretter egendefinerte aktiviteter med aktivitetsvisualiseringen.
• Importer regneark: Last opp et regneark med hendelsesdata for å registrere frakoblet aktivitet, fylle på data eller integrere verktøy manuelt med HubSpot.
• Konfigurere webhooks (kun Operations Hub Professional og Enterprise): Tilpass betingelsene som utløser en webhook som skal avfyres, og dataene som skal sendes. 

Merk: Verktøyet for egendefinerte aktiviteter erstatter det eldre verktøyet for tidligere aktiviteter. Eventuelle aktiviteter som opprettes i det eldre verktøyet, vil fortsette å fungere, og du kan fortsatt administrere og analysere disse aktivitetene i det eldre verktøyet. 

Hendelsesopprettingsprosessen består av to deler:

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

Opprett arrangement via API

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

Du trenger litt informasjon for API-anropet ditt, som du kan få fra HubSpot:

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

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

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

Slik finner du det interne aktivitetsnavnet for en eksisterende aktivitets- og egenskapsnavn:

1. Gå til Datahåndtering > Tilpassede hendelser i HubSpot-kontoen din.
2. Klikk på navnet på aktiviteten. Du vil deretter bli tatt til siden med aktivitetsdetaljer.
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 på egenskapene du skal oppdatere, klikker du på navnet på en egenskap.
5. Klikk på kodeikonet i panelet til høyre, og vis deretter navnet under Internt navn.

Opprett aktiviteter med en Javascript-kodebit

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

4. Skriv inn et navn på konkurransen og oppgi eventbeskrivelsen din.
5. Velg et tilknyttet objekt. Dette gjør at du kan knytte dine fullførte aktiviteter til forskjellige objekter i HubSpot, inkludert Kontakter, Selskaper, Tilbud 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 egendefinerte egenskaper. Aktivitetsegenskaper lagres separat fra andre CRM-egenskaper, og er unike for aktiviteten (dvs. du kan ikke redigere disse egenskapene fra kontoinnstillingene). 

1. Gå til Datahåndtering > Tilpassede hendelser i HubSpot-kontoen din.
2. Klikk på Opprett en aktivitet øverst til høyre.
3. Velg Kode Javascript.
4. Skriv inn et aktivitetsnavn, og oppgi eventuelt aktivitetsbeskrivelsen din.
5. Hvis du vil deaktivere opprettelsen av standardhendelsesegenskaper, slår du standardhendelsesegenskapene av.
6. Hvis du vil opprette egendefinerte egenskaper, velger du eiendomstypen ved å klikke på felttypen for eiendommen din. Alternativer inkluderer: 
   • Egenskap for egendefinert streng: Opprett en egenskap som er en ren tekststreng. 
   • Egenskap for egendefinert nummer: Opprett en egenskap som er en tallverdi.
   • Egendefinert tidsstempelegenskap: Opprett en egenskap som er en datoverdi. Du må sende dataene dine i form av epokemillisekunder eller ISO8601.
   • Egenskap for egendefinert dato: Opprett en egenskap som er en datoverdi.
   • Egendefinert boolsk egenskap: Opprett en egenskap som er en boolsk verdi. 
   • Egendefinert opplistingsegenskap: Opprett en egenskap med et sett med forhåndsdefinerte verdier.
7. Når du har valgt egenskapen din, konfigurerer du egenskapen i høyre panel:

8. Skriv inn et navn på eiendommen og skriv inn en beskrivelse for eiendommen.
   • For Opptellingsegenskaper klikker du på Neste og angir eiendommens etiketter og verdier.
     • Opptellingsegenskaper kan være enkelt- eller flervalg. Hvis du vil aktivere flervalgverdier, slår du på Støtt flerverdi.

• • • 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 er i listen, vil dataene ikke være tilgjengelige for bruk. For å sende flere verdier via API, separer dem med et semikolon.

9. Klikk på Neste.
10. Når du har konfigurert aktiviteten og dens egenskaper, kan du legge til denne aktiviteten i nettstedets sporingskode ved å velge Javascript-kodebiten.
11. Klikk på Ferdig.

Når du oppretter aktiviteter med en Javascript-kodebit, kan du legge til Javascript i HubSpot-sporingskoden automatisk. Dette kan brukes til å registrere mer komplekse hendelsesdata som sporingskoden ikke registrerer som standard. 

• Velg Javascript-kodebit. Bruk kodebiten i panelet til høyre for å spore aktiviteten i HubSpot. Alle 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, inkluderes automatisk som en del av HubSpot-sporingskoden.
• Når du er ferdig, klikker du på Opprett for å fullføre aktiviteten og automatisk begynne å spore. 
  

Importer hendelsesdata

Last opp deltakelsesdata fra fysiske arrangementer, tidsstemplede data fra apper du ikke integrerer med HubSpot, enkeltstående kundeemne- eller kampanjedata fra en leverandør eller andre hendelsesdata i regnearkform. Hendelser lar deg registrere atferd og deretter bruke atferden på tvers av HubSpot. 

• Kontakt epostadresse.
• Oppstod ved tidsstempel. Finn ut mer om formatering av datoegenskaper i importfiler.

Eksempelfil

Slik importerer du egendefinerte aktiviteter:

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

4. Skriv inn et navn på konkurransen og oppgi eventbeskrivelsen din.
5. Velg et tilknyttet objekt. For øyeblikket kan aktiviteter 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. Tilordne kolonner til aktivitets- og kontaktegenskaper, og klikk deretter på Neste.
8. Bekreft navnet på importfilen.
9. klikk på avmerkingsboksen for å godta at kontakter 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 Opptrådt på eiendommen.
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 aktivitet øverst til høyre.
3. Velg Send via API.

4. Skriv inn et aktivitetsnavn, og oppgi eventuelt aktivitetsbeskrivelsen din. 

5. Slik legger du til egendefinerte aktivitetsegenskaper
   • Skriv inn et eiendomsnavn. Dette navnet vil også bli brukt på det interne navnet.
   • Klikk på rullegardinmenyen Felttype, og velg en felttype.
   • Eventuelt kan du 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 Select a p rimary object, og velg deretter et tilknyttet objekt. Dette gjør at du kan knytte dine fullførte arrangementer til forskjellige objekter, inkludert kontakter, selskaper, avtaler og billetter.
   • Klikk på Tilpass treff og velg matchende ID mellom aktivitets- og objektpostene. Arrangementet kobles bare til objektposten når de samsvarende ID-ene er identiske. Hvis du bruker en egendefinert samsvars-ID, må objektegenskapen du velger, kreve unike verdier.
7. Klikk på Neste.
8. Hvis du vil spore aktiviteten i HubSpot, klikker du på C opy ved siden av sporings-ID-en.
9. Klikk på Opprett aktivitet.

Konfigurer webhooks

Angi betingelsene som vil utløse en webhook.

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

5. Klikk på Neste.
6. Sett opp en testkonkurranse:
   • Kopier Webhook-nettadressen. 
   • Gå til webhook-innstillingssiden i tredjepartsappen du vil integrere med.
   • Lim inn den kopierte nettadressen.
   • Klikk på Send en testaktivitet.
7. Klikk på Neste.
8. Se gjennom egenskapene for webhooken din. Klikk på rullegardinmenyen Eiendomstype for å velge en eiendomstype. 

9. Klikk på Neste.
10. Velg en egenskap fra din tredjeparts webhook som er en eksakt match for en HubSpot-objektegenskap. 

Bruk egendefinerte hendelsesdata

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

Du kan åpne de valgte aktivitetene direkte i utvalgte HubSpot-verktøy med nedtrekksmenyen for handlinger i aktivitetslisten, enkeltaktivitetsvisningen eller øverst til høyre i diagrammer i fanen Analyser.

Rapporter om egendefinerte aktiviteter

Fullføringer av egendefinerte aktiviteter kan analyseres fra det egendefinerte aktivitetsverktøyet, og aktivitetsdata vil også være tilgjengelig i den egendefinerte rapportbyggeren og attribusjonsrapporter.

Finn ut mer om å analysere de tilpassede aktivitetene dine.

Se fullførte aktiviteter på kontakttidslinjen

Konkurransefullføringer vil vises på kontaktpostens tidslinje, sammen med eventuelle egenskaper som ble fylt ut.

Slik viser du aktivitetsdetaljer på kontakttidslinjen:

1. Gå til en kontaktoppføring som har fullført en egendefinert aktivitet.
2. Hvis du vil filtrere en kontakttidslinje etter fullførte aktiviteter, klikker du på Filtrer aktivitet og velger Egendefinert aktivitet.
3. Klikk på kontakttidslinjen for å utvide aktiviteten for å vise aktivitetsdetaljene.

Bruk egendefinerte aktiviteter i arbeidsflyter

I en arbeidsflyt kan du forsinke basert på egendefinerte fullføringer av aktiviteter ved hjelp av en forsinkelse til hendelsen skjer eller en aktivitetsregistreringsutløser.

1. Gå til Automatisering > Arbeidsflyter i HubSpot-kontoen din.
2. Klikk på navnet på en arbeidsflyt. Eller finn ut hvordan du oppretter en ny arbeidsflyt.
3. For å legge til en utløser:
   • Klikk på Konfigurer utløsere i arbeidsflytredigereren.
   • Velg Når en hendelse inntreffer i det venstre panelet. Sett opp utløseren, og klikk deretter på Bruk filter.
   • Hvis du vil finjustere utløseren ytterligere, klikker du på Legg til finjusteringsf Du kan velge flere egenskaper for å avgrense objektene du vil registrere i arbeidsflyten.
   • Som standard vil poster bare registreres i en arbeidsflyt første gang de møter registreringsutløserne. Hvis du vil aktivere ny registrering, velger du Ja, registrer på nytt hver gang utløseren oppstår under Skal [objekt] registreres på nytt i denne arbeidsflyten?.
4. For å legge til en forsinkelse:
   • Klikk på + pluss-ikonet i arbeidsflytredigereren for å legge til en arbeidsflythandling.
   • I det høyre panelet velger du Delay until event happens.
   • Konfigurer forsinkelsen:
     • Klikk på rullegardinmenyen Aktivitet, og velg deretter en egendefinert aktivitet.
     • Velg deretter aktivitetsegenskapen du vil forsinke.
     • Velg filteret for aktivitetsegenskapen.
     • Klikk på Bruk filter.
   • • Velg maksimal ventetid, eller merk av for Forsinkelse så lenge som mulig .
5. Klikk på Lagre.

Merk: Alle aktivitetsregistreringsutløsere vil bli separert ved hjelp av OR-operatoren. Dette betyr at bare én av aktivitetsregistreringsutløserne må oppstå for at posten skal kunne registreres i arbeidsflyten.

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