Woordenlijst

Gebruikerseigenschappen in GA4 instellen en erover rapporteren

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •8 min leestijd
Gebruikerseigenschappen in GA4 instellen en erover rapporterenGebruikerseigenschappen in GA4 instellen en erover rapporteren

TL;DR, kort antwoord

8 min leestijd

Gebruikerseigenschappen in GA4 zijn kenmerken van de gebruiker, zoals een abonnementsniveau of een voorkeurstaal, die GA4 toepast op elk later event van die gebruiker. Je stelt ze in met gtag('set', 'user_properties', {...}), in het gedeelte User Properties van een GA4 Event-tag in Tag Manager of via de Firebase SDK, en registreert ze daarna elk als aangepaste dimensie op gebruikersniveau om erover te rapporteren. Een standaardproperty staat 25 gebruikerseigenschappen toe en een 360-property 100. Namen stoppen bij 24 tekens, waarden bij 36, en het beleid van Google verbiedt persoonlijk identificeerbare informatie erin.

Wat zijn gebruikerseigenschappen in GA4?

Google Analytics 4 gebruikt gebruikerseigenschappen om de persoon achter de events te beschrijven, zoals een abonnementsniveau, een voorkeurstaal of een rol, en past elke waarde toe op elk later event van die gebruiker. De helppagina van Google definieert ze als "attributes that describe groups of your user base," met taalvoorkeuren en geografische locaties als voorbeelden. Gebruik ze voor feiten die over veel events heen gelden, en houd details per actie in eventparameters.

Een gebruikerseigenschap verschijnt pas in rapporten nadat je haar als aangepaste dimensie op gebruikersniveau hebt geregistreerd. Google zegt het duidelijk: "To report on the data you collect through user properties, create user-scoped custom dimensions." De helppagina over aangepaste dimensies voegt toe dat "User properties become aliases for user-scoped custom dimension slots," dus je werkt met betekenisvolle namen als customer_tier in plaats van genummerde plekken.

GA4 vult ook zelf een reeks gebruikersdimensies, zoals Country, Language en Device category. Die vooraf gedefinieerde dimensies dekken de gangbare gevallen. Aangepaste gebruikerseigenschappen zijn voor feiten die alleen jouw site kent, zoals of een bezoeker een gratis of betaald abonnement heeft.

Hoe verschillen gebruikerseigenschappen van eventparameters?

Gebruikerseigenschappen beschrijven de gebruiker en gaan mee naar toekomstige events, terwijl eventparameters één event beschrijven en daar stoppen. De pagina van Google over aangepaste dimensies trekt de grens in twee zinnen: eventparameters "provide more details about these actions, like which link was clicked," en "User properties tell you more about the users themselves."

PuntGebruikerseigenschapEventparameter
BeschrijftDe gebruikerEén actie
Geldt voorDat event en alle latere events van de gebruikerAlleen het event dat hem verstuurde
Bereik van de aangepaste dimensieGebruikerEvent
Aantalslimiet, standaardproperty25 gebruikerseigenschappen25 parameters per event
Lengte van de naam24 tekens40 tekens
Lengte van de waarde36 tekens100 tekens
Voorbeeldcustomer_tier = prolink_type = outbound

De limiet van 36 tekens voor waarden betekent korte categorielabels, geen vrije tekst. Twijfel je nog welke data een plek verdient, begin dan bij de beslissingen die het moet ondersteunen, zoals de gids over aangepaste analytics-implementatie uitlegt.

Hoe stel je gebruikerseigenschappen in met gtag?

Je stelt gebruikerseigenschappen in met de Google-tag door het commando set aan te roepen met een object user_properties, dat de waarden toepast op elk event op de pagina. De helppagina van Google geeft dit voorbeeld:

gtag('set', 'user_properties', {
  favorite_composer: 'Mahler',
  favorite_instrument: 'double bass',
  season_ticketholder: 'true',
});

