Aangepaste gebeurtenissen maken

Samenvatting

Gebruik aangepaste gebeurtenissen in HubSpot om gebeurtenissen te definiëren en bij te houden die uniek zijn voor uw bedrijf. Aangepaste gebeurtenissen kunnen worden gekoppeld aan gebeurteniseigenschappen, die u vervolgens in alle tools van HubSpot kunt gebruiken. U wilt bijvoorbeeld offline gebeurtenissen bijhouden, zoals de opkomst bij een persoonlijke productlancering.

Ontdek de drie verschillende methoden om aangepaste gebeurtenissen te maken. U kunt aangepaste gebeurtenissen verzenden via een API, een spreadsheet met gebeurtenisgegevens uploaden of webhooks gebruiken (alleenData Hub Professional en Enterprise ).

Nadat je een aangepaste gebeurtenis hebt ingesteld, kun je de gegevens van aangepaste gebeurtenissen in verschillende tools bekijken. Je kunt rapporten maken met gegevens van aangepaste gebeurtenissen, het optreden van aangepaste gebeurtenissen op de tijdlijnen van contactpersonen bekijken en aangepaste gebeurtenissen gebruiken in workflows.

Volg ten slotte de prestaties van uw aangepaste gebeurtenissen in de tool voor het beheer van aangepaste gebeurtenissen. Mogelijk moet u ook onbekende eigenschapsfoutenoplossen in de tool voor het beheer van aangepaste gebeurtenissen.

Wat zijn de verschillende methoden om aangepaste gebeurtenissen te maken?

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

• Definieer de gebeurtenis in HubSpot, inclusief eventuele aangepaste gebeurteniseigenschappen.
• Maak een JavaScript-codefragment of definieer de API-aanroep die de gebeurtenis activeert.

Er zijn verschillende manieren om aangepaste gebeurtenissen te maken: 

• Verzenden via API: gebruik het eindpunt voor aangepaste gebeurtenisdefinities om je gebeurtenis te maken. Gebruik vervolgens je gebeurtenis-ID met het eindpunt voor het verzenden van aangepaste gebeurtenissen om gebeurtenissen naar HubSpot te verzenden.
• Gegevens van uw website vastleggen zonder de API:
  • Javascript-code: met aangepast Javascript kunt u aangepaste code in uw HubSpot-trackingscript invoegen met behulp van de code-editor.
  • Gebruik de gebeurtenisvisualisator: houd paginaweergaven of aangeklikte elementen bij door ze op je website te selecteren. Lees meer over het maken van aangepaste gebeurtenissen met de gebeurtenisvisualisator.
• Spreadsheet importeren: upload een spreadsheet met gebeurtenisgegevens om offline activiteiten vast te leggen, gegevens aan te vullen of handmatig een tool te integreren met HubSpot.
• Webhooks instellen (Data Hub Alleen Professional en Enterprise ): pas de voorwaarden aan die ervoor zorgen dat een webhook wordt geactiveerd en de gegevens die worden verzonden. 

Let op: alle gebeurtenissen die zijn aangemaakt in de oude tool voor aangepaste gebeurtenissen werken niet meer na 1 augustus 2025.

Hoe maak ik aangepaste gebeurtenissen aan met behulp van de API?

Als je gegevens via de API naar HubSpot verstuurt, kun je deoptie 'Verzenden via API' gebruiken of het eindpunt voor aangepaste gebeurtenisdefinitiesgebruiken om je gebeurtenis aan te maken. Lees meer over het definiëren van je API-aanroep in de ontwikkelaarsdocumentatie van HubSpot.

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

• Naam van het evenement: de interne naam voor het evenement. 
• Eigenschapsnamen: de interne namen van de eigenschappen waarnaar je gegevens gaat verzenden.

Om het aanmaken van je gebeurtenis voor het verzenden van gegevens via de API te voltooien:

• Selecteer 'Gegevens verzenden naar HubSpot' en kopieer de tracking-ID.
• Klik op 'Aanmaken'.

Om de interne gebeurtenisnaam voor een bestaande gebeurtenis en eigenschapsnamen te vinden:

