Aangepaste evenementen maken

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 in alle HubSpot-tools kunt gebruiken.

Er zijn verschillende manieren om aangepaste gebeurtenissen te maken:

• Verzenden via API: gebruik het Custom event definition eindpunt om je evenement 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 (alleen voorOperations Hub Professional en Enterprise): pas de voorwaarden aan waardoor een webhook wordt geactiveerd en de gegevens die worden verzonden.

Let op: de tool Aangepaste events vervangt de oudere legacy tool voor events. 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 aanmaken van een evenement bestaat uit twee delen:

• Het evenement definiëren in HubSpot, inclusief aangepaste evenementeigenschappen.
• Een Javascript Code Snippet maken of de API aanroep definiëren die het evenement zal triggeren.

Gebeurtenis aanmaken via API

Als je gegevens via API naar HubSpot verstuurt, 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-aanroep, die je vanuit HubSpot kunt opvragen:

• Gebeurtenisnaam: de interne naam voor de gebeurtenis.
• Property-namen: de interne namen voor de properties waar je gegevens naartoe stuurt.

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 gebeurtenisnaam te vinden voor een bestaande gebeurtenis en namen van eigenschappen:

1. Ga in je HubSpot-account naar Gegevensbeheer > Aangepaste evenementen.
2. Klik op de naam van het evenement. Je komt dan op de pagina met details van de gebeurtenis.
3. Bovenaan vind je de naam van de gebeurtenis onder Interne naam. Om de interne naam te kopiëren, klik je op het pictogram Kopiëren naast de naam.
   
   
4. Om de interne namen te vinden voor de eigenschappen die je gaat bijwerken, klik je op de naam van een eigenschap.
5. Klik in het rechterpaneel op het codepictogram en bekijk de naam onder Interne naam.

Gebeurtenissen maken met een Javascript codefragment

1. Ga in je HubSpot-account naar Gegevensbeheer > Aangepaste evenementen.
2. Klik rechtsboven op Een gebeurtenis maken.
3. Selecteer Code Javascript.

4. Voer een naam voor de gebeurtenis in en geef optioneel een beschrijving van de gebeurtenis.
5. Selecteer een Gekoppeld object. Hiermee kun je voltooide evenementen koppelen aan verschillende objecten in HubSpot, waaronder Contacten, Bedrijven, Deals en Tickets.

6. Klik op Volgende.

Eigenschappen toevoegen

Wanneer een gebeurtenis wordt aangemaakt, zullen standaard gebeurteniseigenschappen beschikbaar zijn. U kunt ook uw 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).

1. Ga in je HubSpot-account naar Gegevensbeheer > Aangepaste evenementen.
2. Klik rechtsboven op Een gebeurtenis maken.
3. Selecteer Code Javascript.
4. Voer een naam in voor de gebeurtenis en geef optioneel een beschrijving van de gebeurtenis op.
5. Om het maken van standaard-eigenschappen voor gebeurtenissen uit te schakelen, zet je Standaard-eigenschappen voor gebeurtenissen op uit.
6. 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.
7. Wanneer 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 Labels en Waarden in.
     • Opsommingseigenschappen kunnen enkelvoudig of meervoudig worden geselecteerd. 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 gegevens naartoe stuurt. Als deze stap niet is voltooid voordat je gegevens verstuurt die niet in de lijst staan, zijn de gegevens niet beschikbaar om te gebruiken. Als je meerdere waarden via de API wilt verzenden, moet je ze scheiden met een puntkomma.

9. Klik op Volgende.
10. 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.
11. Klik op Gereed.

Gebeurtenissen maken met een Javascript codefragment 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 een Javascript codefragment. Gebruik het knipsel in het rechterpaneel om de gebeurtenis in HubSpot te volgen. Aangepaste eigenschappen worden vooraf gedefinieerd in het codefragment.
• 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.
  

Gebeurtenisgegevens importeren

Upload je aanwezigheidsgegevens van persoonlijke evenementen, tijdstempelgegevens van apps die je niet in 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.

• E-mailadres contactpersoon.
• Voorgekomen op tijdstempel. Meer informatie over het opmaken van datumeigenschappen in importbestanden.

Voorbeeldbestand

Aangepaste gebeurtenissen importeren:

1. . Ga in je HubSpot-account naar Gegevensbeheer > Aangepaste evenementen.
2. Klik rechtsboven op Een gebeurtenis maken.
3. Selecteer Spreadsheet importeren.