Om de waarden tot één datastream te beperken, toont Google hetzelfde object in een config-commando: gtag('config', 'STREAM_ID', { 'user_properties': { ... } }). Voer de aanroep uit zodra je pagina de waarde kent, bijvoorbeeld direct na het inloggen.

De helppagina van Google noemt nog twee manieren om ze in te stellen:

  1. Google Tag Manager. Op een Google Analytics 4 Event-tag: "add a row in the User Properties section for each parameter you want to include."
  2. Firebase voor mobiele apps. Volg na het installeren van de Google Analytics for Firebase SDK de documentatie "Set user properties" van Firebase.

Servercode kan gebruikerseigenschappen via het Measurement Protocol versturen in een object user_properties, waarbij elke eigenschap een veld value bevat. De ontwikkelaarsgids van Google merkt op dat je gebruikerseigenschappen zonder events kunt versturen, en dat "Google Analytics uses the most recent value of a user property for each user."

Een analist aan een bureau die grafieken op een laptop bekijkt, als beeld van de stap waarin je een gebruikerseigenschap registreert zodat die in rapporten verschijnt.

Hoe rapporteer je over een gebruikerseigenschap in GA4?

Je rapporteert over een gebruikerseigenschap in GA4 door een aangepaste dimensie op gebruikersniveau aan te maken in Admin onder Data display, Custom definitions, met de rol Editor of hoger op de property. De procedure van Google:

  1. Klik in Admin onder Data display op Custom definitions.
  2. Open het tabblad Custom dimensions en klik op Create custom dimensions.
  3. Vul een naam voor de dimensie in. Koppeltekens zijn niet toegestaan, underscores en spaties wel.
  4. Zet Scope op User. Google zegt dat het bereik na het opslaan niet meer te wijzigen is.
  5. Vul de naam van de gebruikerseigenschap in, precies zoals je code die verstuurt. Ook dit veld ligt vast na het opslaan.
  6. Klik op Save.

De pagina's van Google spreken elkaar tegen over de volgorde. De pagina over het verzamelen van gebruikersdata zegt dat je de dimensie aanmaakt "Before you set user properties," terwijl de pagina over het aanmaken van de dimensie zegt dat je de eigenschap eerst aan je code toevoegt en controleert in de kaart "Users by User property" van het Realtime-rapport. Google zegt dat de dimensie na 24 tot 48 uur in rapporten verschijnt, dus registreer haar op de dag dat de eigenschap live gaat. Zodra ze bestaat, kun je haar gebruiken in vergelijkingen, filters, verkenningen en doelgroepvoorwaarden.

Van code naar rapport in vier stappen
1
Verstuur haar. Roep gtag('set', 'user_properties', {...}) aan zodra de pagina de waarde kent.
2
Controleer haar. Zoek de eigenschap in de kaart Users by User property van het Realtime-rapport.
3
Registreer haar. Maak in Admin een aangepaste dimensie op gebruikersniveau aan en vul de naam van de eigenschap precies zo in als je code die verstuurt.
4
Wacht. De dimensie verschijnt na 24 tot 48 uur in rapporten.
Registreer de dimensie op de dag dat de eigenschap live gaat, zodat de wachttijd vroeg begint.

Welke limieten gelden voor gebruikerseigenschappen in GA4?

Een standaard GA4-property accepteert 25 gebruikerseigenschappen en een Google Analytics 360-property 100, met namen tot 24 tekens en waarden tot 36 tekens. De pagina van Google over verzamellimieten stelt dat Analytics op een standaardproperty "doesn't process the 26th user property".

LimietStandaardproperty360-property
Gebruikerseigenschappen per property25100
Aangepaste dimensies op gebruikersniveau25100
Lengte van de naam van een gebruikerseigenschap24 tekensNiet vermeld op de pagina met 360-limieten
Lengte van de waarde van een gebruikerseigenschap36 tekensNiet vermeld op de pagina met 360-limieten

