Let op: De Nederlandse vertaling van dit artikel is alleen bedoeld voor het gemak.

Maak aangepaste gedragsevents met de codewizard

Laatst bijgewerkt: juni 21, 2023

Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:

Met aangepaste gedragsevents kun je gebeurtenissen definiëren en bijhouden die uniek zijn voor jouw bedrijf. Aangepaste gedragsevents kunnen worden gekoppeld aan evenementeigenschappen, die je vervolgens kunt gebruiken in de tools van HubSpot. Gebeurtenissen die zijn gemaakt met het "Javascript codefragment voegen automatisch gebeurtenisgegevens toe aan de HubSpot trackingcode van je site en vereisen iemand die bekend is met Javascript om ze in te stellen. Handmatig bijgehouden gebeurtenissen gebruiken de analytics API en vereisen een ontwikkelaar om in te stellen.

Leer hoe je de tool voor aangepaste gedragsevents kunt gebruiken om events voor geklikte elementen en bezochte URL's te maken.

Let op: de tool voor aangepaste gedragsevents vervangt de oudere tool voor gedragsevents. Gebeurtenissen die zijn aangemaakt in de oudere tool blijven werken en je kunt deze gebeurtenissen nog steeds beheren en analyseren in de oudere tool.

Het proces voor het maken van events bestaat uit twee delen:

Het definiëren van de gebeurtenis in HubSpot, inclusief alle aangepaste eigenschappen van de gebeurtenis.
Het maken van een Javascript Code Snippet of het definiëren van de API aanroep die het evenement zal triggeren.

Het evenement maken in HubSpot

Om een aangepast gedragsevenement in te stellen, maak je eerst het evenement aan en koppel je vervolgens eigenschappen aan het evenement:

Ga in je HubSpot account naar Rapporten > Analyse tools.
Klik op Aangepaste gedragsgebeurtenissen.
Klik rechtsboven op Aangepaste gebeurtenis maken.
Selecteer Code Wizard.

Voer een naam voor de gebeurtenis in en geef optioneel een beschrijving van de gebeurtenis op.
Selecteer in het vervolgkeuzemenu uw Gekoppeld object. Hiermee kun je de voltooiing van je evenement koppelen aan verschillende objecten in HubSpot, zoals Contacten, Bedrijven, Deals en Tickets.

name-custom-behavioral event

Klik op Volgende om verder te gaan.

Gebeurteniseigenschappen toevoegen

Wanneer een evenement wordt aangemaakt, zijn er standaard evenementeigenschappen beschikbaar. Je kunt ook je eigen aangepaste eigenschappen maken. Eigenschappen voor gebeurtenissen worden apart van andere CRM-eigenschappen opgeslagen en zijn uniek voor de gebeurtenis (u kunt deze eigenschappen dus niet bewerken vanuit uw accountinstellingen).

Zo maakt u eigenschappen voor een evenement:

Selecteer het eigenschapstype door op het Veldtype voor uw eigenschap te klikken. De opties omvatten:

Aangepaste tekenreeks-eigenschap: maak een eigenschap die een platte teksttekenreeks is.
Aangepaste numerieke eigenschap: maak een eigenschap die een numerieke waarde is.
Aangepastetijdstempeleigenschap: maak een eigenschap die een datumwaarde is. Je moet je gegevens verzenden in de vorm van epoch-milliseconden of ISO8601.
Aangepaste opsommingseigenschap: maak een eigenschap met een reeks vooraf gedefinieerde waarden.
Wanneer u uw eigenschap hebt geselecteerd, configureert u de eigenschap in het rechterpaneel:

- Voer een naam in voor de eigenschap en voer een Beschrijving in voor de eigenschap.
- Voor opsommingseigenschappen klikt u op Volgende en voert u Labels en Waarden in. U moet uw waarden en labels instellen voordat u er gegevens naar verzendt. Als deze stap niet is voltooid voordat u gegevens verzendt die niet in de lijst staan, zijn de gegevens niet beschikbaar om te gebruiken. Om meerdere waarden te verzenden, scheidt u ze met een puntkomma.
- Klik op Gereed.

- Zodra je eigenschap is gemaakt, verschijnt deze in de tabel onder de standaard gebeurteniseigenschappen van HubSpot. Je kunt je eigenschap bewerken of verwijderen door de vervolgkeuzelijst Acties te selecteren en Bewerken of Verwijderen te kiezen.
Klik op Volgende.

Nadat je het evenement en de eigenschappen ervan hebt ingesteld, kun je dit evenement toevoegen aan de trackingcode van je website door een Javascript codefragment te selecteren of gegevens naar HubSpot verzenden via de API door Gegevens naar HubSpot verzenden te selecteren.

Een Javascript codefragment maken

Door gebeurtenissen met een Javascript codefragment te maken, kun je automatisch Javascript aan je HubSpot trackingcode toevoegen. Dit kan worden gebruikt voor het vastleggen van complexere gebeurtenisgegevens die de trackingcode standaard niet vastlegt.

Selecteer Javascript code snippet. Gebruik het knipsel in het rechterpaneel om het evenement in HubSpot te volgen. Aangepaste eigenschappen worden vooraf gedefinieerd in het codeknipsel.
Wijzig het knipsel naar behoefte door tekst in te voeren in het rechterpaneel. Alle code die je toevoegt, wordt automatisch opgenomen als onderdeel van je HubSpot trackingcode.
Als je klaar bent, klik je op Maken om je evenement te voltooien en automatisch te beginnen met bijhouden.