4. Voer een naam voor de gebeurtenis in en geef optioneel een beschrijving van de gebeurtenis.
5. Selecteer een Gekoppeld object. Op dit moment kunnen gebeurtenissen die zijn aangemaakt via importeren alleen worden gekoppeld aan contactpersonen.

6. Upload het bestand. Selecteer hoe u de objecten en de bestandstaal wilt importeren en klik op Volgende.
7. Koppel kolommen aan eigenschappen van gebeurtenissen en contactpersonen en klik op Volgende.
8. Bevestig de naam van uw importbestand.
9. 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.
10. Selecteer de datumnotatie van de eigenschap Voorgekomen bij.
11. Klik op Voltooien import.

Gebeurtenissen aanmaken via API

1. Ga in je HubSpot-account naar Gegevensbeheer > Aangepaste evenementen.
2. Klik rechtsboven op Een gebeurtenis maken.
3. Selecteer Verzenden via API.

4. Voer een evenementnaam in en geef optioneel een beschrijving van je evenement op.

5. 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.

6. Objecten koppelen:
   • Klik op het vervolgkeuzemenu Selecteer eenprimair object en selecteer vervolgens een gekoppeld object. Hiermee kun je je voltooide gebeurtenissen 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.
7. Klik op Volgende.
8. Om de gebeurtenis in HubSpot te volgen, klik je opKopiëren naast de tracking-ID.
9. Klik op Gebeurtenis maken.

Webhooks instellen

Stel de voorwaarden in die een webhook activeren.

1. Ga in je HubSpot-account naar Gegevensbeheer > Aangepaste evenementen.
2. Klik rechtsboven op Een gebeurtenis maken.
3. Selecteer Webhooks instellen.
4. Voer een Eventnaam in en selecteer een Gekoppeld object.

5. Klik op Volgende.
6. 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.
7. Klik op Volgende.
8. Bekijk de eigenschappen voor uw webhook. Klik op het vervolgkeuzemenu Type eigenschap om een type eigenschap te selecteren.

9. Klik op Volgende.
10. 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 de voltooiingen van evenementen kunt bekijken en op welke manieren je die gegevens in andere tools kunt opnemen.

Je kunt je geselecteerde gebeurtenissen direct openen in bepaalde HubSpot-tools met de vervolgkeuzelijst voor acties in je gebeurtenissenlijst, de weergave van afzonderlijke gebeurtenissen of de rechterbovenhoek van grafieken op het tabblad Analyseren.

Rapport over aangepaste gebeurtenissen

Voltooiingen van aangepaste evenementen kunnen worden geanalyseerd met de tool voor aangepaste evenementen en gebeurtenisgegevens zullen ook beschikbaar zijn in de custom report builder en attributierapporten.

Meer informatie over het analyseren van je aangepaste gebeurtenissen.

Voltooiingen van evenementen bekijken op de tijdlijn van contactpersonen

Gebeurtenissen die voltooid zijn, verschijnen op de tijdlijn van de contactrecord, samen met alle eigenschappen die werden ingevuld.

Om de details van het evenement op de contacttijdlijn te bekijken:

1. Navigeer naar een contactpersoonrecord die een aangepaste gebeurtenis heeft voltooid.
2. Als u een tijdlijn van een contact wilt filteren op voltooide gebeurtenissen, klikt u op Activiteit filteren en selecteert u Aangepaste gebeurtenis.
3. Klik in de tijdlijn van de contactpersoon om de gebeurtenis uit te vouwen en de details van de gebeurtenis weer te geven.

Aangepaste gebeurtenissen in workflows gebruiken

In een workflow kun je vertragen op basis van aangepaste voltooiingen van gebeurtenissen met behulp van een actieUitstellen tot gebeurtenis plaatsvindt of een trigger voor de registratie van gebeurtenissen.

1. Ga in je HubSpot-account naar Automatisering > Workflows.
2. Klik op de naam van een workflow. Of leer hoe u een nieuwe workflow maakt.
3. 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.
4. 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 uitstellen in.
5. Klik op Opslaan.

Let op: alle event enrollment triggers worden gescheiden met de OR operator. Dit betekent dat slechts één van de triggers voor gebeurtenisinschrijving moet optreden om het record in de workflow in te schrijven.

De workflow vertraagt dan ingeschreven records totdat ze voldoen aan de opgegeven criteria voor aangepaste gebeurtenissen of wordt geactiveerd wanneer de gebeurtenis plaatsvindt.