Brugerdefinerede hændelser giver dig mulighed for at definere og spore hændelser, der er unikke for din virksomhed. Brugerdefinerede hændelser kan knyttes til hændelsesegenskaber, som du derefter kan bruge på tværs af HubSpots værktøjer.
Der er forskellige måder at oprette brugerdefinerede hændelser på:
- Send via API: Brug slutpunktet Brugerdefineret hændelsesdefinition til at oprette din hændelse. Derefter skal du bruge dit begivenheds-ID med slutpunktet send Brugerdefinerede hændelser til at sende hændelsesafslutninger til HubSpot.
- Indsaml data fra dit websted uden API:
- Kode Javascript: Ved hjælp af Kundekode Javascript kan du indsætte brugerdefineret kode i dit HubSpot-sporingsscript ved hjælp af kodeeditoren.
- Brug event visualizer (kunMarketing Hub Enterprise ): Spor sidevisninger eller klikkede elementer ved at vælge dem på din hjemmeside. Få mere at vide om at oprette Brugerdefinerede hændelser med Event visualizer.
- Importer regne ark: upload et regneark med data om hændelser for at fange offline aktivitet, udfylde data eller manuelt integrere et hvilket som helst værktøj med HubSpot.
- Opsæt webhooks (kunOperations Hub Professional og Enterprise): Tilpas de betingelser, der trigger en webhook, og de data, der bliver sendt.
Bemærk: Værktøjet til brugerdefinerede hændelser erstatter det tidligere værktøj til hændelser. Alle hændelser, der er oprettet i det gamle værktøj, vil fortsat fungere, og du kan stadig administrere og analysere disse hændelser i det gamle værktøj.
Processen med at oprette en hændelse består af to dele:
- Definere hændelsen i HubSpot, herunder eventuelle brugerdefinerede hændelsesegenskaber.
- Oprettelse af en Javascript Kodestykke eller definition af den API-anmodning , der vil trigge hændelsen.
Opret hændelse via API
Hvis du sender data til HubSpot via API, kan du bruge indstillingen Send via API eller bruge slutpunktet Brugerdefineret hændelsesdefinition til at oprette dinhændelse. Læs mere om at definere din API-anmodning i HubSpots udviklerdokumentation.
Du skal bruge et par oplysninger til din API-anmodning, som du kan få inde fra HubSpot:
- Navn på hændelse: det interne navn på hændelsen.
- Egenskabernes navne: de interne navne på de egenskaber, du vil sende data til.
For at afslutte oprettelsen af din hændelse til at sende data via API:
- Vælg Send data til HubSpot , og kopier Sporing ID.
- Klik på Opret.
For at finde det interne hændelsesnavn for en eksisterende hændelse og navne på egenskaber:
- Klik på navnet på hændelsen. Du kommer derefter til siden med detaljer om hændelsen.
- Øverst finder du navnet på hændelsen under Internt navn. For at kopiere det interne navn skal du klikke på kopi-ikonet ved siden af navnet.
- For at finde de interne navne for de egenskaber, du vil opdatere, skal du klikke på navnet på en egenskab.
- Klik på kodeikonet i højre panel, og se derefter navnet under Internt navn.
Bemærk venligst:
Når du sender data til din hændelse, gælder nedenstående grænser:
- Egenskabernes navne er begrænset til 50 tegn.
- Egenskaber for URL og henviser kan modtage op til 1024 tegn, mens alle andre egenskaber kan modtage op til 256 tegn.
- Hver hændelse kan indeholde data for op til 50 egenskaber.
- Egenskabernes interne navne skal starte med et bogstav og må kun indeholde små bogstaver a-z, tal 0-9 og understregningstegn. Egenskaber med samme interne navn efter små bogstaver betragtes som dubletter, og kun én af egenskaberne vil blive brugt ved afslutningen.
Hvis disse grænser overskrides i forbindelse med en HTTP API-anmodning, vil anmodningen mislykkes. Hvis disse grænser overskrides, når der foretages en JS API-anmodning, vil HubSpot afkorte alle egenskabsnavnsværdier til den tilladte længde og/eller kun opdatere 50 egenskaber pr. afsluttet hændelse.
Opret hændelser med et Javascript kodestykke
- Klik på Opret en hændelse øverst til højre.
- Vælg Code Javascript.
- Indtast et navn på hændelsen, og angiv eventuelt en beskrivelse af hændelsen.
- Vælg et Tilknyttet objekt. Dette giver dig mulighed for at tilknytte dine begivenhedsafslutninger til forskellige objekter i HubSpot, herunder Kontakter, Virksomheder, Hændelser og Tickets.
- Klik på Næste.
Tilføj egenskaber
Når en hændelse oprettes, vil standard egenskaberne for hændelsen være tilgængelige. Du kan også oprette dine egne tilpassede egenskaber. Egenskaber for hændelser gemmes separat fra andre CRM-egenskaber og er unikke for hændelsen (dvs. du kan ikke redigere disse egenskaber fra dine kontoindstillinger).
- Klik på Opret en hændelse øverst til højre.
- Vælg Code Javascript.
- Indtast et navn på hændelsen, og angiv eventuelt en beskrivelse af hændelsen.
- Hvis du vil slå oprettelsen af standard egenskaber for hændelser fra, skal du slå Standard egenskaber for hændelser fra.
- Hvis du vil oprette brugerdefinerede egenskaber, skal du vælge egenskabstypen ved at klikke på Felttype for din egenskab. Valgmulighederne omfatter:
- Egenskab for brugerdefineret streng: Opret en egenskab, der er en ren tekststreng.
- Egenskab for brugerdefineret tal: Opret en egenskab, der er en talværdi.
- Egenskab for brugerdefineret tidsstempel: opret en egenskab, der er en datoværdi. Du skal sende dine data i formularer med epochemillisekunder eller ISO8601.
- Egenskab for brugerdefineret dato: Opret en egenskab, der er en datoværdi.
- Egenskab for boolean: Opret en egenskab, der er en boolean-værdi.
- Brugerdefineretenumerationsegenskab: opret en egenskab med et sæt foruddefinerede værdier.
- Når du har valgt din egenskab, skal du konfigurere den i det højre panel:
- Indtast et navn for egenskaben, og indtast en beskrivelse af egenskaben.
- For opregningsegenskaber skal du klikke på Næste og indtaste dine egenskabers Labels og Values.
- Egenskaber for opremsning kan være enkelt- eller flervalgsværdier. For at aktivere værdier med flere valg skal du slå Support multi-value toggle til.
-
-
- Du skal indstille dine værdier og labels, før du sender data til dem. Hvis dette trin ikke er gennemført, før du sender data, der ikke er på listen, vil dataene ikke være tilgængelige for brug. Hvis du vil sende flere værdier via API, skal du adskille dem med et semikolon.
Bemærk: Det er ikke muligt at importere egenskaber for opremsninger med flere valg.
- Klik på Næste.
- Når du har konfigureret hændelsen og dens egenskaber, kan du tilføje denne hændelse til dit websteds sporingskode ved at vælge Javascript kodestykke.
- Klik på Udført.
Når du opretter hændelser med et Javascript-kodestykke, kan du automatisk tilføje Javascript til din HubSpot-sporingskode. Dette kan bruges til at indfange mere komplekse data om hændelser, som sporingskoden ikke indfanger som standard.
- Vælg Javascript kodestykke. Brug tekstblokken i højre panel til at spore hændelsen i HubSpot. Eventuelle tilpassede egenskaber, der oprettes, vil være foruddefineret i kodestykket.
- Ændr tekstblokken efter behov ved at indtaste tekst i det højre panel. Enhver kode, du tilføjer, vil automatisk blive inkluderet som en del af din HubSpot-sporing.
- Når du er færdig, skal du klikke på Opret for at færdiggøre din hændelse og automatisk starte sporing.
Importer data om hændelser
Upload dine deltagelsesdata fra personlige hændelser, tidsstemplede data fra apps, som du ikke integrerer med HubSpot, engangsdata om leads eller kampagner fra en leverandør eller andre data om hændelser i regnearksform. Hændelser giver dig mulighed for at fange adfærd og derefter bruge adfærden på tværs af HubSpot.
Importere kan
oprette og opdatere
kontaktregistre.
Importerede hændelser kan kun bruges til hændelser, der allerede har fundet sted.
Følgende skal indgå i en fil til import af brugerdefinerede hændelser:
Eksempel på fil
For at importere brugerdefinerede hændelser:
- .
- Klik på Opret en hændelse øverst til højre.
- Vælg Importer regneark.
- Indtast et navn på hændelsen, og angiv eventuelt en beskrivelse af hændelsen.
- Vælg et tilknyttet objekt. På nuværende tidspunkt kan hændelser, der er oprettet via import, kun tilknyttes kontakter.
- Upload filen. Vælg , hvordan objekterne skal importeres, og hvilket sprog filen skal være på, og klik derefter på Næste.
- Tilknytkolonner til egenskaber for hændelser og kontakter, og klik derefter på Næste.
- Bekræft navnet på din importerede fil.
- klik på afkrydsningsfeltet for at acceptere, at kontakterne forventer at høre fra dig, og at din importerede fil ikke indeholder en købt liste. Få mere at vide om HubSpots politik for acceptabel brug.
- Vælg datoformatet for Egenskaben Opstået ved.
- Klik på Afslut import.
Opret hændelser via API
- Klik på Opret en hændelse øverst til højre.
- Vælg Send via API.
- Indtast et navn på hændelsen, og angiv eventuelt en beskrivelse af hændelsen.
- For at tilføje brugerdefinerede hændelser:
- Skriv et navn på en egenskab. Dette navn vil også blive anvendt på det interne navn .
- Klik på rullemenuen Felttype, og vælg en felttype.
- Tilføj eventuelt en beskrivelse.
- Hvis du vil tilføje flere brugerdefinerede egenskaber, skal du klikke på + Tilføj brugerdefineret egenskab.
- Klik på Næste.
- For at linke objekter:
- Klik på rullemenuen Vælg etprimært objekt, og vælg derefter et tilknyttet objekt. Dette giver dig mulighed for at tilknytte dine afsluttede begivenheder til forskellige objekter, herunder kontakter, virksomheder, deals og tickets.
- Klik på Tilpas matchet, og vælg dit matchende ID mellem dine hændelses- og objektregistre. Hændelsen vil kun linke til objektregistret, når deres matchende ID'er er identiske. Hvis du bruger et brugerdefineret matchende ID, skal den egenskab ved objektet, du vælger, kræve unikke værdier.
- Klik på Næste.
- For at spore hændelsen i HubSpot skal du klikke påKopier ud for sporings-ID'et.
- Klik på Opret hændelse.
Vær opmærksom på dette:
- Du kan kun matche egenskaber for hændelser og egenskaber for objekter af samme datatype.
- Hvis det er nødvendigt, kan du redigere det brugerdefinerede objekt senere, men du kan ikke ændre det primære objekt, der er valgt.
Sæt webhooks op
Indstil de betingelser, der skal trigge en webhook.
- Klik på Opret en hændelse øverst til højre.
- Vælg Opsætning af webhooks.
- Indtast et navn på hændelsen, og vælg et tilknyttet objekt.
- Klik på Næste.
- Opret en testhændelse:
- Kopier webhook-URL'en.
- Naviger til indstillingssiden for webhook i den tredjepartsapp, du vil integrere med.
- Indsæt den kopierede URL.
- Klik på Send en testhændelse.
- Klik på Næste.
- Anmeld egenskaberne for dit webhook. Klik på rullemenuen Egenskabstype for at vælge en egenskabstype.
- Klik på Næste.
- Vælg en egenskab fra dit tredjeparts webhook, der svarer nøjagtigt til en egenskab i et HubSpot-objekt.
Brug data om brugerdefinerede hændelser
Data om brugerdefinerede hændelser kan ses og bruges på tværs af HubSpots værktøjer. Nedenfor kan du se, hvor du kan se gennemførte hændelser, og hvordan du kan indarbejde disse data i andre værktøjer.
Du kan åbne dine valgte hændelser direkte i udvalgte HubSpot-værktøjer med rullemenuen for handlinger på listen over hændelser, i visningen af en enkelt hændelse eller i øverste højre hjørne af diagrammerne på fanen Analyser.
Rapportering om brugerdefinerede hændelser
Brugerdefinerede hændelser kan analyseres fra værktøjet til brugerdefinerede hændelser, og hændelsesdata vil også være tilgængelige i den brugerdefinerede rapportgenerator og tilskrivningsrapporter.
Få mere at vide om at analysere dine brugerdefinerede hændelser.
Se afsluttede hændelser på kontaktens tidslinje
Afsluttede hændelser vises på kontaktregistrets tidslinje sammen med eventuelle egenskaber, der blev udfyldt.
For at se detaljer om hændelsen på tidslinjen for kontakt:
- Naviger til et kontaktregister, der har gennemført en brugerdefineret hændelse.
- Hvis du vil filtrere en tidslinje for kontakter efter gennemførte hændelser, skal du klikke på Filtrer aktivitet og derefter vælge Brugerdefineret hændelse.
- Klik på hændelsen i kontaktens tidslinje for at udvide den og få vist detaljer om hændelsen.
Brug brugerdefinerede hændelser i arbejdsgange
I en arbejdsgang kan du forsinkelse baseret på brugerdefinerede hændelser ved hjælp af en Forsinkelse indtil hændelse sker-handling eller en tilmeldingstrigger.
- Klik på navnet på en arbejdsgang. Eller lær, hvordan du opretter en ny arbejdsgang.
- For at tilføje en trigger:
- Klik på Opsæt triggere i editoren til arbejdsgange.
- Vælg Når en hændelse indtræffer i venstre panel. Opsæt triggeren, og klik derefter på Anvend filter.
- Klik på Tilføj forfiningsfiltre for at forfine din trigger yderligere. Du kan vælge yderligere egenskaber for at afgrænse de objekter, du gerne vil tilmelde i arbejdsgangen.
- Som standard tilmeldes registre kun til en arbejdsgang, første gang de opfylder tilmeldingstriggerne. Hvis du vil aktivere gentilmeldingsudløseren, skal du under Should [object] be re-enrolled in this workflow? vælge Yes, re-enroll every time the trigger occurs.
- For at tilføje en forsinkelse:
- Klik på + plus-ikonet i arbejdsgangseditoren for at tilføje en arbejdsgangshandling.
- I højre panel skal du vælge Forsinkelse, indtil hændelse sker.
- Konfigurer forsinkelse:
- Klik på rullemenuen Hændelse, og vælg derefter en brugerdefineret hændelse.
- Vælg derefter den egenskab ved hændelsen, som du vil forsinkelse på.
- Vælg filteret for hændelsens egenskab.
- Klik på Anvend filter.
-
- Vælg den maksimale ventetid, eller vælg afkrydsningsfeltet Forsinkelse så længe som muligt.
- Klik på Gem.
Bemærk: Alle tilmeldingstriggere for hændelser adskilles ved hjælp af OR-operatoren. Det betyder, at kun én af tilmeldingstriggerne skal indtræffe, for at registret kan tilmeldes arbejdsgangen.
Arbejdsgangen vil derefter forsinke tilmeldte registre, indtil de opfylder de angivne kriterier for brugerdefinerede hændelser, eller vil blive tilmeldingstrigger, når hændelsen indtræffer.