Voor namen gelden nog drie regels uit de ontwikkelaarsgids en helppagina's van Google:

  • Gereserveerde namen. first_open_time, first_visit_time, last_deep_link_referrer, user_id en first_open_after_install kun je niet gebruiken.
  • Gereserveerde voorvoegsels. Namen mogen niet beginnen met google_, ga_ of firebase_.
  • Hoofdlettergevoeligheid. Google waarschuwt dat "setting two user properties whose names differ only in case results in two distinct user properties being logged."

Een vierde valkuil zit in de aangepaste dimensie. Google zegt "any value in a custom dimension that resembles a number will be treated as a number, even if it was originally formatted as text." Een niveaucode als 94E40 verandert in wetenschappelijke notatie, dus zet een letter voor codes.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Welke gebruikerseigenschappen verzamelt GA4 automatisch?

GA4 verzamelt automatisch een reeks vooraf gedefinieerde gebruikersdimensies, en Google zegt dat je met gtag.js of de SDK "you don't need to write additional code to collect" ze. Op websites zijn dat onder meer Age, Gender, Interests, Language, Country, Region, City, Browser, Device category, Device brand, Operating system en Platform. Appstreams voegen App store, App version, Device model en New/Established toe.

Besteed niet een van je 25 plekken aan het kopiëren hiervan. De pagina van Google over aangepaste dimensies op gebruikersniveau zegt: "Don't create a custom user property if a predefined user dimension already exists."

Age, Gender en Interests hebben een addertje. Google zegt dat je "must meet the Analytics data thresholds to see demographic and interest data," en Google houdt die rijen achter als een groep klein genoeg is om mensen te identificeren. De pagina over datadrempels in GA4 legt uit wanneer dat gebeurt en wat het vermindert.

Wanneer begint een gebruikerseigenschap in GA4 te gelden?

Een gebruikerseigenschap in GA4 geldt vanaf het moment dat ze is ingesteld voor alle toekomstige events van die gebruiker, ook in latere sessies, en nooit voor eerdere events. De formulering van Google: "The user property will not apply to events that happened before the user property was set."

Leest een bezoeker vijf pagina's en krijgt hij pas bij het aanmelden customer_tier, dan dragen die vijf paginaweergaven geen niveau. Stel de eigenschap voor een ingelogde gebruiker bij elke paginalading in.

GA4 ontdubbelt ook. Google zegt dat Analytics een gebruikerseigenschap verzamelt als die "set for the first time on a page" is of als de waarde verandert, dus dezelfde set-aanroep herhalen op één pagina verstuurt geen extra data.

Een hangslot op een laptoptoetsenbord, als beeld van de regel dat gebruikerseigenschappen nooit persoonsgegevens mogen bevatten.

Mogen gebruikerseigenschappen in GA4 persoonsgegevens bevatten?

Gebruikerseigenschappen in GA4 mogen geen persoonlijk identificeerbare informatie bevatten, want het beleid van Google verbiedt het versturen daarvan. De helppagina van Google stelt dat de "policies mandate that no data be passed to Google that Google could use or recognize as personally identifiable information (PII)," en noemt "email addresses, personal mobile numbers, and social security numbers" als voorbeelden. De lijst met functies die extra zorg vragen, bevat "All custom dimensions," en dat dekt elke geregistreerde gebruikerseigenschap.

Houd waarden bij categorieën als pro, trial of admin. Voor een stabiele account-ID verwijst Google naar de User-ID-functie in plaats van een gebruikerseigenschap, en de pagina over aangepaste dimensies waarschuwt tegen "a custom dimension for a unique ID per user." Zelfs een ID die niemand bij naam noemt, kan onder privacywetgeving nog als persoonsgegeven tellen, zoals de gids over analytics-ID's en persoonsgegevens uitlegt.

Hoe koppelt Flowsery details aan een ingelogde gebruiker?

