Using Custom Collections
Arun Sivashankaran avatar
Written by Arun Sivashankaran
Updated over a week ago

In addition to integrated collections (external platforms with user data), FunnelEnvy supports the use of custom collections, most commonly used for behavioral targeting. Custom collects are arbitrary named collections and values that can be sent from the client and are associated with the current visitor, and can be used to define audiences in the condition builder.

Common uses of custom collections are to track if a user visits a specific page, clicks on a link or submits a form. Since arbitrary values can sent with custom collections however they give you a lot of flexibility to associate arbitrary data with a visitor.

Sending data to a custom collection requires some knowledge of Javascript, and can be done directly on the page or through a Tag Management System such as Google Tag Manager. When you send the custom collection you will be required to specify:

  • Collection Name - The grouping of attributes for this custom collection. This value will be populated under the collections drowdown in the Audience condition builder under 'Your Custom Collections'

  • Attribute Name - The name of the attribute you are setting in the collection. This will appear in the second dropdown of the condition builder (attributes) when the custom collection is selected.

  • Attribute Value - The value that you will match against in the condition builder.


Custom collections in the Audience Condition Builder

Custom collection / attributes can be sent with the following Javascript code:

  dataLayer.push({
    event: 'backstage.pushCollection',
    'backstage.customCollections': {
      'COLLECTION NAME': {
      	'ATTRIBUTE NAME': ATTRIBUTE VALUE
      }
    }
  }) 

Example

Lets say you had several different whitepapers that a user could select on your site. These might be identified by industry vertical. You could create a custom collection "Downloaded Content" with an attribute "Industry Whitepaper" and a value that identified the specific industry ("Telecom"). You would invoke the following Javascript code when the user visited the whitepaper:

  dataLayer.push({
    event: 'backstage.pushCollection',
    'backstage.customCollections': {
      'Downloaded Content': {
      	'Industry Whitepaper': 'Telecom'
      }
    }
  })
Did this answer your question?