HubSpot Kennisbank

Handmatig bijgehouden aangepaste gedragsgebeurtenissen creëren

Geschreven door HubSpot Support | Oct 6, 2020 4:09:55 AM

Handmatig bijgehouden aangepaste gedragsevents stellen u in staat om events te definiëren en bij te houden die uniek zijn voor uw bedrijf. Aangepaste gedragsevents kunnen worden gekoppeld aan event-eigenschappen, die u vervolgens kunt gebruiken in HubSpot's tools. Handmatig bijgehouden gebeurtenissen maken gebruik van de Analytics API, en vereisen een ontwikkelaar om in te stellen.

Leer hoe u de custom behavioral event tool kunt gebruiken om clicked element events en visited URL events te creëren.

Let op: de aangepaste gedragsevents tool vervangt de vorige gedragsevents legacy tool. Alle events die in de legacy-tool zijn gemaakt, blijven werken en u kunt deze events nog steeds beheren en analyseren in de legacy-tool.

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

  • Het definiëren van de gebeurtenis in HubSpot, inclusief eventuele aangepaste gebeurtenis eigenschappen.
  • Het definiëren vande API call die de gebeurtenis zal triggeren.

Creëer de gebeurtenis in HubSpot

Om een aangepaste gedragsevent in te stellen, zul je eerst de event aanmaken, en vervolgens eigenschappen aan de event koppelen:

  • { local.navAnalyticsTools }}
  • Klik op Custom Behavioral Events.
  • Klik in de rechterbovenhoek op Gebeurtenismaken.
  • Voer in het rechtervenster eennaam in voor uw gebeurtenis en selecteer vervolgensHandmatig bijgehouden gebeurtenis
    .


  • De gebeurtenis wordt dan gemaakt en u kunt de interne naam kopiëren, die zal worden gebruikt bij het maken van het API-verzoek. Om de interne naam te kopiëren, klikt u opKopiëren.

Stel vervolgens de eigenschappen in die u zult gebruiken in uw API verzoek.

Gebeurteniseigenschappen toevoegen en beheren

Wanneer u een gebeurtenis aanmaakt, zal een set van standaard gebeurtenis eigenschappen beschikbaar zijn voor u om te gebruiken. U kunt echter ook uw eigen aangepaste eigenschappen maken. Gebeurteniseigenschappen worden apart opgeslagen van andere CRM-eigenschappen, en zijn uniek voor de gebeurtenis (d.w.z. u kunt deze eigenschappen niet bewerken vanuit uw accountinstellingen).

Om eigenschappen voor een gebeurtenis te bekijken en aan te maken:

  • { local.navAnalyticsTools }}
  • Klik opAangepaste gedragsevents.
  • Klik op denaam van de gebeurtenis die u wilt bekijken of bijwerken. U komt dan op de detailpagina van de gebeurtenis.
  • Bekijk in de tabel Eigenschappen de standaardeigenschappen die voor de gebeurtenis zijn gemaakt.
  • Om een eigenschap te bewerken:
    • Klik op de naam van de eigenschap.
    • In het rechterpaneel kunt u een nieuwenaamofbeschrijving invoeren. Het wijzigen van de naam van de eigenschap zal de interne naam niet wijzigen, dus u hoeft uw API-oproep niet bij te werken als u de naam van een eigenschap wijzigt.
    • Om het veldtype te wijzigen en de eigenschap verder te configureren, klik op de Veldtype tab, gebruik dan de dropdown menu's om een nieuwveldtype te selecteren en configureer uw eigenschap details.
    • Klik opOpslaan.
  • Om een nieuwe eigenschap te maken:
    • Klik rechtsboven opCreate property.
    • Configureer de eigenschap in het rechterpaneel:
      • Selecteer een groepering voor de eigenschap door op het vervolgkeuzemenu Groep te klikken en vervolgens een groep te selecteren.
      • Om de naam van de eigenschap in te stellen, voert u een naam in het veldLabel in. De naam die u invoert zal automatisch de interne naam voor de eigenschap creëren.
        • Om de interne naam te bewerken, klikt u op het pictogram met de codecode en vervolgens op het veld Interne naam om een nieuwe naam in te voeren. Zodra de eigenschap is aangemaakt, kan de interne naam niet meer worden bijgewerkt.

          Let op:het label en de interne naam van de eigenschap zijn beperkt tot 50 tekens.
        • Om de naam op te slaan, klikt u op Opslaan.
      • Voer optioneel een beschrijving voor de eigenschap in het veldDescription (Beschrijving ) in.
      • Klik opVolgende.
      • Selecteer het type eigenschap door op het vervolgkeuzemenu Veldtypete klikken en vervolgens een veldtype te selecteren. Standaard zal de eigenschap beschikbaar zijn in formulieren en bots. Om te voorkomen dat het veld wordt gebruikt in formulieren en bots, klikt u op om het selectievakje Show in formsuit te schakelen.
    • Klik opMaken.

