Blog

Productgebruiksdata in HubSpot Stap-voor-stap: van event tracking tot PQL-workflow

Erik Hooijer
Erik Hooijer
· 8 min leestijd
Productgebruiksdata in HubSpot: van event tracking tot PQL-workflows

HubSpot is voor de meeste B2B SaaS scale-ups het centrale CRM. Maar zonder productdata is HubSpot blind voor wat gebruikers daadwerkelijk doen. Dit artikel geeft de concrete stappen om event data uit je product automatisch in HubSpot te krijgen, welke custom properties je aanmaakt, en hoe je er workflows op bouwt die PQL's automatisch door de pipeline sturen.

De technische integratie van productdata naar HubSpot klinkt complex maar is in de praktijk uitvoerbaar voor elk team met een basale technische capaciteit. Er zijn drie routes, en voor elk van die routes geef ik de concrete stappen.

Stap 1: Bepaal welke productdata je nodig hebt

Voordat je begint met de technische integratie, moet je bepalen welke productdata je in HubSpot wilt hebben. De valkuil is te beginnen met "stuur alles" — dat leidt tot een vervuild CRM met honderden properties die niemand gebruikt.

Begin met de minimale set die je PQL-definitie ondersteunt. Voor de meeste PLG-bedrijven zijn dit de essentiële properties:

Op contact-niveau:

  • product_activation_date — Datum waarop de gebruiker het aha-moment bereikt heeft
  • product_last_active_date — Datum van de laatste login of actie
  • product_sessions_last_30_days — Aantal sessies in de afgelopen 30 dagen
  • product_key_features_used — Lijst van geavanceerde features die de gebruiker heeft gebruikt
  • product_paywall_encounter_count — Aantal keer dat de gebruiker een premium feature probeerde maar werd geblokkeerd
  • product_invitations_sent — Aantal collega-uitnodigingen verstuurd
  • product_is_pql — Boolean: heeft dit contact de PQL-drempel bereikt?

Op company-niveau:

  • product_active_users_count — Aantal actieve gebruikers van dit bedrijf in het product
  • product_team_adoption_score — Score 0-100 die de breedte van adoptie binnen het bedrijf meet
  • product_company_plan — Huidig abonnement (free / team / business / enterprise)

Stap 2: Kies je integratieroute

Route A: Segment → HubSpot Destination (aanbevolen)

Als je Segment al gebruikt voor event tracking, is de HubSpot Destination de meest elegante oplossing. Je voegt HubSpot toe als destination in Segment (via de Segment App-directory), configureert de property-mapping, en events stromen automatisch door.

De configuratie in Segment:

  1. Ga naar Connections → Destinations → Add Destination → zoek "HubSpot"
  2. Verbind je HubSpot portal via OAuth
  3. Configureer de event-to-property mapping:
    • identify() calls mappen naar HubSpot Contact Properties
    • group() calls mappen naar HubSpot Company Properties
    • track() calls kunnen optioneel worden gemapped naar HubSpot Custom Events (voor event-based workflows)

Praktische tip: gebruik identify() niet alleen bij aanmelden, maar ook na elke significante gebruiksdrempel (activatie bereikt, 10e sessie, paywall hit). Dit zorgt dat HubSpot-properties real-time up-to-date blijven.

Route B: Directe HubSpot Contacts API

Voor teams zonder Segment: stuur productdata direct naar HubSpot via de Contacts API. Bij elke betekenisvolle event in je backend, maak je een API-call naar HubSpot.

Voorbeeld in Python:

import hubspot
from hubspot.crm.contacts import SimplePublicObjectInputForCreate

client = hubspot.Client.create(access_token="YOUR_TOKEN")

# Update contact property na activatie
properties = {
    "product_activation_date": "2025-06-01",
    "product_is_pql": "true"
}
client.crm.contacts.basic_api.update(
    contact_id=hubspot_contact_id,
    simple_public_object_input={"properties": properties}
)

De sleutel is de mapping tussen je product-user-ID en de HubSpot contact-ID. Sla de HubSpot contact-ID op in je product-database bij het aanmaken van een account (via de Contacts Create API of via de Forms API bij aanmelding).

Route C: Amplitude of Mixpanel native HubSpot-integratie

Amplitude heeft een native HubSpot-integratie waarmee je Behavioral Cohorts (groepen gebruikers die een specifieke actiesequentie hebben voltooid) kunt synchroniseren naar HubSpot Contact Lists. Deze lijsten worden automatisch bijgewerkt wanneer nieuwe gebruikers in de cohort vallen.