1. Ga in je HubSpot-account naarGegevensbeheer>Gebeurtenisbeheer.
2. Klik op de naam van de gebeurtenis. Je wordt dan doorgestuurd naar de pagina met de details van de gebeurtenis.
3. Zoek bovenaan de gebeurtenisnaam onder Interne naam. Klik op het kopieerpictogram naast de naam om de interne naam te kopiëren. 
   
   
4. Klik op de naam van een eigenschap om de interne namen te vinden voor de eigenschappen die je gaat bijwerken.
5. Klik in het rechterpaneel op het codepictogram en bekijk vervolgens de naam onder Interne naam.

Hoe maak ik aangepaste gebeurtenissen met JavaScript-code?

1. Ga in je HubSpot-account naarGegevensbeheer>Gebeurtenisbeheer.
2. Klik rechtsboven opEen event aanmaken en selecteer vervolgens Aangepast event aanmaken.
3. SelecteerJavaScript-code.

4. Voer een Evenementnaam in en voeg eventueel een beschrijving van je evenement toe.
5. Selecteer een gekoppeld object. Hiermee kun je je gebeurtenissen koppelen aan verschillende objecten in HubSpot, waaronder contactpersonen, bedrijven, deals en tickets. 

6. Klik opVolgende.

Hoe voeg ik eigenschappen toe aan mijn gebeurtenis?

Wanneer een gebeurtenis wordt aangemaakt, zijn er standaard gebeurteniseigenschappen beschikbaar. Je kunt ook je eigen aangepaste eigenschappen aanmaken. Gebeurteniseigenschappen worden apart van andere CRM-eigenschappen opgeslagen en zijn uniek voor de gebeurtenis (d.w.z. je kunt deze eigenschappen niet bewerken vanuit je accountinstellingen). 

1. Om het aanmaken van standaardgebeurteniseigenschappen uit te schakelen, zet je de schakelaarStandaardgebeurteniseigenschappen op uit.
2. Om aangepaste eigenschappen aan te maken, selecteert u het eigenschaptype door op het veldtype voor uw eigenschap te klikken. De opties zijn: 
   • Aangepaste tekenreeks-eigenschap: maak een eigenschap aan die bestaat uit een platte tekstreeks. 
   • Aangepaste getal-eigenschap: maak een eigenschap aan die een getalwaarde is.
   • Aangepaste tijdstempel-eigenschap: maak een eigenschap aan die een datumwaarde is. U moet uw gegevens verzenden in de vorm van epoch-milliseconden of ISO8601.
   • Aangepaste datum-eigenschap: maak een eigenschap aan 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.
3. Nadat u uw eigenschap hebt geselecteerd, configureert u de eigenschap in het rechterpaneel:

8. Voer een naam in voor de eigenschap en voer een beschrijving in voor de eigenschap.
   • Voor opsommingseigenschappen klikt u op Volgende en voert u de labels en waarden van uw eigenschap in.
     • Enumeratie-eigenschappen kunnen enkelvoudig of meervoudig geselecteerd worden. Om meervoudige waarden in te schakelen, zet u de schakelaarMeerdere waarden ondersteunen aan.

• • • 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 voor gebruik. Om meerdere waarden via de API te verzenden, scheidt u ze met een puntkomma.

9. Klik op Volgende.
10. Nadat u de gebeurtenis en de bijbehorende eigenschappen hebt ingesteld, kunt u deze gebeurtenis toevoegen aan de trackingcode van uw website door 'Javascript-codefragment' te selecteren.
11. Klik op'Gereed'.

Door gebeurtenissen aan te maken met een JavaScript-codefragment kunt u automatisch JavaScript toevoegen aan uw HubSpot-trackingcode. Dit kan worden gebruikt voor het vastleggen van complexere gebeurtenisgegevens die de trackingcode standaard niet vastlegt. 

