Wat dimensies in
GA4 zijn, welke je moet gebruiken, hun API-namen, de limieten per property en hoe je stap voor stap een eigen dimensie maakt.

Op deze pagina
Kort samengevat
Een dimensie in Google Analytics is een tekstkenmerk dat je gegevens beschrijft, zoals het land van een bezoeker, het apparaat dat hij gebruikte of de pagina waarop de sessie begon. Dimensies geven context aan metrics zoals sessies of conversies. Begin met de ingebouwde dimensies en maak alleen een aangepaste dimensie als die lijst je vraag niet kan beantwoorden, binnen de limieten van je property (50 met gebeurtenisbereik en 25 met gebruikersbereik in een standaardproperty).
Wil je verder gaan? Vraag het aan
Korte quiz
Welke manier om je marketing te meten past bij jou?
Sorank past bij je antwoorden
Test het 3 dagen op je eigen website en zie waar je staat in Google, ChatGPT en de andere AI's.
3 dagen gratis testen3 dagen gratis, daarna stop je wanneer je wilt. 90 dagen geld-terug-garantie, onder voorwaarden.
Elk getal in een GA4-rapport heeft een label. Het getal is een metric. Het label is een dimensie. «412 sessies» is een metric. «412 sessies uit Duitsland op mobiel» voegt twee dimensies toe, land en apparaatcategorie, die laten zien welke bezoekers dat getal hebben opgeleverd.
De referentie van de Google Analytics-Help maakt hetzelfde onderscheid. Dimensies zijn beschrijvende kenmerken, dus tekst of categorieën. Metrics zijn hoeveelheden. Gemiddelden, percentages en verhoudingen tellen als metrics, ook als ze uit andere metrics worden berekend. Je kunt sessies over rijen heen optellen. Landen kun je niet optellen. Die groepeer je.
Daarom kan dezelfde metric iets anders betekenen. Een betrokkenheidspercentage van 60% op een landingspagina leest heel anders als je weet dat de bezoekers uit je nieuwsbrief kwamen en niet uit een betaalde campagne. De dimensie vertelt wie er kwam. De metric vertelt hoeveel van hen iets deden.
Als GA4 nieuw voor je is, lees dan eerst ons glossarium-item over GA4 en kom daarna terug. Deze gids gaat ervan uit dat er al gegevens in een GA4-property binnenkomen.
Dimensie of metric?
Oudere gidsen beschrijven «aangepaste dimensie index 1» en bereiken op hitniveau. Die wereld is voorbij. Google is gestopt met het verwerken van nieuwe hits voor standaard Universal Analytics-properties op 1 juli 2023. De 360-properties met een lopend contract kregen extra verwerkingstijd tot 1 juli 2024. Als je team nog in indexnummers praat, laat die gewoonte dan los. In GA4 geef je elke aangepaste dimensie een naam en koppel je die aan een parameter die je site of app verstuurt.
Einddata van Universal Analytics
Bron: Google Analytics-Help, «Google Analytics 4 heeft Universal Analytics vervangen»
De Google-Helppagina over dimensies en metrics groepeert de ingebouwde dimensies in 16 categorieën: Attributie, Demografie, E-commerce, Gebeurtenis, Gaming, Algemeen, Geografie, Link, Pagina / scherm, Platform / apparaat, Uitgever, Tijd, Verkeersbron, Gebruiker, Levensduur van gebruiker en Video. Dezelfde pagina noemt ook 11 metriccategorieën, zoals Sessie, Omzet en Advertenties. Houd de twee lijsten uit elkaar bij het zoeken, want een metriccategorie helpt je niet om op land te filteren.

