Spring til indhold
Bemærk:Oversættelsen af denne artikel er kun til rådighed for nemheds skyld. Oversættelsen oprettes automatisk via en oversættelsessoftware og er muligvis ikke blevet korrekturlæst. Den engelske version af denne artikel bør således anses for at være den gældende version, der indeholder de seneste oplysninger. Du kan få adgang til den her.

Opret brugerdefinerede adfærdshændelser med kodeguiden

Sidst opdateret: juni 28, 2023

Gælder for:

Marketing Hub Enterprise

Brugerdefinerede adfærdshændelser giver dig mulighed for at definere og spore hændelser, der er unikke for din virksomhed. Brugerdefinerede adfærdshændelser kan knyttes til hændelsesegenskaber, som du derefter kan bruge på tværs af HubSpots værktøjer. Hændelser, der oprettes med "Javascript-kodestykket, tilføjer automatisk hændelsesdata til dit websteds HubSpot-sporingskode og kræver en person, der er fortrolig med Javascript, for at blive sat op. Manuelt sporede events bruger analyse-API'en og kræver en udvikler for at blive sat op.

Lær, hvordan du bruger værktøjet til brugerdefinerede adfærdshændelser til at oprette hændelser for klikkede elementer og besøgte URL'er.

Bemærk: Værktøjet til brugerdefinerede adfærdshændelser erstatter det tidligere værktøj til adfærdshæ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 event består af to dele:

  • Definition af begivenheden i HubSpot, herunder eventuelle brugerdefinerede begivenhedsegenskaber.
  • Oprettelse af et Javascript-kodeuddrag eller definition af det API-kald , der skal udløse begivenheden.

Opret begivenheden i HubSpot

For at oprette en brugerdefineret adfærdsbegivenhed skal du først oprette begivenheden og derefter knytte egenskaber til begivenheden:

  • Naviger i din HubSpot-konto til Rapporter > Analyseværktøjer.
  • Klik på Custom Behavioral Events.
  • Klik på Opret brugerdefineret begivenhed øverst til højre.
  • Vælg Kodeguide.

  • Indtast et begivenhedsnavn, og angiv eventuelt din begivenhedsbeskrivelse.
  • Vælg dit tilknyttede objekt i dropdown-menuen. Dette giver dig mulighed for at forbinde dine eventafslutninger med forskellige objekter i HubSpot, herunder kontakter, virksomheder, tilbud og billetter.

name-custom-behavioral event

  • Klik på Næste for at fortsætte.

Tilføj egenskaber for begivenheden

Når en begivenhed oprettes, vil standardbegivenhedsegenskaber være tilgængelige. Du kan også oprette dine egne brugerdefinerede egenskaber. Begivenhedsegenskaber gemmes separat fra andre CRM-egenskaber og er unikke for begivenheden (dvs. du kan ikke redigere disse egenskaber fra dine kontoindstillinger).

Sådan opretter du egenskaber for en begivenhed:

  • Vælg egenskabstypen ved at klikke på felttypen for din egenskab. Valgmulighederne omfatter:
    • Egenskab forbrugerdefineret streng: Opret en egenskab, der er en almindelig tekststreng.
    • Brugerdefineret talegenskab: Opret en egenskab, der er en talværdi.
    • Egenskab for brugerdefinerettidsstempel: Opret en egenskab, der er en datoværdi. Du skal sende dine data i form af epoch milliseconds eller ISO8601.
    • Brugerdefineret enumeration-egenskab: Opret en egenskab med et sæt foruddefinerede værdier.

      create-property-custom-behavioral-event
    • Når du har valgt din egenskab, skal du konfigurere egenskaben i højre panel:

    • Indtast et navn til egenskaben, og indtast en beskrivelse til egenskaben.
    • For Enumeration-egenskaber skal du klikke på Next og indtaste din egenskabs Labels og Values. Du skal indstille dine værdier og etiketter, før du sender data til dem. Hvis du ikke gennemfører dette trin, 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, skal du adskille dem med et semikolon.
    • Klik på Udført.
    • Når din egenskab er oprettet, vises den i tabellen under HubSpots standardhændelsesegenskaber. Du kan redigere eller slette din egenskab ved at vælge rullemenuen Handlinger og vælge Rediger eller Slet.
  • Klik på Næste.
  • Når du har konfigureret begivenheden og dens egenskaber, kan du enten tilføje denne begivenhed til din hjemmesides sporingskode ved at vælge Javascript-kodestykke eller sende data til HubSpot via API ved at vælge Send data til HubSpot.

Opret en Javascript-kodestump

Når du opretter events med en Javascript-kodestump, kan du automatisk tilføje Javascript til din HubSpot-sporingskode. Det kan bruges til at indfange mere komplekse hændelsesdata, som sporingskoden ikke indfanger som standard.

  • Vælg Javascript-kodestykke. Brug kodestykket i højre panel til at spore begivenheden i HubSpot. Alle brugerdefinerede egenskaber, der oprettes, vil være foruddefineret i kodestykket.
  • Rediger kodestykket 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-sporingskode.
  • Når du er færdig, skal du klikke på Opret for at afslutte din begivenhed og automatisk starte sporingen.
    example-code-snippet-custom-event