1. Selecteer 'Javascript-codefragment'. Gebruik het fragment in het rechterpaneel om de gebeurtenis in HubSpot bij te houden. Eventuele aangemaakte aangepaste eigenschappen worden vooraf gedefinieerd in het codefragment. 
2. Pas het fragment naar behoefte aan door tekst in het rechterpaneel in te voeren. Alle code die u toevoegt, wordt automatisch opgenomen als onderdeel van uw HubSpot-trackingcode.
3. Als je klaar bent, klik je op Maken om je gebeurtenis af te ronden en automatisch te beginnen met bijhouden.
    
   

Hoe importeer ik aangepaste gebeurtenisgegevens uit spreadsheets?

Upload uw aanwezigheidsgegevens van fysieke evenementen, gegevens met tijdstempels uit apps die u niet met HubSpot integreert, eenmalige lead- of campagnegegevens van een leverancier of andere evenementgegevens in spreadsheetvorm. Met evenementen kunt u gedrag vastleggen en dit vervolgens in heel HubSpot gebruiken. 

Imports kunnen de volgende records aanmaken en bijwerken:

• Contacten

• Bedrijven
• Deals
• Tickets
• Diensten
• Projecten
• Afspraken
• Cursussen
• Advertenties 
• Bestellingen
• Aangepaste objecten

De vereiste eigenschappen variëren afhankelijk van het objecttype.

Gebeurtenisimporten kunnen alleen worden gebruikt voor gebeurtenissen die al hebben plaatsgevonden. Het volgende moet worden opgenomen in een aangepast importbestand voor evenementen:

• E-mailadres voor contact.
• Gebeurd op tijdstempel. Meer informatie over het opmaken van datum-eigenschappen in importbestanden.

Voorbeeldbestand

Om aangepaste gebeurtenissen te importeren:

1. Ga in je HubSpot-account naar Gegevensbeheer > Gebeurtenisbeheer.
2. Klik rechtsboven opEen evenement aanmaken en selecteer vervolgensAangepast evenement aanmaken.
3. Selecteer'Spreadsheet importeren'.
4. Klik op 'Een nieuw evenement maken ' of 'Importeren naar een bestaand evenement'.
   • Als u 'Importeren naar een bestaand evenement' selecteert, gebruikt u het vervolgkeuzemenu om het bestaande evenement te kiezen en gaat u vervolgens verder met de stappen om uw spreadsheet te uploaden.
   • Als u 'Maak een nieuw evenement' selecteert, gaat u verder met de onderstaande stappen.
5. Voer een Evenementnaam in en voeg desgewenst een beschrijving van uw evenement toe.
6. Selecteer een gekoppeld object. Op dit moment kunnen evenementen die via import zijn aangemaakt alleen aan contactpersonen worden gekoppeld.
7. Upload uw spreadsheet of plak de gegevens rechtstreeks vanuit uw spreadsheet. Selecteer hoe u de objecten wilt importeren en de taal van het bestand, en klik vervolgens op Volgende.
8. Koppel kolommen aan gebeurtenis- en contactgegevens en klik vervolgens op Volgende.
9. Bevestig de naam van uw importbestand.
10. Vink het selectievakje aan om te bevestigen dat contactpersonen verwachten van u te horen en dat uw importbestand geen aangekochte lijst bevat. Lees meer over het beleid voor aanvaardbaar gebruik van HubSpot.
11. Selecteer de datumnotatie van de eigenschap 'Plaats '.
12. Klik op 'Importeren voltooien'.

Hoe verstuur ik aangepaste gebeurtenissen via het API-eindpunt?

1. Ga in je HubSpot-account naarGegevensbeheer>Evenementbeheer.
2. Klik rechtsboven opEen evenement aanmaken en selecteer vervolgensAangepast evenement aanmaken.
3. SelecteerVerzenden via API.

4. Voer een Evenementnaam in en voeg eventueel een beschrijving van je evenement toe. 

5. Om aangepaste gebeurteniseigenschappen toe te voegen:
   • Typ eeneigenschapsnaam. Deze naam wordt ook gebruiktals interne naam.
   • Klik op het vervolgkeuzemenuVeldtype en selecteer een veldtype.
   • Voeg eventueel eenbeschrijving toe.
   • Als u meer aangepaste eigenschappen wilt toevoegen, klikt u op+ Aangepaste eigenschap toevoegen.
   • Klik opVolgende.

