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)
Tag Query
A tag can be queried using a JSON string
"tag-name" or using a Regular Expression method REGEX(/tag-name/i).1
"tag-x" + REGEX(/tag-name-(\d+)?/i) + "tag-y"
Copied!
URL Query
An URL can be queried using the method
URL("url") or using a Regular Expression URL( REGEX(/tag-name/i) ).1
URL("url/to/match") + URL( REGEX(/url\.(html|js|css)/i) )
Copied!
Path Query
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.
Path Query Operators
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.
>10Matches in consecutive query should be at least 10 URL positions from previous query's URL position.
>10mMatches in consecutive query should be at least 10 minutes from previous query's event position.
<10mMatches in consecutive query should be within 10 minutes from previous query's event position.
1
PATH( "tag-x" > "tag-y" )
Copied!
The following example matches when
tag-y follows within 1 minute after tag-x.1
PATH( "tag-x" <1m "tag-y" )
Copied!
The following example matches when the visitor visits an URL containing
cart or other-page within 5 navigations after having visited product-1.html.1
PATH( URL("product-1.html") <5 URL( REGEX(/(cart|other-page)/) ) )
Copied!
Since Query
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.1
SINCE( 1m, "tag-x" )
Copied!
1
SINCE( 2018-09-02T12:10, ( "tag-x" + "tag-y" ) )
Copied!
Count Query
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.1
COUNT( "tag-x" > 1 )
Copied!
Function Query
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.1
FN( "function-name", "argument-1", "argument-2" )
Copied!
Last modified 3yr ago