Send data til HubSpot

Hvis du sender data til HubSpot, skal du definere det API-kald, der skal udløse begivenheden. Find ud af, hvordan du definerer dit API-kald i HubSpots udviklerdokumentation.

Du skal bruge et par oplysninger til dit API-kald, som du kan få inde fra HubSpot:

  • Begivenhedsnavn: det interne navn på begivenheden.
  • Egenskabsnavne: de interne navne på de egenskaber, du vil sende data til.

Sådan afslutter du oprettelsen af din begivenhed til at sende data via API:

  • Vælg Send data til HubSpot , og kopier Tracking ID.
  • Klik på Opret.

Sådan finder du det interne hændelsesnavn for en eksisterende hændelse og egenskabsnavne:

  • Naviger i din HubSpot-konto til Rapporter > Analyseværktøjer.
  • Klik på Custom Behavioral Events.
  • Klik på navnet på begivenheden. Du kommer nu til siden med hændelsesoplysninger.
  • Øverst skal du finde begivenhedens navn under Internt navn.
    internal-name-custom-event
  • For at finde de interne navne på 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 begivenhed, gælder nedenstående grænser:
  • Egenskabsnavnene er begrænset til 50 tegn.
  • URL- og referrer-egenskaber kan modtage op til 1024 tegn, mens alle andre egenskaber kan modtage op til 256 tegn.
  • Hver hændelsesafslutning 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 understregninger. Egenskaber med det samme interne navn efter små bogstaver betragtes som dubletter, og kun én af egenskaberne vil blive brugt ved færdiggørelsen.
Hvis disse grænser overskrides, når der laves en HTTP API-anmodning, vil anmodningen mislykkes. Hvis disse grænser overskrides, når der laves en JS API-anmodning, vil HubSpot afkorte alle egenskabsnavneværdier til den tilladte længde og/eller kun opdatere 50 egenskaber pr. hændelsesafslutning.

Brug brugerdefinerede adfærdsmæssige hændelsesdata

Brugerdefinerede adfærdsmæssige hændelsesdata kan ses og bruges på tværs af HubSpots værktøjer. Nedenfor kan du se, hvor du kan se fuldførte hændelser, og hvordan du kan inkorporere disse data i andre værktøjer.

Rapportér om brugerdefinerede events

Afslutninger af brugerdefinerede adfærdshændelser kan analyseres fra værktøjet til brugerdefinerede adfærdshændelser, og hændelsesdata vil også være tilgængelige i den brugerdefinerede rapportbygger og attributionsrapporter.

Få mere at vide om at analysere dine brugerdefinerede adfærdshændelser.

Se fuldførte events på kontaktens tidslinje

Afsluttede begivenheder vises på tidslinjen for kontaktoptegnelsen sammen med eventuelle egenskaber, der blev udfyldt.

Sådan ser du hændelsesdetaljer på kontaktens tidslinje:

  • Naviger til en kontaktoptegnelse, der har gennemført en brugerdefineret adfærdshændelse.
  • Hvis du vil filtrere en kontakts tidslinje efter afsluttede begivenheder, skal du klikke på Filtrer aktivitet og derefter vælge Brugerdefineret adfærdsbegivenhed.
  • Klik på kontaktens tidslinje for at udvide hændelsen og få vist hændelsesdetaljerne.

Brug brugerdefinerede adfærdshændelser i workflows

I et workflow kan du forsinke baseret på brugerdefinerede adfærdshændelser ved hjælp af en Delay until event happens-handling:

  • Naviger i din HubSpot-konto til Automatisering > Arbejdsgange.
  • Klik på navnet på et workflow. Eller lær, hvordan du opretter et nyt workflow.
  • Klik på + plus-ikonet i workflow-editoren for at tilføje en workflow-handling.
  • I højre panel skal du vælge Delay until event happens.
  • Konfigurer forsinkelsen:
    • Klik på dropdown-menuen Begivenhed, og vælg derefter en brugerdefineret adfærdsbegivenhed.
    • Vælg derefter den hændelsesegenskab, som du vil forsinke på.
    • Vælg filteret for hændelsesegenskaben.
    • Klik på Anvend filter.
    • Vælg den maksimale ventetid, eller marker afkrydsningsfeltet Forsink så længe som muligt .
  • Klik på Gem.

Workflowet vil derefter forsinke tilmeldte poster, indtil de opfylder de angivne brugerdefinerede kriterier for adfærdshændelser.

Var denne artikel nyttig?
Denne formular bruges kun til dokumentationsfeedback. Læs, hvordan du kan få hjælp hos HubSpot.