Je hoeft de lijst niet uit het hoofd te kennen. Je moet weten welke categorie het antwoord op je vraag bevat. Vier categorieën dekken het grootste deel van het werk op een contentsite:
Daarna volgen de dimensies Gebeurtenis en Gebruiker. Gebeurtenisdimensies beschrijven een actie, zoals een klik op een knop of het afspelen van een video. Gebruikersdimensies beschrijven de bezoeker over meerdere sessies heen, zoals de bron die hem voor het eerst naar je site bracht. Als je deze indeling kent, weet je of een vraag bij een sessie, een gebeurtenis of een gebruiker hoort. Die niveaus door elkaar halen is een van de meest voorkomende redenen waarom een rapport fout lijkt, en we komen erop terug in het deel over fouten.

Elke dimensie heeft twee namen. De UI-naam is wat je in een rapport ziet. De API-naam is wat je naar de Google Analytics Data API stuurt, en die heb je nodig voor exports, scripts en dashboards. Google documenteert de API-namen in zijn Data API-schema. De tabel hieronder bevat de dimensies die de meeste contentsites gebruiken.
| UI-naam | API-naam | Beantwoordt de vraag |
|---|---|---|
| Sessiebron | sessionSource | Welke site of welk platform de sessie startte |
| Sessiemedium | sessionMedium | Welk type verkeer het was, zoals organic, referral of cpc |
| Standaard kanaalgroep van de sessie | sessionDefaultChannelGroup | Tot welke kanaalgroep de sessie behoort |
| Landingspagina | landingPage | De eerste pagina van de sessie |
| Paginapad | pagePath | Het padgedeelte van elke pagina die de bezoeker opende |
| Land | country | Waar de activiteit van de gebruiker vandaan kwam |
| Apparaatcategorie | deviceCategory | Desktop, tablet of mobiel |
| Gebeurtenisnaam | eventName | Welke gebeurtenis is vastgelegd |
| Datum | date | De datum van de gebeurtenis, in het formaat JJJJMMDD |