Flowsery koppelt details aan een ingelogde gebruiker met één identify()-aanroep, die de SDK-documentatie beschrijft als een manier om "Identify the current visitor with user details." Het gedocumenteerde voorbeeld geeft een gebruikers-ID, e-mailadres en naam mee: flowsery.identify({ userId: 'user_123', email: 'user@example.com', name: 'John Doe' }). De bezoekers-API van Flowsery geeft daarna de ID, naam en het e-mailadres van die gebruiker terug in een profielveld, dat voor anonieme bezoekers null is. Anoniem verkeer werkt anders. Met de optie "Cookieless" draait Flowsery met een bezoekershash die dagelijks wisselt en slaat het geen persoonsgegevens op, dus het koppelt een anonieme bezoeker niet over dagen of apparaten heen. Aangepaste events accepteren optionele metadata: de scripttag legt er een vast met window.flowsery("signup") en de npm-SDK met flowsery.trackEvent('signup'), als onderdeel van de doel- en eventtracking van Flowsery. Events verschijnen in de realtime eventfeed van Flowsery zodra ze vuren, zonder registratiestap ertussen.

Veelgestelde vragen

Wat is het verschil tussen een gebruikerseigenschap en een aangepaste dimensie op gebruikersniveau?

Een gebruikerseigenschap is de waarde die je code verstuurt, zoals customer_tier. Een aangepaste dimensie op gebruikersniveau is de registratie in GA4 Admin die die eigenschap zichtbaar maakt in rapporten. Je hebt beide nodig, en Google zegt dat de dimensie 24 tot 48 uur na het aanmaken in rapporten verschijnt.

Hoeveel gebruikerseigenschappen kan een GA4-property hebben?

Een standaardproperty kan 25 gebruikerseigenschappen hebben en een Google Analytics 360-property 100. Analytics verwerkt de 26e gebruikerseigenschap op een standaardproperty niet. Aangepaste dimensies op gebruikersniveau volgen dezelfde limieten van 25 en 100.

Gelden gebruikerseigenschappen in GA4 voor eerdere events?

Nee. Google zegt dat een gebruikerseigenschap geldt voor alle toekomstige events van die gebruiker, ook in latere sessies, maar "will not apply to events that happened before the user property was set." Stel de eigenschap in zodra je de waarde kent.

Hoe wijzig ik een gebruikerseigenschap in GA4?

Verstuur de eigenschap opnieuw met de nieuwe waarde. De ontwikkelaarsgids van Google zegt dat Analytics "uses the most recent value of a user property for each user," en GA4 verzamelt de eigenschap opnieuw telkens als de waarde verandert. Eerdere events houden de waarde die ze bij het versturen hadden.

Kan ik user_id gebruiken als naam voor een gebruikerseigenschap?

Nee. user_id is een van vijf gereserveerde namen, samen met first_open_time, first_visit_time, last_deep_link_referrer en first_open_after_install. Namen mogen ook niet beginnen met google_, ga_ of firebase_. Gebruik de User-ID-functie voor account-ID's.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Waar controleer ik of een gebruikerseigenschap binnenkomt?

Open het Realtime-rapport en kijk naar de kaart "Users by User property". Google zegt dat de kaart "shows the number of people who are grouped into each user property." Controleer de eigenschap daar voordat je er rapporten op bouwt.

Kan ik gebruikerseigenschappen in GA4 instellen in Google Tag Manager?

Ja. Voeg op een Google Analytics 4 Event-tag in het gedeelte User Properties een rij toe voor elke eigenschap die je wilt versturen. Registreer daarna elk ervan als aangepaste dimensie op gebruikersniveau, anders verschijnt ze niet in rapporten.

Waarom ontbreekt mijn gebruikerseigenschap in GA4-rapporten?

Een gebruikerseigenschap blijft buiten rapporten totdat de aangepaste dimensie bestaat en klaar is met verwerken. Google zegt dat de dimensie 24 tot 48 uur na het aanmaken in rapporten verschijnt. Controleer of het bereik User is en of de naam van de eigenschap precies overeenkomt met wat je code verstuurt, want beide liggen vast na het opslaan.

