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

  1. Navigate to the Connections Tab in your Converge dashboard
  2. Click on the Connection 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 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.

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_namesubscription_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 Connections Tab in your Converge dashboard
  2. Click on the Connection 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 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.