The spend_virtual_currency event
spend_virtual_currency is the sink side of a GA4-tracked in-game economy. You fire it when a player spends soft currency, passing virtual_currency_name, value, and the item_name purchased. With earn_virtual_currency it closes the economy loop, showing where currency drains and which in-game items absorb it — key to balancing faucets against sinks.
What this means
spend_virtual_currency is a GA4 recommended gaming event. You fire it when a player spends in-game currency, passing virtual_currency_name, value (amount spent), and item_name (what was bought). It is the sink that balances the earn_virtual_currency faucet.
Like its counterpart, this is virtual currency — real-money transactions belong in the purchase event.
Balancing sinks and faucets
Comparing spend against earn per currency reveals economy health. The item_name breakdown shows which sinks players actually use; an item nobody spends on is a dead sink. Healthy economies keep faucets and sinks roughly in tension so currency stays meaningful.
- virtual_currency_name: which currency was spent
- value: amount spent; item_name: what it bought
- Sink side; pair with earn_virtual_currency
How it appears in analytics and logs
A spend_virtual_currency event means a player used in-game currency. Concentrated spending on one item shows what the economy actually values.
Diagnostic use case
Track where players spend in-game currency and on which items, to balance the economy against earning.
What WebmasterID can help detect
WebmasterID can record currency-spend events first-party so economy sinks are measurable without third-party identifiers.
Common mistakes
- Logging real-money spend here instead of in purchase.
- Omitting item_name, so sinks can't be compared.
- Mismatching virtual_currency_name with earn events.
Privacy and accuracy notes
Parameters describe the in-game transaction, not the person, and not real money. Keep PII out. Educational, not legal advice.
Related pages
- The earn_virtual_currency event
earn_virtual_currency is a GA4 recommended gaming event for in-game economies. You fire it when a player earns soft currency — coins, gems, points — passing virtual_currency_name and value. Paired with spend_virtual_currency, it lets you model the in-game economy: earning and spending balance, currency sinks and faucets, and how the economy relates to real-money purchases.
- The purchase event and e-commerce
The purchase event records a completed transaction and anchors all e-commerce reporting: revenue, items, and conversion value. It carries a transaction id, a value and currency, and an items array describing what was bought. The discipline is to record the order, not the customer — product and revenue data belong in the event, personal identity does not.
- The unlock_achievement event
unlock_achievement is a GA4 recommended gaming event you fire when a player earns an achievement, identified by an achievement_id. Achievements are engagement and goal-completion signals: which ones unlock often, which are rarely reached, and how unlocking relates to retention. It complements progression events by capturing discrete milestones rather than continuous leveling.
- Event Explorer
Analyze currency sinks by item.
Sources and verification notes
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.