Language reference
Funnel Query Language is a language designed to perform queries on the chronological context of activity of a website visitor for the purpose of advanced Conversion Funnel Optimization.
A Javascript API enables to write a funnel data-set and provides several methods to query the data-set using Funnel Query Language.
Funnel Query Language converts to JSON before it is used to query the funnel data-set. The language is designed for easy usage by non-technical users. It is possible to use JSON instead of Funnel Query Language to save additional parsing time in a production environment.
Funnel Query Language provides the following methods for querying the registered funnel data-set.
Tag (JSON string)
URL (
URL)Path (
PATH)Tag Count (
COUNT)Date or time (
SINCE)Custom function (
FN)
A tag can be queried using a JSON string "tag-name" or using a Regular Expression method REGEX(/tag-name/i).
"tag-x" + REGEX(/tag-name-(\d+)?/i) + "tag-y"
An URL can be queried using the method URL("url") or using a Regular Expression URL( REGEX(/tag-name/i) ).
URL("url/to/match") + URL( REGEX(/url\.(html|js|css)/i) )
The PATH query enables to add chronological context to a query. The path method starts a sub query that can contain a tag, url, count or function query.
The path query provides operators to define the chronological context. The path sequence can be based on URL navigation position or time.
Option | Description |
| Matches in consecutive query should follow previous query's URL position. |
| Matches in consecutive query should match or follow previous query's URL position. |
| Matches in consecutive query should be on same URL position as previous query's URL position. |
| Matches in consecutive query should be at least 10 URL positions from previous query's URL position. |
| Matches in consecutive query should be at least 10 minutes from previous query's event position. |
| Matches in consecutive query should be within 10 minutes from previous query's event position. |
PATH( "tag-x" > "tag-y" )
The following example matches when tag-y follows within 1 minute after tag-x.
PATH( "tag-x" <1m "tag-y" )
The following example matches when the visitor visits an URL containing cart or other-page within 5 navigations after having visited product-1.html.
PATH( URL("product-1.html") <5 URL( REGEX(/(cart|other-page)/) ) )
The SINCE query enables to add chronological context to a query. The since method starts a sub query that can contain a tag, url, count or function query.
The first parameter of the SINCE method can contain a time reference, e.g. 1s (1 second) or 10m (10 minutes) or a date in format yyyy-MM-ddThh:mm.
SINCE( 1m, "tag-x" )
SINCE( 2018-09-02T12:10, ( "tag-x" + "tag-y" ) )
A COUNT query enables to query based on number of occurrences of a tag.
The first parameter of the COUNT method contains the tag as JSON string or as REGEX query. The query supports the operators >, <, =, <=, >= followed by a number.
COUNT( "tag-x" > 1 )
A FN query enables to perform a custom query using a javascript function. Optional conditions from a parent query are added as a extra argument.
FN( "function-name", "argument-1", "argument-2" )