Configuratie in Amplitude:

  1. Maak een Behavioral Cohort aan die je PQL-criteria definieert (bijv. "heeft activation_event gedaan AND heeft in de afgelopen 14 dagen 5+ sessies gehad")
  2. Ga naar de Cohort → Sync → HubSpot
  3. Selecteer de HubSpot-lijst die je wilt synchroniseren (maak deze eerst aan in HubSpot)
  4. Stel de sync-frequentie in (daily is doorgaans voldoende)

Stap 3: Custom Properties aanmaken in HubSpot

Ga naar HubSpot Settings → Properties → Create Property. Maak de properties aan op het juiste object-niveau (Contact of Company).

Aanbevolen property-typen:

  • Datums: gebruik Date picker property type
  • Tellers (sessies, uitnodigingen): gebruik Number property type
  • Booleans (is_pql, activation_reached): gebruik Single checkbox property type
  • Lijsten (features_used): gebruik Multi-line text of Enumeration property type
  • Scores: gebruik Number property type

Groepeer alle productdata-properties in een aparte Property Group: "Product Usage Data". Dit maakt ze makkelijk vindbaar voor sales en marketing.

Stap 4: PQL-workflows bouwen

Met productdata in HubSpot kun je workflows bouwen die automatisch acties ondernemen op basis van productgedrag. De drie meest waardevolle workflows:

Workflow 1: PQL-deal aanmaken

Trigger: Contact property product_is_pql wordt true

Actions:

  1. Maak een Deal aan in de PQL-pipeline, Stage "PQL Identified"
  2. Associeer de deal met het contact en de bijbehorende company
  3. Wijs de deal toe aan de juiste AE (op basis van company_size of territory)
  4. Stuur een interne notificatie aan de AE met daarin de relevante productdata

Workflow 2: Paywall-trigger immediate outreach

Trigger: Contact property product_paywall_encounter_count wordt >= 1 AND company_employees >= 25

Actions:

  1. Voeg contact toe aan email-sequentie "Paywall Encounter - Upgrade Offer"
  2. Stuur AE een taak: "Hot PQL: paywall encounter bij [company name]"
  3. Wacht 24 uur
  4. Als geen response: stuur follow-up email met social proof van vergelijkbare bedrijven

Workflow 3: Re-engagement voor bijna-geactiveerde gebruikers

Trigger: Contact is aangemeld, maar product_activation_date is leeg EN product_last_active_date is meer dan 7 dagen geleden

Actions:

  1. Stuur email: "Heb je [product-naam] al geprobeerd voor [specifieke use case]?"
  2. Wacht 5 dagen
  3. Als geen activatie: stuur email met product-tour of video-walkthrough
  4. Wacht 7 dagen
  5. Als nog steeds geen activatie: markeer als "churned_free" en sluit uit van verdere nurturing

Stap 5: Rapportage op productdata in HubSpot

Met productdata in HubSpot kun je rapportages bouwen die eerder onmogelijk waren. De meest waardevolle:

  • Activatieratio per cohort: Welk percentage van aangemelde gebruikers bereikt de activatiedrempel? Gesegmenteerd op acquisitiekanaal, industrie of bedrijfsgrootte.
  • PQL-volume per week: Hoeveel nieuwe PQL's per week worden gegenereerd? Trending up of down?
  • Time-to-PQL: Gemiddeld aantal dagen van aanmelding tot PQL-kwalificatie. Benchmark voor de gezondheid van je onboarding.
  • PQL-to-Closed-Won conversieratio: Welk percentage van PQL's converteert naar betalende klant? Gesegmenteerd op PQL-trigger-type om te zien welke triggers het best converteren.

Lees meer over hoe je de volledige PLG-datastack opbouwt in de PLG-stack: welke tools je nodig hebt, en over hoe je productdata vertaalt naar outbound-triggers in PLG-signalen als outbound trigger.

Conclusie: het is minder complex dan het klinkt

De meeste PLG-bedrijven stellen de productdata-HubSpot-integratie uit omdat het technisch klinkt. In de praktijk heeft een team met één developer de Segment-HubSpot-integratie in twee dagen werkend. De custom properties aanmaken en de eerste workflows bouwen kost nog een dag.

De ROI is onmiddellijk: van blind navigeren met duizenden gratis gebruikers naar een CRM dat precies weet welke 5% klaar is voor een salesgesprek. Dat is de fundament-shift die de meeste PLG-bedrijven missen.