Shahin

Event Merging

Intermediate
Updated Jul 11, 2026 Shahin editorial 2 min read
PronunciationEN/ɪˈvɛnt ˈmɜːrdʒɪŋ/

Event merging means gathering several event names that are really one action under a single canonical name, so their history and reporting are not fragmented.

Event merging solves a very common problem: because event grouping is based on exact string match, Purchase and purchase, add_to_cart and AddToCart count as separate events and one fact splits into several rows no view sums together. Merging brings these under a single name so the complete number is seen. The key distinction is that proper merging should happen at the report level, not by renaming in code; renaming in code is itself the source of this fragmentation. Merging is an after-the-fact correction, but the root solution is a clear naming convention from the start so duplicate events are never created. Without it, merging becomes a constant, wearying chore.