6. Om objecten te koppelen:
   • Klik op het vervolgkeuzemenu Selecteer eenprimair object en selecteer vervolgens een gekoppeld object. Hiermee kunt u uw gebeurtenissen koppelen aan verschillende objecten, waaronder contactpersonen, bedrijven, deals en tickets.
   • Klikop De koppeling aanpassen en selecteer de overeenkomende ID tussen uw gebeurtenis- en objectrecords. De gebeurtenis wordt alleen aan het objectrecord gekoppeld als de overeenkomende ID's identiek zijn. Als u een aangepaste overeenkomende ID gebruikt, moet de objecteigenschap die u selecteert unieke waarden vereisen.
7. Klik op'Volgende'.
8. Om het evenement in HubSpot bij te houden, klikt u op'Kopiëren' naast de tracking-ID.
9. Klik op'Evenement aanmaken'.

Hoe maak ik aangepaste gebeurtenissen aan met behulp van webhooks?

Stel de voorwaarden in die een webhook activeren.

1. Ga in je HubSpot-account naarGegevensbeheer>Evenementbeheer.
2. Klik rechtsboven opEen gebeurtenis aanmaken en selecteer vervolgensAangepaste gebeurtenis aanmaken.
3. SelecteerWebhooks instellen.
4. Voer eenEvenementnaam in en selecteer eenGerelateerd object.
5. Klik opVolgende.
6. Stel een testgebeurtenis in:
   • Kopieer dewebhook-URL. 
   • Ga naar depagina met webhook-instellingenin de app van een derde partij waarmee u wilt integreren.
   • Plak de gekopieerde URL.
   • Klik op Een testgebeurtenis verzenden.
7. Klik op'Volgende'.
8. Controleer de eigenschappen van je webhook. Klik op hetvervolgkeuzemenu 'Eigenschapstype'om een eigenschapstype te selecteren. 

9. Klik opVolgende.
10. Selecteer een eigenschap uit je webhook van een derde partij die exact overeenkomt met een eigenschap van een HubSpot-object. 

Waar kan ik gegevens van aangepaste gebeurtenissen bekijken en gebruiken in HubSpot?

Aangepaste gebeurtenisgegevens kunnen in alle tools van HubSpot worden bekeken en gebruikt. Hieronder leest u waar u gebeurtenissen kunt bekijken en hoe u die gegevens in andere tools kunt integreren.

U kunt de geselecteerde gebeurtenissen rechtstreeks openen in bepaalde HubSpot-tools via het actiemenu in uw gebeurtenissenlijst, de weergave van een enkele gebeurtenis of de rechterbovenhoek van grafieken op het tabblad 'Analyseren'.

Hoe maak ik rapporten met aangepaste gebeurtenisgegevens?

Aangepaste gebeurtenissen kunnen worden geanalyseerd vanuit de tool voor aangepaste gebeurtenissen, en gebeurtenisgegevens zijn ook beschikbaar in de tool voor het maken van aangepaste rapporten en in attributierapporten.

Lees meer over het analyseren van je aangepaste gebeurtenissen.

Hoe bekijk ik gebeurtenissen op de tijdlijn van een contactpersoon?

Gebeurtenissen verschijnen op de tijdlijn van het contactrecord, samen met eventuele eigenschappen die zijn ingevuld.

Om gebeurtenisgegevens op de tijdlijn van het contact te bekijken:

1. Ga naar een contactrecord waarin een aangepaste gebeurtenis heeft plaatsgevonden.
2. Om een contacttijdlijn te filteren op gebeurtenissen, klik je op Activiteit filteren en selecteer je vervolgens Aangepaste gebeurtenis.
3. Klik in de contacttijdlijn op de gebeurtenis om deze uit te vouwen en de details weer te geven.

Let op: u kunt geen tijdlijnactiviteit bekijken voor aangepaste gebeurtenissen die zijn gemaakt met behulp van webhooks.

Hoe gebruik ik aangepaste gebeurtenissen in workflows?

