Met aangepaste gebeurtenissen kun je gebeurtenissen definiëren en bijhouden die uniek zijn voor jouw bedrijf. Aangepaste gebeurtenissen kunnen worden gekoppeld aan evenementeigenschappen, die je vervolgens kunt gebruiken in de tools van HubSpot.
Er zijn verschillende manieren om aangepaste evenementen te maken:
- Verzenden via API: gebruik het eindpunt Aangepaste gebeurtenisdefinitie om uw gebeurtenis te maken. Gebruik vervolgens je gebeurtenis-ID met het eindpunt Aangepaste gebeurtenis verzenden om voltooiingen van gebeurtenissen naar HubSpot te verzenden.
- Leg gegevens van je website vast zonder de API:
- Codeer Javascript: met behulp van Custom Javascript kun je aangepaste code invoegen in je HubSpot tracking script door gebruik te maken van de code editor.
- Gebruik event visualizer (alleenMarketing Hub Enterprise ): volg paginaweergaven of geklikte elementen door ze op je website te selecteren. Meer informatie over het maken van aangepaste gebeurtenissen met de gebeurtenissenvisualisator.
- Spreadsheet importeren: upload een spreadsheet met gebeurtenisgegevens om offline activiteit vast te leggen, gegevens bij te vullen of handmatig een tool te integreren met HubSpot.
- Webhooks instellen (alleenData Hub Professional en Enterprise): pas de voorwaarden aan waardoor een webhook wordt geactiveerd en de gegevens die worden verzonden.
Let op: evenementen die zijn gemaakt in de oude tool Aangepaste evenementen werken niet meer na 1 augustus 2025.
Het proces voor het maken van evenementen bestaat uit twee delen:
- Het evenement in HubSpot definiëren, inclusief aangepaste evenementeigenschappen.
- Het creëren van een Javascript Code Snippet of het definiëren van de API call die het event zal triggeren.
Maak evenement via API
Als je gegevens via API naar HubSpot verzendt, kun je de optie Verzenden via API gebruikenof het eindpunt Aangepaste evenementdefinitiegebruiken om je evenement te maken. Lees meer over het definiëren van je API-aanroep in de HubSpot documentatie voor ontwikkelaars.
Je hebt een aantal gegevens nodig voor je API-oproep, die je vanuit HubSpot kunt verkrijgen:
- Gebeurtenis naam: de interne naam voor de gebeurtenis.
- 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 te vinden voor een bestaand evenement en de namen van eigenschappen:
- Klik op de naam van het evenement. Je komt nu op de pagina met evenementdetails.
- Zoek bovenin naar de naam van het evenement onder Interne naam. Klik op het pictogram Kopiëren naast de naam om de interne naam te kopiëren.
- Om de interne namen te vinden voor de eigenschappen die je gaat bijwerken, klik je 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 evenement 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.
Gebeurtenissen creëren met een Javascript codefragment
- Navigeer in je HubSpot-account naar Gegevensbeheer > Gebeurtenisbeheer.
- Klik rechtsboven op Een gebeurtenis maken.
- Selecteer Code Javascript.
- Voer een Gebeurtenisnaam in en geef optioneel een beschrijving van de gebeurtenis op.
- Selecteer een Gekoppeld object. Hiermee kun je voltooide evenementen koppelen aan verschillende objecten in HubSpot, waaronder Contacten, Bedrijven, Deals en Tickets.
- Klik op Volgende.
Eigenschappen toevoegen
Wanneer een evenement wordt aangemaakt, zullen standaard evenementeigenschappen beschikbaar zijn. Je kunt ook je eigen aangepaste eigenschappen maken. Evenementeigenschappen worden apart van andere CRM-eigenschappen opgeslagen en zijn uniek voor het evenement (u kunt deze eigenschappen dus niet bewerken vanuit uw accountinstellingen).
- Navigeer in je HubSpot-account naar Gegevensbeheer > Evenementbeheer.
- Klik rechtsboven op Een evenement maken.
- Selecteer Code Javascript.
- Voer een evenementnaam in en geef optioneel een evenementbeschrijving op.
- Om het maken van standaard-eigenschappen voor gebeurtenissen uit te schakelen, zet je Standaard-eigenschappen voor gebeurtenissen op Uit.
- Om aangepaste eigenschappen te maken, selecteer je het type eigenschap door op het Veldtype voor je eigenschap te klikken. Opties zijn onder andere:
- Aangepaste tekenreeks-eigenschap: maak een eigenschap die een platte tekststring is.
- Aangepaste numerieke eigenschap: maak een eigenschap die een numerieke waarde is.
- Aangepaste tijdstempeleigenschap: maak een eigenschap die een datumwaarde is. Je moet je gegevens verzenden in de vorm van epoch-milliseconden of ISO8601.
- Aangepaste datum-eigenschap: maak een eigenschap die een datumwaarde is.
- Aangepaste booleaanse eigenschap: maak een eigenschap die een booleaanse waarde is.
- 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.
- Opsommingseigenschappen kunnen enkelvoudig of meervoudig geselecteerd zijn. Als u waarden met meerdere selecties wilt inschakelen, schakelt u de optie Meerdere waarden ondersteunen in.
-
-
- Je moet je waarden en labels instellen voordat je er data naar stuurt. Als deze stap niet is voltooid voordat je data verstuurt die niet in de lijst staat, zijn de data niet beschikbaar om te gebruiken. Om meerdere waarden via de API te versturen, scheidt u ze met een puntkomma.
Let op: het is niet mogelijk om eigenschappen met meerdere selecties en opsommingen te importeren.
- Klik op Volgende.
- Na het instellen van de gebeurtenis en de eigenschappen ervan, kun je deze gebeurtenis toevoegen aan de trackingcode van je website door Javascript code snippet te selecteren.
- Klik op Gereed.
Events aanmaken met een Javascript code snippet stelt je in staat om automatisch Javascript toe te voegen aan je HubSpot tracking code. Dit kan worden gebruikt voor het vastleggen van complexere gebeurtenisgegevens die de trackingcode standaard niet vastlegt.
- Selecteer Javascript-codefragment. Gebruik het knipsel in het rechterpaneel om de gebeurtenis in HubSpot te volgen. Aangepaste eigenschappen worden vooraf gedefinieerd in het codeknipsel.
- Wijzig het knipsel indien nodig 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.
Evenementgegevens importeren
Upload je aanwezigheidsgegevens van persoonlijke evenementen, tijdstempelgegevens van apps die je niet met HubSpot integreert, eenmalige lead- of campagnegegevens van een leverancier of andere evenementgegevens in spreadsheetvorm. Met evenementen kun je gedrag vastleggen en vervolgens gebruiken in HubSpot.
Importeren kan
contactpersonencreëren en bijwerken
contactrecords.
Gebeurtenisimports kunnen alleen worden gebruikt voor gebeurtenissen die al hebben plaatsgevonden.
Het volgende moet worden opgenomen in een importbestand voor aangepaste gebeurtenissen:
Voorbeeldbestand
Aangepaste gebeurtenissen importeren:
- Navigeer in je HubSpot-account naar Gegevensbeheer > Gebeurtenisbeheer.
- Klik rechtsboven op Een gebeurtenis maken.
- Selecteer Spreadsheet importeren.
- Voer een Gebeurtenisnaam in en geef optioneel een beschrijving van de gebeurtenis op.
- Selecteer een Gekoppeld object. Op dit moment kunnen gebeurtenissen die via importeren zijn aangemaakt alleen aan contactpersonen worden gekoppeld.
- Upload het bestand. Selecteer hoe u de objecten en de bestandstaal wilt importeren en klik op Volgende.
- Koppel kolommen aan eigenschappen van gebeurtenissen en contactpersonen en klik op Volgende.
- Bevestig de naam van uw importbestand.
- Klik op het selectievakje om ermee akkoord te gaan dat contactpersonen verwachten van je te horen en dat je importbestand geen gekochte lijst bevat. Meer informatie over het beleid voor acceptabel gebruik van HubSpot.
- Selecteer de datumnotatie van de eigenschap Voorgekomen bij.
- Klik op Importeren voltooien.
Gebeurtenissen aanmaken via API
- Navigeer in je HubSpot-account naar Gegevensbeheer > Gebeurtenisbeheer.
- Klik rechtsboven op Een gebeurtenis maken.
- Selecteer Verzenden via API.
- Voer een naam voor het evenement in en geef optioneel een beschrijving van het evenement op.
- Aangepaste evenementeigenschappen toevoegen:
- Typ een naam voor de eigenschap. Deze naam wordt ook toegepast op de interne naam .
- Klik op het keuzemenu Veldtype en selecteer een veldtype.
- Voeg optioneel een beschrijving toe.
- Als u meer aangepaste eigenschappen wilt toevoegen, klikt u op + Aangepaste eigenschap toevoegen.
- Klik op Volgende.
- Objecten koppelen:
- Klik op het vervolgkeuzemenu Selecteer eenprimair object en selecteer vervolgens een gekoppeld object. Hiermee kun je je voltooide evenementen koppelen aan verschillende objecten, waaronder contactpersonen, bedrijven, aanbiedingen en tickets.
- Klik op De overeenkomst aanpassen en selecteer je overeenkomende ID tussen je gebeurtenis- en objectrecords. De gebeurtenis wordt alleen gekoppeld aan de objectrecord als hun overeenkomende ID's identiek zijn. Als je een aangepaste overeenkomende ID gebruikt, moet de objecteigenschap die je selecteert unieke waarden vereisen.
- Klik op Volgende.
- Om de gebeurtenis in HubSpot te volgen, klik je opKopiëren naast de tracking-ID.
- Klik op Gebeurtenis maken.
Let op:
- Je kunt alleen gebeurteniseigenschappen en objecteigenschappen van hetzelfde gegevenstype matchen.
- Indien nodig kun je de aangepaste overeenkomst later bewerken, maar je kunt het geselecteerde primaire object niet wijzigen.
Webhooks instellen
Stel de voorwaarden in die een webhook activeren.
- Navigeer in je HubSpot-account naar Gegevensbeheer > Gebeurtenisbeheer.
- Klik rechtsboven op Een evenement maken.
- Selecteer Webhooks instellen.
- Voer een Gebeurtenisnaam in en selecteer een Gekoppeld object.
- Klik op Volgende.
- Stel een testgebeurtenis in:
- Kopieer de Webhook URL.
- Navigeer naar de webhook-instellingenpagina in de app van derden waarmee je wilt integreren.
- Plak de gekopieerde URL erin.
- Klik op Verzend een testgebeurtenis.
- Klik op Volgende.
- Bekijk de eigenschappen voor uw webhook. Klik op het vervolgkeuzemenu Type eigenschap om een type eigenschap te selecteren.
- Klik op Volgende.
- Selecteer een eigenschap van je webhook van derden die exact overeenkomt met een HubSpot objecteigenschap.
Aangepaste gebeurtenisgegevens gebruiken
Aangepaste gebeurtenisgegevens kunnen worden bekeken en gebruikt in de tools van HubSpot. Lees hieronder waar je voltooide events kunt bekijken en op welke manieren je die gegevens in andere tools kunt opnemen.
Je kunt je geselecteerde gebeurtenissen rechtstreeks openen in bepaalde HubSpot-hulpprogramma's met de vervolgkeuzelijst voor acties in je gebeurtenissenlijst, de weergave van afzonderlijke gebeurtenissen of de rechterbovenhoek van grafieken op het tabblad Analyseren.
Rapporteren over aangepaste gebeurtenissen
Het voltooien van aangepaste evenementen kan worden geanalyseerd vanuit de tool voor aangepaste evenementen, en evenementgegevens zijn ook beschikbaar in de custom report builder en attributierapporten.
Meer informatie over het analyseren van uw aangepaste gebeurtenissen.
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.
Gebeurtenisdetails weergeven op de tijdlijn van de contactpersoon:
- Navigeer naar een contactpersoonrecord die een aangepaste gebeurtenis heeft voltooid.
- Om een tijdlijn van een contactpersoon te filteren op voltooide gebeurtenissen, klik je op Activiteit filteren en selecteer je vervolgens Aangepaste gebeurtenis.
- Klik in de tijdlijn van de contactpersoon om de gebeurtenis uit te vouwen om de details van de gebeurtenis weer te geven.
Let op: u kunt geen tijdlijnactiviteit bekijken op aangepaste gebeurtenissen die zijn aangemaakt met webhooks.
Aangepaste gebeurtenissen gebruiken in workflows
In een workflow kunt u vertragen op basis van voltooiing van aangepaste gebeurtenissen met behulp van een actieUitstellen tot gebeurtenis plaatsvindt of een trigger voor registratie van gebeurtenissen.
- Klik op de naam van een workflow. Of lees hoe u een nieuwe workflow maakt.
- Een trigger toevoegen:
- Klik in de workflow editor op Triggers instellen.
- Selecteer Wanneer een gebeurtenis plaatsvindt in het linkerpaneel. Stel de trigger in en klik op Filter toepassen.
- Om uw trigger verder te verfijnen, klikt u op Verfijningsfilters toevoegen. Je kunt extra eigenschappen selecteren om de objecten te verfijnen die je wilt aanmelden voor de workflow.
- Standaard worden records alleen in een workflow geregistreerd wanneer ze voor het eerst aan de triggers voor registratie voldoen. Om opnieuw inschrijven mogelijk te maken, selecteert u onder de sectie Moet [object] opnieuw worden ingeschreven in deze workflow? Ja, elke keer dat de trigger optreedt opnieuw inschrijven.
- Een vertraging toevoegen:
- 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 gebeurtenis.
- 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.
Let op: alle triggers voor eventregistratie worden gescheiden met de OR-operator. Dit betekent dat slechts één van de event enrollment triggers moet optreden om het record in te schrijven in de workflow.
De workflow vertraagt dan ingeschreven records totdat ze voldoen aan de opgegeven criteria voor aangepaste gebeurtenissen of wordt geactiveerd wanneer de gebeurtenis plaatsvindt.