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 drie 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 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 de event visualizer: volg paginaweergaven of geklikte elementen door ze op je website te selecteren. Meer informatie over het maken van aangepaste gebeurtenissen met de Gebeurtenis visualisatie.
• Spreadsheet importeren: upload een spreadsheet met gebeurtenisgegevens om offline activiteit vast te leggen, gegevens aan te vullen of handmatig een tool te integreren met HubSpot.

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 codefragment maken of de API-aanroep definiëren die de gebeurtenis zal triggeren.

Gebeurtenis aanmaken via API

Als je gegevens via de API naar HubSpot verstuurt, moet je het eindpunt Aangepaste evenementdefinitie gebruiken om je evenement te maken. Vervolgens moet je de API-aanroep definiëren om het evenement te triggeren. 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 opvragen:

• Gebeurtenisnaam: de interne naam voor de gebeurtenis.
• Namen van eigenschappen: de interne namen voor de eigenschappen 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:

• Ga in je HubSpot-account naar Rapportage > Gegevensbeheer > Aangepaste gebeurtenissen.
• Klik op Aangepaste gebeurtenissen.
• Klik op de naam van het evenement. Je komt dan op de pagina met de details van het evenement.
• Zoek bovenaan de naam van de gebeurtenis onder Interne naam.
  
  

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

Gebeurtenissen maken met een Javascript codefragment

• Ga in je HubSpot-account naar Rapportage > Gegevensbeheer > Aangepaste gebeurtenissen.
• Klik rechtsboven op Een gebeurtenis maken.
• Selecteer code Javascript.

• Klik op Volgende.
• Voer een evenementnaam in en geef optioneel een beschrijving van je evenement 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 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).

Eigenschappen voor een gebeurtenis maken:

• Selecteer het type eigendom door op het Veldtype voor je eigendom 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.
  • Klik voor opsommingseigenschappen op Volgende en voer uw eigenschappen Labels en Waarden in. Je moet je waarden en labels instellen voordat je er gegevens naartoe stuurt. Als deze stap niet is voltooid voordat u gegevens verzendt die niet in de lijst staan, kunnen de gegevens niet worden gebruikt. Als u meerdere waarden wilt verzenden, scheidt u ze met een puntkomma.
  • Klik op Klaar.
  • 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.
• Na het instellen van de gebeurtenis en de eigenschappen ervan, kun je deze gebeurtenis toevoegen aan de trackingcode van je website door een Javascript codefragment te selecteren.

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 een Javascript codefragment. Gebruik het knipsel in het rechter paneel om de gebeurtenis in HubSpot te volgen. Eventuele aangepaste eigenschappen worden vooraf gedefinieerd in het codefragment.
• Wijzig het knipsel naar wens door tekst in te voeren in het rechterpaneel. Elke 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.

• Ga in je HubSpot-account naar Rapportage > Gegevensbeheer > Aangepaste gebeurtenissen.

• Klik rechtsboven op Een gebeurtenis maken.
• Selecteer Spreadsheet importeren.

• Klik op Volgende.
• Voer een evenementnaam in en geef optioneel een beschrijving van je evenement op.
• Selecteer een Gekoppeld object. Hiermee kun je voltooide evenementen koppelen aan verschillende objecten in HubSpot, waaronder Contacten, Bedrijven, Deals en Tickets.

• Sleep een bestand naar het gedeelte Kies een bestand of klik op Kies een bestand om een bestand vanaf je computer te uploaden.

• Klik op het vervolgkeuzemenu om de taal van je kolomkoppen te selecteren.

• Klik op Volgende.
• In het scherm Map kolommen in je bestand naar HubSpot eigenschappen, zal HubSpot de kolommen in je bestand mappen naar de contact- en evenementeigenschappen op basis van de koptekst, de kopteksttaal en de naam van de eigenschap.
• De Mapping Guide geeft de eigenschappen weer die nodig zijn om contactpersonen en gebeurtenissen te maken en/of bij te werken. Als in uw bestand een van de eigenschappen ontbreekt die nodig zijn om het doel van uw import te voltooien, moet u uw importbestand herstellen en de import opnieuw starten om fouten te voorkomen.
• Kolommen in je spreadsheet kunnen worden toegewezen aan contacteigenschappen of evenementeigenschappen. Klik op het vervolgkeuzemenu Importeren als om te selecteren hoe de gegevens in het bestand moeten worden geïmporteerd. Selecteer vervolgens de HubSpot-eigenschap waaraan je de gegevens wilt koppelen. Je kunt het toewijzen aan een bestaande eigenschap of een nieuwe eigenschap maken.

• Klik op Volgende.
• Bevestig de naam van je importbestand.
• Klik op het selectievakje om ermee akkoord te gaan dat contactpersonen van je verwachten te horen en dat je importbestand geen gekochte lijst bevat. Meer informatie over het beleid voor acceptabel gebruik van HubSpot.
• Klik op het vervolgkeuzemenu om de datumnotatie van de eigenschap Voorgekomen op te selecteren.
• Klik op Voltooien import.

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 ingevuld zijn.

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

• Navigeer naar een contactpersoonrecord die een aangepaste gebeurtenis heeft voltooid.
• Om een tijdlijn van een contactpersoon te filteren op voltooide gebeurtenissen, klikt u op Activiteit filteren en selecteert u 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.

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.

• Ga in je HubSpot-account naar Automatiseringen > Workflows.
• 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 registratiecriteria 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 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.