Drie regels helpen als je tussen de interface en de API schakelt. Ten eerste: API-namen zijn hoofdlettergevoelig, dus sessionSource is niet SessionSource. Ten tweede: elke extra dimensie splitst elke rij in meer rijen, wat het resultaat moeilijker leesbaar maakt, dus begin met twee of drie. Ten derde: een verzoek dat een dimensie noemt die je property niet kent, mislukt. Dat laatste punt is het belangrijkst voor aangepaste dimensies.
Aangepaste dimensies volgen een ander patroon. Het schema van Google verwijst ernaar via bereik en parameternaam. Een dimensie met gebeurtenisbereik schrijf je als customEvent: gevolgd door de parameternaam. Een dimensie met gebruikersbereik schrijf je als customUser: gevolgd door de parameternaam. Het onderstaande voorbeeld vraagt om de sessiebron en een aangepaste dimensie met gebeurtenisbereik met de naam author_name, over de laatste 28 dagen. Vervang de namen door de jouwe.
{
"dimensions": [
{ "name": "sessionSource" },
{ "name": "customEvent:author_name" }
],
"metrics": [{ "name": "sessions" }],
"dateRanges": [{ "startDate": "28daysAgo", "endDate": "yesterday" }]
}
Dit verzoek werkt alleen als je property author_name heeft geregistreerd als aangepaste dimensie met gebeurtenisbereik. Anders mislukt het. Registreer eerst en vraag daarna op.
Opmerking
Dimensies die vóór oktober 2020 zijn geregistreerd, gebruiken een langere vorm die de gebeurtenisnaam tussen vierkante haken bevat, zoals customEvent:parameter_name[event_name]. Als een query die vorig jaar werkte nu mislukt, controleer dan of de dimensie een van deze oude is.
Een primaire dimensie is de dimensie waarop een rapport is gegroepeerd. Elke rij is een waarde van die dimensie. Een secundaire dimensie voegt binnen elke rij een tweede uitsplitsing toe. Het idee is eenvoudig, maar hier haken de meeste mensen af, omdat dezelfde gegevens een andere vraag beantwoorden afhankelijk van welke dimensie eerst komt.
| Vraag | Primaire dimensie | Secundaire dimensie | Wat je te weten komt |
|---|---|---|---|
| Welke pagina's krijgen organisch bezoek? | Landingspagina | Sessiebron / -medium | Of zoeken de belangrijkste bron is voor elke pagina, of dat de pagina van andere kanalen afhangt |
| Gebruiken bezoekers uit een markt vooral hun telefoon? | Land | Apparaatcategorie | Het mobiele aandeel per land, wat aangeeft waar je lay-outs het eerst moet testen |
| Welke campagnes landen op welke pagina's? | Sessiecampagne | Landingspagina | Campagnes die naar pagina's leiden die niet bij hun aanbod passen |
| Welke browsers gebruiken bezoekers uit één land? | Browser | Land | Compatibiliteitsproblemen die alleen in één markt optreden |
In een Verkenningen-tabel kun je meer dan twee dimensies stapelen, maar de leesbaarheid daalt snel. Houd het in één weergave op twee of drie en zet de rest in filters. Een filter verwijdert rijen, en een dimensie splitst ze op. Gebruik filters om de vraag te beperken en dimensies om het antwoord te verklaren.
Neem de eerste rij van de tabel hierboven. Als de landingspagina de primaire dimensie is en de sessiebron de secundaire, dan is elke rij een pagina met het verkeer uitgesplitst per bron. Draai je ze om, dan is elke rij een bron met de pagina's eronder. De cijfers zijn identiek. De vraag is anders. Bepaal welke je nodig hebt voordat je het rapport opent, en schrijf het in één zin op.
Standaarddimensies dekken de meeste rapportage. Je hebt een aangepaste dimensie nodig als de informatie in je eigen systeem zit, of in een parameter die je zelf verstuurt. Typische gevallen zijn de naam van de auteur op een blog, het abonnementstype in een SaaS-app, een contentcategorie, of of de bezoeker was ingelogd. Stel jezelf één vraag voordat je iets aanmaakt: kan de ingebouwde lijst dit beantwoorden? Zo ja, stop dan.
Het bereik bepaalt wat de aangepaste dimensie beschrijft. Een dimensie met gebeurtenisbereik hoort bij één gebeurtenis, zoals een klik of een paginaweergave die een parameter draagt. Een dimensie met gebruikersbereik hoort bij een bezoeker en behoudt dezelfde waarde over zijn sessies heen, zoals een abonnementsniveau. Een dimensie met itembereik hoort bij één item binnen een e-commercegebeurtenis, zoals de kleur van een product.
| Bereik | Hoort bij | Typisch gebruik | Standaardproperty | 360-property |
|---|---|---|---|---|
| Gebeurtenis | Eén gebeurtenis | Auteur van het gelezen artikel | 50 | 125 |
| Gebruiker | Eén bezoeker | Abonnementsniveau, inlogstatus | 25 | 100 |
| Item | Eén item in een e-commercegebeurtenis | Merk of kleur van het product | 10 | 25 |
Limieten voor aangepaste dimensies op een standaardproperty
Bron: Google Analytics-Help, overzicht van aangepaste dimensies en metrics
De limieten gelden per property en tellen elke geregistreerde dimensie mee. De pagina Aangepaste definities in Beheer toont je gebruik. Open de link Quotuminformatie rechtsboven om te zien hoeveel plekken je nog hebt. Houd die pagina open wanneer je een wijziging in de tracking plant.
Als je de limiet bereikt, is een plek vrijmaken niet meteen mogelijk. De Google-Helppagina over limieten voor aangepaste dimensies zegt dat je 48 uur moet wachten na het verwijderen van dimensies voordat je nieuwe kunt toevoegen. Plan je namen voordat je begint, en maak geen dimensie aan voor een eenmalige test die je de week erna weer verwijdert.

