Virtual currency name dimension
Virtual currency name is the dimension that labels which in-game currency an event involved — Gold, Gems, Coins — sent via virtual_currency_name on GA4's earn_virtual_currency and spend_virtual_currency events. Games often run several parallel currencies, so this dimension is what keeps a soft-currency economy from being summed together with a premium one. The value is a free-text label you must keep consistent.
What this means
GA4's earn_virtual_currency and spend_virtual_currency events carry virtual_currency_name to identify which currency moved. The virtual currency name dimension surfaces it so multi-currency economies can be analysed one currency at a time.
With the accompanying value parameter, it supports sink-and-source balance analysis per currency.
Keep economies separate
Because many games run a free soft currency alongside a paid premium currency, combining them under one label or summing across labels yields figures that mean nothing. Assign each currency a stable, distinct name and analyse them independently.
Consistent labels across earn and spend events are essential, or balance calculations will not reconcile.
- Sent on earn_/spend_virtual_currency events
- Keeps parallel economies distinct
- Free text — labels must match across earn and spend
How it appears in analytics and logs
A virtual currency name value identifies one in-game currency. Mixing soft and premium currencies under one label produces meaningless combined economy numbers.
Diagnostic use case
Use virtual currency name to analyse each in-game economy separately, comparing earn and spend per currency rather than lumping them together.
What WebmasterID can help detect
WebmasterID can record earn/spend events tagged by currency first-party, so per-economy analysis works without third-party tracking.
Common mistakes
- Summing soft and premium currencies together.
- Using different labels on earn versus spend events.
- Treating the value parameter as comparable across currencies.
Privacy and accuracy notes
Virtual currency name records game economy context, not identity. WebmasterID treats currency labels as first-party product context, never personal data.
Related pages
- Level name dimension
Level name is the dimension that records which level a player started or finished, sent via the level_name parameter on GA4's recommended level_start and level_end gaming events. Paired with the success flag on level_end, it reveals where players progress or stall. As a free-text label, its analytical value depends on a consistent, stable naming scheme across builds.
- Character dimension
Character is the dimension that records which in-game character, class, or avatar a player used, sent via the character parameter on several GA4 gaming events such as level_up and post_score. It lets you segment progression, scoring, and economy behaviour by character choice — which characters players favour and which perform. As a free-text label it depends on consistent naming to stay analytically useful.
- Achievement ID dimension
Achievement ID is the dimension that holds the key of an achievement a player unlocked, sent via achievement_id on GA4's unlock_achievement event. It lets you measure which milestones players reach and how achievement completion relates to retention and monetisation. Because it is a key you assign, a stable, unique ID per achievement is what keeps the analysis coherent across releases.
- Event Explorer
Inspect virtual-currency events per economy.
Sources and verification notes
- GA4 developer docs — Recommended events (gaming)Documents earn/spend events and virtual_currency_name.
Last reviewed 2026-06-24. Facts are checked against primary/official sources where available; uncertain specifics are marked “Data not yet verified” rather than guessed.