URL Parameter criterion

The URL Parameter criterion is a triggering criterion that enables defining a segment.

To learn how to create a segment, please refer to this article.

📖 Definition

The URL Parameter criterion enables you to restrict the visibility of a campaign to visitors depending on the composition of their URL parameter(s) when they visit your website. A URL parameter is a way of passing on information about an event through a URL. They are commonly used for tracking and analytics. Parameters are located at the very end of the URL or within the path, depending on how the URL has been built. URL Parameters include a key paired with a value. A URL parameter begins with a question mark (‘?’) and each one is separated by an ampersand (‘&’). They can also be dynamically set in the path as values, separated by slashes and other characters (depending on the system used and how it’s implemented). These key/value pairs are used to track campaigns such as acquisition or emailing campaigns.

For example, in the following URL:

In this example, the parameters are as follows:

🗝️ Key	🔡 Value	❔ Whole parameter
utm_source	google	utm_source=google
utm_medium	banner	utm_medium=banner
utm_campaign	april21	utm_campaign=april21

⚙️ Configuration

To configure the URL Parameter criterion, choose whether you want to include (is) or exclude (is not) a key (ex: utm_source) and enter the value of this key if there is one (ex: google).

⭐ Good to know

For the name and value of the parameter, you need to enter the string without “?” and “=” characters. This triggering criterion only works with query parameters such as “?”. It doesn’t work with hash “#”).

💡 Use case

Let’s say you want to trigger your campaign on VIPs users that come from a specific newsletter you have sent your VIP clients. These people have received an email with a specific key (for example utm_campaign) and value (for example VIPParis) appearing in the URL of their webpage. To trigger your campaign for this traffic source only, in the URL parameter trigger, you need to specify the key and value related to this email. In this example, it will be utm_campaign and VIPParis.

🔎 How does it work?

The AB Tasty tag reads that information directly from the DOM “window.location.href” element.

Need additional information?

Submit your request at [e-mail]

Always happy to help!