Filters
Filter out events in your Connections
Overview
Converge allows you to filter out events based on Event Properties or by their Source.
Event Property Filters
Converge allows you to filter out events granularly based on their event properties according to the Converge Event Spec.
A Converge property filter only forwards events if a condition is True. As such, a connection with the following filter only forwards Placed Order
events if the property is not equal to subscription_contract
.
Event Property Filters are currently only supported for server-side forwarded events. Client-side forwarded events will not be filtered out.
How to set up an Event Property Filter
- Navigate to the Connections Tab in your Converge dashboard
- Click on the Connection for which you want to filter out certain events.
- Click on the Configuration tab and on the Filters-subtab to open the Filter Configuration
- Click on Edit configuration to add a Filter.
- Click on Add condition and choose the Event for which you want to set up a filtering rule.
- Click on Select Property and choose the property on which you want to filter.
- Once you are happy with your rule, click Save.
Examples
Filtering out subscription orders from a Connection
Subscription brands typically want to filter out recurring purchases when forwarding to ad platforms. To achieve this, you can set up a Filter on the Placed Order
event on a per-connection basis.
Find a property and property value that defines a recurring subscription order
-
Navigate to the Source Log and filter on the
Placed Order
event. -
Check a few
Placed Order
events by clicking on them to see all of their properties, find a property and property value that uniquely define a subscription purchase.If you are using the Shopify Server Integration in a standard setup, then the following property and property value pair defines a recurring purchase:
source_name
→subscription_contract
Set up your filter accordingly
- Set up a filter for the
Placed Order
event as follows. Replace the property and property value with the ones you identified in Step 2.
Source Filters
Converge allows you to filter out all events of a specific source with a single filter. This is especially helpful when you have multiple sales channels, such as multiple storefronts.
How to set up a Source Filter
- Navigate to the Connections Tab in your Converge dashboard
- Click on the Connection for which you want to filter out certain sources.
- Click on the Configuration tab and on the Sources-subtab to open the Source Filter Configuration
- Click on Edit configuration to modify the configuration.
- Choose the Sources for which you want to send events.
- Once you are happy with your selection, click Save.
Multi-store or multi-website setups
A typical example of source filters is when you are setting up multiple stores. You might want to set up different Google Ads Connections for each store for example. You can use Source Filters to filter out the appropriate Sources per Connection.
As an example, if you have a US and CA store, and you are creating a Google Ads Connection for the CA Store — you will want to configure your Canadian Sources to be the only ones streaming into this Connection.