Custom Event

A custom event is an event you define and send yourself for an action specific to your product, as opposed to the events the library already knows.

Creating one is a single call: you invoke the tracking function with a name and a set of properties, and that name appears in reports from its first arrival. It exists because default events cover generic web behaviour and know nothing about actions specific to your product, such as applying a discount code or finishing a course chapter. The main risk is naming drift: when each team invents its own name, two near-identical names like podcast_play and podcast_played become two unrelated series and no report shows the whole picture. Every custom event carries maintenance cost, so keep the list short and deliberate.