​
Overview

Converge allows you to filter out events based on Event Properties, Profile Properties or by their Source.

​
Property Filters

Converge allows you to filter out events granularly based on their event properties and profile properties according to the Converge Event Spec.

A Converge property filter only forwards events if a condition is True. As such, a destination with the following filter only forwards Placed Order events if the property is not equal to subscription_contract.

Property Filters are currently only supported for server-side forwarded events. Client-side forwarded events will not be filtered out.

Property filters apply to both event properties and profile properties. If the same property name exists in the event and profile properties, the filter will check both.

​
How to set up an Property Filter

  1. Navigate to the Destinations Tab in your Converge dashboard
  2. Click on the Destination for which you want to filter out certain events.
  3. Click on the Configuration tab and on the Filters-subtab to open the Filter Configuration
  4. Click on Edit configuration to add a Filter.
  5. Click on Add condition and choose the Event for which you want to set up a filtering rule.
  6. Click on Select Property and choose the property on which you want to filter.
  7. Once you are happy with your rule, click Save.

​
Examples

​
Filtering out subscription orders from a Destination

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-destination basis.

1

Find a property and property value that defines a recurring subscription order

  1. Navigate to the Source Log

    and filter on the Placed Order event.

  2. 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

2

Set up your filter accordingly

  1. 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

  1. Navigate to the Destinations Tab in your Converge dashboard
  2. Click on the Destination for which you want to filter out certain sources.
  3. Click on the Configuration tab and on the Sources-subtab to open the Source Filter Configuration
  4. Click on Edit configuration to modify the configuration.
  5. Choose the Sources for which you want to send events.
  6. 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 Destinations for each store for example. You can use Source Filters to filter out the appropriate Sources per Destination.

As an example, if you have a US and CA store, and you are creating a Google Ads Destination for the CA Store — you will want to configure your Canadian Sources to be the only ones streaming into this Destination.