Mag een gebruikerseigenschap in GA4 een e-mailadres bevatten?

Nee. Het beleid van Google verbiedt het versturen van data die het als persoonlijk identificeerbare informatie zou kunnen herkennen, en e-mailadressen worden als voorbeeld genoemd. Houd waarden bij korte categorieën als pro, trial of admin.

Moet ik een gebruikerseigenschap maken voor Country of Language?

Nee. GA4 verzamelt al vooraf gedefinieerde gebruikersdimensies zoals Country, Language en Device category, en Google zegt dat je geen aangepaste moet maken als een vooraf gedefinieerde gebruikersdimensie de data al dekt. Bewaar je 25 plekken voor feiten die alleen jouw site kent.

Was dit artikel nuttig?

Laat ons weten wat je ervan vindt!

Zie ons vaker in Google

Met één klik markeer je Flowsery als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.

Voordat je gaat...

Flowsery

Flowsery

Analytics voor je website, met omzet voorop

Volg elke bezoeker, bron en conversie in realtime. Eenvoudig, krachtig en zonder cookies.

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Gerelateerde begrippen

Wat aangepaste dimensies in GA4 doen, en de quota die ze begrenzenWat aangepaste dimensies in GA4 doen, en de quota die ze begrenzen
Woordenlijst

Wat aangepaste dimensies in GA4 doen, en de quota die ze begrenzen

Door aangepaste dimensies in GA4 te registreren worden je eventparameters rapportvelden. Bekijk de drie bereiken, de quota van 50, 25 en 10 en de valkuil van kardinaliteit.

•8 min leestijd
Waarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage isWaarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage is
Woordenlijst

Waarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage is

Je GA4-bouncepercentage is het aandeel sessies zonder engagement. Hoe Google het definieert, hoe het verschilt van Universal Analytics en waar je het toevoegt.

•7 min leestijd
Wat het rapport over landingspagina's in GA4 telt en waar het leeg blijftWat het rapport over landingspagina's in GA4 telt en waar het leeg blijft
Woordenlijst

Wat het rapport over landingspagina's in GA4 telt en waar het leeg blijft

Het rapport over landingspagina's in GA4 toont de eerste pagina van elke sessie. Waar je het vindt, de standaardstatistieken, waarom (not set)-rijen verschijnen en hoe je de bron toevoegt.

•8 min leestijd
Hoe het bijhouden van zoekopdrachten op je site in GA4 vastlegt wat bezoekers typenHoe het bijhouden van zoekopdrachten op je site in GA4 vastlegt wat bezoekers typen
Woordenlijst

Hoe het bijhouden van zoekopdrachten op je site in GA4 vastlegt wat bezoekers typen

Stel zoekopdrachten op je site in GA4 in met enhanced measurement, voeg je eigen queryparameters toe, vind de dimensie Search term en volg zoekopdrachten zonder URL.

•8 min leestijd
Zo koppel je Search Console aan GA4 en publiceer je de rapportenZo koppel je Search Console aan GA4 en publiceer je de rapporten
Woordenlijst

Zo koppel je Search Console aan GA4 en publiceer je de rapporten

Zo koppel je Search Console aan GA4 via Beheer, welke rollen je nodig hebt, hoe je de twee rapporten in de Bibliotheek publiceert en wat de data niet kan combineren.

•7 min leestijd
Zo bouw je berekende statistieken in GA4 binnen een quotum van vijf plekkenZo bouw je berekende statistieken in GA4 binnen een quotum van vijf plekken
Woordenlijst

Zo bouw je berekende statistieken in GA4 binnen een quotum van vijf plekken

Google beperkt berekende statistieken in GA4 tot 5 per standaardproperty. Leer de formulesyntaxis, de eenheden, waar ze verschijnen en wat een formule niet mag gebruiken.

•8 min leestijd

Gerelateerde artikelen