Gegevens verzenden naar HubSpot

Als je gegevens naar HubSpot verstuurt, moet je de API-aanroep definiëren om het evenement te activeren. Lees in de HubSpot documentatie voor ontwikkelaars hoe je een API-oproep definieert.

Je hebt een aantal gegevens nodig voor je API-aanroep, die je vanuit HubSpot kunt verkrijgen:

Gebeurtenisnaam: de interne naam voor het evenement.
Property namen: de interne namen voor de properties waarnaar je data gaat sturen.

Om het maken van je evenement voor het verzenden van gegevens via API af te ronden:

Selecteer Gegevens verzenden naar HubSpot en kopieer de Tracking ID.
Klik op Maken.

Om de interne evenementnaam voor een bestaand evenement en de namen van eigenschappen te vinden:

Ga in je HubSpot account naar Rapporten > Analyse tools..
Klik op Aangepaste gedragsgebeurtenissen.
Klik op de naam van de gebeurtenis. U gaat vervolgens naar de pagina met de details van de gebeurtenis.
Zoek bovenin naar de naam van de gebeurtenis onder Interne naam.

Om de interne namen te vinden voor de eigenschappen die u gaat bijwerken, klikt u op de naam van een eigenschap.
Klik in het rechterpaneel op het codepictogram en bekijk de naam onder Interne naam.

Let op:
Bij het verzenden van gegevens naar je gebeurtenis zijn de onderstaande limieten van toepassing:

De namen van de eigenschappen zijn beperkt tot 50 tekens.
URL- en referrereigenschappen kunnen maximaal 1024 tekens bevatten, terwijl alle andere eigenschappen maximaal 256 tekens kunnen bevatten.
Elke voltooide gebeurtenis kan gegevens bevatten voor maximaal 50 eigenschappen.
Interne namen van eigenschappen moeten beginnen met een letter en alleen kleine letters a-z, cijfers 0-9 en underscores bevatten. Eigenschappen met dezelfde interne naam na kleine letters worden beschouwd als duplicaten en slechts één van de eigenschappen zal worden gebruikt bij voltooiing.

Als deze limieten worden overschreden bij een HTTP API verzoek, zal het verzoek mislukken. Als deze limieten worden overschreden bij een JS API verzoek, zal HubSpot alle waarden van de eigenschapsnaam inkorten tot de toegestane lengte en/of slechts 50 eigenschappen per voltooide gebeurtenis bijwerken.

Aangepaste gedragsgebeurtenisgegevens gebruiken

Aangepaste gedragsgebeurtenisgegevens kunnen worden bekeken en gebruikt in de tools van HubSpot. Lees hieronder waar je event completies kunt bekijken en op welke manieren je die gegevens in andere tools kunt opnemen.

Rapporteren over aangepaste gebeurtenissen

Aangepaste gedragsevenementen kunnen worden geanalyseerd vanuit de tool voor aangepaste gedragsevenementen en gebeurtenisgegevens zijn ook beschikbaar in de custom report builder en attributierapporten.

Meer informatie over het analyseren van uw aangepaste gedragsevents.

Voltooide gebeurtenissen weergeven op de tijdlijn van contactpersonen

Voltooide gebeurtenissen worden weergegeven op de tijdlijn van de contactrecord, samen met alle eigenschappen die werden ingevuld.

Zo bekijkt u gebeurtenisdetails op de tijdlijn van de contactpersoon:

Navigeer naar een contactrecord die een aangepaste gedragsgebeurtenis heeft voltooid.
Om een tijdlijn van een contactpersoon te filteren op voltooide gebeurtenissen, klikt u op Activiteit filteren en selecteert u vervolgens Aangepaste gedragsgebeurtenis.
Klik in de tijdlijn van de contactpersoon om de gebeurtenis uit te vouwen om de details van de gebeurtenis weer te geven.

Aangepaste gedragsgebeurtenissen gebruiken in workflows

In een workflow kunt u vertragen op basis van voltooiing van aangepaste gedragsgebeurtenissen met behulp van een actieUitstellen tot gebeurtenis plaatsvindt:

Ga in je HubSpot account naar Automatisering > Workflows.
Klik op de naam van een workflow. Of lees hoe u een nieuwe workflow maakt.
Klik in de workflow editor op het + plus pictogram om een workflow actie toe te voegen.
Selecteer in het rechterpaneel Vertraging tot gebeurtenis plaatsvindt.
Configureer de vertraging:

Klik op het vervolgkeuzemenu Gebeurtenis en selecteer een aangepaste gedragsgebeurtenis.
Selecteer vervolgens de eigenschap van de gebeurtenis waarop u wilt vertragen.
Selecteer de filter voor de gebeurteniseigenschap.
Klik op Filter toepassen.

Selecteer de maximale wachttijd of schakel het selectievakje Zo lang mogelijk vertragen in.

Klik op Opslaan.

De workflow vertraagt dan ingeschreven records totdat ze voldoen aan de opgegeven criteria voor aangepaste gedragsgebeurtenissen.

Was dit artikel nuttig? Yes No

Dit formulier wordt alleen gebruikt voor feedback op documentatie. Ontdek hoe je hulp krijgt met HubSpot.