In een workflow kunt u een vertraging instellen op basis van aangepaste gebeurtenissen met behulp van een Vertragen totdat gebeurtenis plaatsvindt actie of een trigger voor gebeurtenisinschrijving.

1. Ga in je HubSpot-account naar Automatisering > Workflows.
2. Klik op de naam van een workflow. Of ontdek hoe je een nieuwe workflow kunt maken.
3. Een trigger toevoegen:
   • Klik in de workflow-editor op Triggers instellen.
   • Selecteer in het linkerpaneel Wanneer een gebeurtenis plaatsvindt. Stel de trigger in en klik vervolgens op Filter toepassen.
   • Om uw trigger verder te verfijnen, klikt u op Verfijningsfilters toevoegen. U kunt aanvullende eigenschappen selecteren om de objecten te verfijnen die u in de workflow wilt opnemen.
   • Standaard worden records alleen in een workflow opgenomen wanneer ze voor het eerst aan de opnametriggers voldoen. Om heropname in te schakelen, selecteert u onder het gedeelte Moet [object] opnieuw in deze workflow worden opgenomen? de optie Ja, opnieuw opnemen telkens wanneer de trigger optreedt.
4. Een vertraging toevoegen:
   • Klik in de workflow-editor op het plusteken (+) om een workflowactie toe te voegen.
   • Selecteer in het rechterpaneel 'Vertraging totdat gebeurtenis plaatsvindt'.
   • Configureer de vertraging:
     • Klik op het vervolgkeuzemenu Gebeurtenis en selecteer vervolgens een aangepaste gebeurtenis.
     • Selecteer vervolgens de gebeurteniseigenschap waarop u de vertraging wilt toepassen.
     • Selecteer het filter voor de gebeurteniseigenschap.
     • Klik op Filter toepassen.
   • • Selecteer de maximale wachttijd of vink het selectievakje 'Zo lang mogelijk uitstellen' aan.
5. Klik op Opslaan.

Let op:alle triggers voor gebeurtenisregistratie worden gescheiden met de operator OR. Dit betekent dat slechts één van de triggers voor gebeurtenisregistratie hoeft plaats te vinden om het record in de workflow te registreren.

De workflow zal vervolgens ingeschreven records uitstellen totdat ze voldoen aan de opgegeven criteria voor aangepaste gebeurtenissen of zal worden geactiveerd wanneer de gebeurtenis plaatsvindt.

Hoe beheer en volg ik de status van mijn aangepaste gebeurtenis en controleer ik leveringsfouten?

Om ervoor te zorgen dat uw gegevens accuraat blijven en uw integraties naar behoren functioneren, kunt u het tabblad Monitor gebruiken in de tool Gebeurtenisbeheer.

Hoe volg ik de prestaties in de tool voor aangepast gebeurtenisbeheer?

• Voltooiingstrends: Ga in je HubSpot-account naar Gegevensbeheer > Gebeurtenisbeheer. Klik op het tabblad Monitor om de volumes van voltooide evenementen over verschillende tijdsperioden te vergelijken.

• Problemen met afleveringsfouten oplossen: Ga in je HubSpot-account naar Gegevensbeheer > Gebeurtenisbeheer. Selecteer Afleveringsfouten in de linkerzijbalk van het tabblad Monitor. Deze tabel geeft een overzicht van gebeurtenissen die niet konden worden gesynchroniseerd en vermeldt de specifieke reden voor de fout (bijv. niet-overeenkomende gegevenstypen of schendingen van het schema).

Hoe los ik "Onbekende eigenschap"-fouten op in de tool voor aangepast gebeurtenisbeheer?

Als er via de API gegevens worden verzonden voor een eigenschap die nooit in HubSpot is gedefinieerd, verschijnt dit in het foutenlogboek. U kunt dit snel oplossen:

1. Beweeg de muisaanwijzer over de gebeurtenis in de tabel Foutlogboeken.

2. Klik op Acties en selecteer vervolgensEigenschappen toevoegen aan gebeurtenis.

3. Bevestig de voorgestelde veldtypen zodat HubSpot die gegevens onmiddellijk kan accepteren.