Waarschuwing
Stuur nooit persoonsgegevens als dimensiewaarde. Namen, e-mailadressen en telefoonnummers zijn identificeerbare persoonsgegevens, en de regels van Google verbieden om ze naar Analytics te sturen. De naam van een auteur is geen probleem. Het e-mailadres van een klant wel, ook als het in je code is gehasht.
Deze stappen gaan ervan uit dat je site of app de parameter al verstuurt. Als er geen gegevens binnenkomen, wordt de dimensie aangemaakt maar toont die niets. Werk de lijst in volgorde af.
Een aangepaste dimensie in vijf stappen aanmaken
Bron: Google Analytics-Help, «[GA4] Over aangepaste dimensies en metrics»
Open DebugView en activeer de gebeurtenis op je site of in je app. Kijk naar de gebeurtenis en de parameters. Controleer of de waarde de verwachte is, bijvoorbeeld «Jane Doe» voor een auteur en niet «undefined». Pas dan maak je de dimensie aan. Een parameter die de verkeerde waarde verstuurt, vult je rapporten vanaf die dag met verkeerde gegevens, en de eerdere dagen kun je niet meer corrigeren.
De parameternaam in de interface moet overeenkomen met de naam die je code verstuurt. Eén letter verschil, een hoofdletter of een spatie maakt een dimensie die nooit gevuld wordt. Kopieer de naam uit je code in plaats van hem uit je hoofd te typen. Gebruik kleine letters en underscores, zoals in author_name, want je plakt dezelfde string later in API-verzoeken.
Opmerking
De Google-Helppagina over aangepaste dimensies in GA4 zegt dat de rapportage 24 tot 48 uur na het aanmaken van een dimensie begint. Maak een dimensie niet aan op de middag van de lancering van een campagne en verwacht dan dezelfde dag gegevens. Maak hem enkele dagen eerder aan en controleer hem daarna.
Zodra de dimensies bestaan, kun je ze op vier plekken lezen. Elke plek past bij een andere taak. De verkeerde tool kost tijd, dus vergelijk ze voordat je iets bouwt.
| Methode | Het best geschikt voor | Belangrijkste beperking | Voorbeeld |
|---|---|---|---|
| Standaardrapporten | Snelle controles op verkeer, pagina's en gebeurtenissen | Vaste lay-outs met één primaire en één secundaire dimensie | Verkeersacquisitie per sessiebron |
| Verkenningen | Aangepaste tabellen, funnels en padanalyse | Vraagt instelwerk, en grote tabellen worden traag | Landingspagina per sessiebron en apparaatcategorie |
| Data API | Exports, scripts en je eigen dashboards | Vraagt code, en elke dimensie moet geregistreerd zijn | Wekelijkse export van sessies per pagina naar een spreadsheet |
| Looker Studio | Gedeelde rapporten voor klanten of managers | Hangt af van de connector en het vernieuwingsschema | Maandelijks klantdashboard met verkeer per kanaal |
Standaardrapporten beantwoorden de eerste vraag die je elke ochtend hebt. Gebruik ze om een daling op te merken en ga daarna over op een flexibeler hulpmiddel om de oorzaak te vinden. Hun voordeel is snelheid. Hun zwakte is dat je niet elk willekeurig dimensiepaar kunt kiezen, dus een vraag die drie dimensies nodig heeft, past niet in een standaardrapport.
Met Verkenningen bouw je een tabel met de dimensies en metrics die je kiest, en sla je hem op voor later. Dit is het hulpmiddel voor analyse van landingspagina's, om kanalen binnen één land te vergelijken en om te controleren of een aangepaste dimensie echt gevuld wordt. Houd elke verkenning bij één vraag. Een tabel die vijf vragen beantwoordt, beantwoordt meestal geen enkele duidelijk.
Tip
Schone dimensies beginnen met schone campagnelinks. De waarden voor bron en medium komen uit je UTM-parameters, dus een schrijfverschil als «Newsletter» en «newsletter» maakt een tweede rij voor hetzelfde kanaal. Bouw je links met onze gratis UTM-linkbouwer, zodat de namen consistent blijven.
Gebruik de API wanneer een rapport elke week draait, wanneer je een dashboard voedt, of wanneer je de uitvoer van twee properties in een script wilt vergelijken. Het verzoekpatroon dat eerder in deze gids staat, is het bouwblok. Zodra het in een test werkt, zet je dezelfde JSON in je script en houd je de dimensienamen op één plek, zodat een hernoeming niet tien query's tegelijk breekt.
Looker Studio is de gebruikelijke keuze als iemand anders de cijfers moet lezen. Het koppelt aan GA4 en toont de dimensies in grafieken en tabellen. De beperkingen komen van de connector en het vernieuwingsschema, niet van GA4 zelf. Als je een klantdashboard bouwt, behandelt onze gids over Looker Studio voor SEO de formules en limieten die voor zoekgegevens belangrijk zijn, en onze gids over een GA4-dashboard beschrijft wat op het eerste scherm hoort.
AI-assistenten sturen bezoekers die via een link binnenkomen, en die link draagt een verwijzingsbron. Je ziet dat in de dimensie sessiebron en op de landingspagina. Sommige AI-apps geven helemaal geen referrer door, dus deze methode vangt maar een deel van het beeld. Ons glossariumitem over AI-dark-traffic legt uit wat ontbreekt en waarom. Voor organisch zoeken in hetzelfde rapport laat onze gids over Google Analytics voor SEO zien hoe je het van de rest scheidt.
AI-bezoeken isoleren in vier stappen
Lees het resultaat zorgvuldig. Een stijging van AI-sessies op één pagina laat zien dat de pagina wordt gebruikt, maar zegt niet of bezoekers iets hebben gekocht. Voeg een conversiemetric toe aan de tabel voordat je besluit dat een pagina werkt. Het artikel over het meten van AI-citaten met Google Analytics loopt de conversiekant stap voor stap door.
Tip
Als je Google- en AI-verkeer op één scherm wilt zien zonder zelf de verkenning te bouwen, toont het GEO / SEO-dashboard van Sorank beide. Het combineert gegevens uit Google Search Console (klikken, vertoningen, CTR, positie) met de paginaweergaven die AI-assistenten versturen, zoals die in Google Analytics worden vastgelegd.
De meeste problemen met dimensies zie je als een lege kolom, een kolom met «(not set)»-waarden, of een rapport dat juist lijkt maar de verkeerde vraag beantwoordt. De tabel geeft aan waar je op moet letten. De onderstaande secties leggen elke fout uit.
| Fout | Hoe je hem herkent | Oplossing |
|---|---|---|
| Een dimensie aanmaken voordat de gegevens binnenkomen | Elke rij toont «(not set)» | Bevestig de waarde eerst in DebugView, maak daarna de dimensie aan |
| Naamverschil tussen code en interface | Geen gegevens 48 uur later | Kopieer de parameternaam uit de code |
| Een ingebouwde dimensie dupliceren | Twee dimensies geven dezelfde rijen | Bekijk eerst de standaardlijst en verwijder dan het duplicaat |
| Waarden met hoge cardinaliteit | Duizenden rijen, elk met één sessie | Stuur categorieën en bewaar unieke ID's in je eigen systeem |
| Persoonsgegevens in een waarde | Waarden die op e-mailadressen of volledige namen lijken | Verwijder de parameter en stuur in plaats daarvan een categorie |
| Geschiedenis verwachten | Oude datums zijn leeg, nieuwe zijn gevuld | Vergelijk alleen vanaf de aanmaakdatum en noteer de leemte |
De fout: je maakt de dimensie aan en ontdekt daarna dat de parameter GA4 nooit heeft bereikt. Je herkent het doordat elke rij in het rapport «(not set)» toont. De oplossing is de volgorde omdraaien. Bevestig de waarde in DebugView, registreer daarna de dimensie en wacht de 24 tot 48 uur af die Google noemt voordat je het rapport beoordeelt.
De fout: de code verstuurt author_name, maar de interface bevat Author_name of author name. De dimensie bestaat en blijft leeg. Het signaal: een keurige aangepaste definitie zonder gegevens na twee dagen. De oplossing: open de code, kopieer de exacte string en controleer hem opnieuw in DebugView. Later corrigeren herstelt de verloren dagen niet, dus repareer het op de dag dat je het vindt.
De fout: je maakt een aangepaste dimensie aan met de naam Country, omdat je de standaardlijst niet hebt gecontroleerd. Je ziet het aan twee rijen met dezelfde waarden. De kosten zijn het quotum. Elk duplicaat gebruikt een van je 50 plekken met gebeurtenisbereik, of een van je 25 plekken met gebruikersbereik, en juist die plekken heb je later nodig voor dingen die GA4 je niet kan geven. Bekijk eerst de standaardlijst in de rapporten en beslis dan.
De fout: je verstuurt een dimensie met een waarde die uniek is per bezoeker of per bestelling, zoals een gebruikers-ID, een volledige URL met queryreeks of een bestelnummer. Google raadt aan om dimensies met hoge cardinaliteit in standaardproperties te vermijden. Het signaal: een tabel met duizenden rijen, elk met één sessie. De oplossing is een categorie versturen. Stuur het abonnementstype, niet de gebruikers-ID. Stuur het contenttype, niet de volledige URL. Bewaar de unieke identificatie in je CRM, waar je die zelf aan de gegevens kunt koppelen.
De fout: een dimensie bevat een e-mailadres, een naam of een telefoonnummer, vaak omdat een handige variabele werd gebruikt. Het signaal: een waarde die op een persoon lijkt. De oplossing is de parameter verwijderen en een categorie of een anonieme interne code versturen. Overleg met je functionaris voor gegevensbescherming als je twijfelt. Een e-mailadres hashen maakt het niet veilig om te versturen.
De fout: je maakt in mei een dimensie aan en verwacht dat die de sessies van januari verklaart. Rapporten tonen alleen waarden die zijn verzameld nadat de dimensie gegevens begon te ontvangen. Het signaal: een lege kolom voor de eerdere datums. De oplossing: vermeld de startdatum in de rapporttitel en vergelijk alleen vanaf die datum. Laat geen voor-en-na-grafiek zien die midden in een leemte begint.
Een dimensie is een tekstkenmerk, zoals land, apparaat of paginapad. Een metric is een getal, zoals sessies, actieve gebruikers of conversies. Dimensies groeperen en labelen de getallen, dus dezelfde metric leest anders afhankelijk van de dimensies waarmee je hem combineert.
Een standaardproperty staat 50 aangepaste dimensies met gebeurtenisbereik toe, 25 met gebruikersbereik en 10 met itembereik. Een 360-property staat er 125, 100 en 25 toe. De pagina Aangepaste definities in Beheer toont hoeveel je er hebt gebruikt. Eén verwijderen maakt de plek niet meteen vrij, omdat je 48 uur moet wachten voordat je een nieuwe kunt toevoegen.
Meestal bereikt de parameter GA4 niet, of komt de naam niet exact overeen. Controleer DebugView, corrigeer de naam in de interface of in je code, en wacht 24 tot 48 uur na het aanmaken. Als de gegevens dan nog steeds niet verschijnen, wordt de parameter waarschijnlijk niet verstuurd.
Je checklist voor deze week
Begin met een vraag die je vandaag niet kunt beantwoorden. Bouw er een dimensie voor, controleer de gegevens, en voeg pas daarna de volgende toe.
Een dimensie is een tekstkenmerk, zoals land, apparaat of paginapad. Een metric is een getal, zoals sessies, actieve gebruikers of conversies. Dimensies groeperen en labelen de getallen.
Een standaardproperty staat 50 dimensies met gebeurtenisbereik toe, 25 met gebruikersbereik en 10 met itembereik. Een 360-property staat er 125, 100 en 25 toe. De pagina Aangepaste definities in Beheer toont je gebruik.
Meestal bereikt de parameter GA4 niet, of komt de naam niet exact overeen. Controleer DebugView, corrigeer de naam en wacht 24 tot 48 uur na het aanmaken voordat je het rapport beoordeelt.