De API-oproep definiëren

Nadat u de gebeurtenis en de eigenschappen ervan hebt ingesteld, moet u de API-oproep definiëren om de gebeurtenis te activeren. Leer hoe u uw API-oproep definieert in HubSpot's documentatie voor ontwikkelaars.

U heeft een aantal gegevens nodig voor uw API-oproep, die u binnen HubSpot kunt opvragen:

  • Event name: de interne naam voor het event.
  • Property names: de interne namen voor de properties waarnaar je data zult sturen.

Om de interne event naam en property namen te vinden:

  • { local.navAnalyticsTools }}
  • Klik opCustom Behavioral Events.
  • Klik op denaam van de gebeurtenis. U wordt dan naar de event details pagina gebracht.
  • Zoek bovenaan de naam van de gebeurtenis onderInterne naam.

  • Om de interne namen te vinden voor de eigenschappen die u gaat bijwerken, klikt u op denaam van een eigenschap.
  • In het rechter paneel, klik op het code icoon, en bekijk dan de naam onderInterne naam.

Let op: houd bij het verzenden van gegevens naar uw gebeurtenis rekening met de volgende beperkingen:

  • Het label van de eigenschap en de interne naam zijn beperkt tot 50 tekens.
  • URL en referrer eigenschappen kunnen tot 1024 karakters ontvangen, terwijl alle andere eigenschappen tot 256 karakters kunnen ontvangen.
  • Elk gebeurteniscomplement kan gegevens bevatten voor maximaal 50 eigenschappen.
  • Interne namen van eigenschappen moeten beginnen met een letter en mogen 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 het invullen.

Als deze limieten worden overschreden bij het maken van een HTTP API verzoek, zal het verzoek mislukken. Als deze limieten worden overschreden bij het maken van een JS API verzoek, zal HubSpot elke eigenschap naam waarden afkappen tot de toegestane lengte en/of slechts 50 eigenschappen bijwerken per gebeurtenis voltooiing.

Aangepaste gedragseventgegevens gebruiken

Aangepaste gedragseventgegevens kunnen worden bekeken en gebruikt in HubSpot's tools. Leer hieronder waar u gebeurtenisvoltooiingen kunt bekijken en de manieren waarop u die gegevens in andere tools kunt opnemen.

Rapportage over aangepaste gebeurtenissen

Aangepaste gedragsevent voltooiingen kunnen worden geanalyseerd vanuit de tool voor aangepaste gedragsevents, en eventgegevens zullen ook beschikbaar zijn in de custom report builder en attributierapporten.

Meer informatie over het analyseren van uw aangepaste gedragsevenementen.

Voltooiingen van gebeurtenissen bekijken op de tijdlijn van contactpersonen

Gebeurtenisvoltooiingen verschijnen op de tijdlijn van de contactpersoonrecord, samen met alle eigenschappen die werden ingevuld.

Om details van gebeurtenissen op de tijdlijn van de contactpersoon te bekijken:

  • Navigeernaar een contactpersoonrecord die een aangepaste gedragsevenement heeft voltooid.
  • Om een contacttijdlijn te filteren op voltooide gebeurtenissen, klik opFilter activiteit en selecteer vervolgensAangepaste gedragsgebeurtenis.

  • Klik in de contacttijdlijn op om de gebeurtenis uit te vouwen en de details van de gebeurtenis weer te geven
    .


Aangepaste gedragsevenementen gebruiken in workflows

In een workflow kunt u uitstellen op basis van aangepaste gedragsevent voltooiingen met behulp van een actieUitstellen tot gebeurtenis plaatsvindt:

  • Klik op de naamvan een workflow. Of, leer hoe u een nieuwe workflow maakt.
  • In de workflow editor, klik op het+ plus icoonom een workflow actie toe te voegen.
  • Selecteer in het rechterpaneelUitstellen tot gebeurtenis plaatsvindt.

  • Configureer de vertraging:
    • Klik op het vervolgkeuzemenu Gebeurtenis en selecteer vervolgens een aangepaste gedragsevent.
    • Selecteer vervolgens de eigenschap van de gebeurtenis waarop u wilt vertragen.
    • Selecteer hetfilter voor de event-eigenschap.
    • Klik opFilter toepassen.

    • Selecteer de maximale wachttijd, of schakel het selectievakje Zo lang mogelijk uitstellen in.
  • Klik opOpslaan.

De workflow zal dan ingeschreven records vertragen totdat ze voldoen aan de gespecificeerde aangepaste gedragseventcriteria.