Extending the Spec
Derived Events
Create new events from existing events
Overview
Converge lets you automatically create new events based on the properties of existing ones, without writing any code.Set up derived events
How to set up derived events
How to set up derived events
- Navigate to the Derived events page in your Converge dashboard.
- Click Create new derived event to start creating a new derived event.
- Fill in the Derived Event Name. This will be the name assigned to all new derived events matching your filter conditions.
- Under the filters, select a source event you want to trigger the creation of a derived event.
- Select the Condition property, Condition operation, and Condition value that the selected event’s properties must match to create the derived event.
- Repeat for each condition as needed by clicking Add condition.
- Click Save to persist the derived event.
Definitions
Derived event
A derived event is any event you want to create that’s triggered by an existing event’s properties matching your desired filters. For example, you may want to track aSubscription Purchase event when a Placed Order event comes in that has a field tag containing the text subscription.
Filters
Filters are used to define the conditions when a derived event should be created. They should include the name of the source event as well as conditions for each matching event property.The
New Customer Order derived event is created on setup for all users by default. It’s not editable. It’s created when there’s a Placed Order event with the field $is_new_customer set to True. The $is_new_customer field is automatically added by Converge server-side, so there’s no need for the client to attach this field.-
Condition variable: a variable to be compared. It can be any of the event’s available properties (e.g.
Product names,coupons, etc.). - Condition operator: a condition to be applied to the variable.
- Condition value: the value to be compared against the variable.
The filters only work on the event’s properties. Currently, it doesn’t allow filtering on attribution, profile properties, session properties, or sources.For example, if you want to create derived events matching a certain condition from a particular source, you can’t do this at the moment.