Signals

A signal is a set of criteria that define a visitor sending you a signal that they should be classified in a specific way. When a signal's criteria are matched, the visitor receives a visitor score in the signal's dimension. Signal criteria focus on observable visitor behavior, such as:

  • Having a specific query string in the current URL (https://mysite.com?utm_campaign=my-campaign)
  • Having a specific cookie value (my_cookie=123)
  • Performing an event that's tracked by an analytics platform such as Google Analytics
  • Visiting a specific page/route (/about) A signal can consist of multiple criteria that are combined using logical operators, for example:
  • The visitor is from Canada and is a newsletter subscriber
  • The visitor is from Canada and (the province is Quebec or the province is Manitoba) The score from a signal has a duration, which defines how long the score lasts once given. The duration can be:
  • permanent: the score persists as long as possible (depending on browser restrictions)
  • session: the score persists until the visitor is idle for a period of time defined when your site loads the Uniform Context script
  • transient: the score is given only when the criteria are true, and is removed as soon as they're not When a signal is activated, the amount of score given is controlled by two settings: strength and cap. The strength is the amount of score that's given each time the criteria are true. For example with a signal such as 'the current page is /about' with a strength of 50, each time the visitor visits /about, they gain 50 points in the signal dimension. Cap sets an upper bound on how much score you can get for a given signal. If our /about signal had a cap of 125, then the visitor would get 50, then 100, then 125 points and stop growing. Together strength and cap provide powerful tools to gather visitor behavior without letting any particular signal overshadow other important signals.

Uniform supports the following criteria types:

TypeDescriptionExample
CookieData stored on visitor's computers while browsing your siteWhen a visitor's browser has a cookie set on your site called SEGMENT value leads
Current pageMatches against the current page or route a visitor is on. Combines well with Page View Count = 1 to capture landing pages. Value checked doesn't include domain or query string data.When the current page is the products/widgets page.
EventEvents sent to integrated analytics in the browser. The signal duration determines how the tracker determines if the event was triggered:
  • Current session: The check considers events triggered in the current session.
  • Permanent: The check considers events triggered in any session.
  • Transient: This criteria type doesn't make sense for a signal with a transient duration.
When a Google Analytics event is triggered with name signup_form.
GroupA logical grouping, which can contain child criteria in an AND/OR relationship.Current page is /foo AND (event = bar OR query = campaign). The () is a grouping of criteria.
Page view countMatches on the number of pages a visitor has visited. The signal duration determines how the tracker determines the page view count:
Current session: The check considers page views from current session.Permanent: The check considers the total number of page views across all sessions.Transient: This criteria type doesn't make sense for a signal with a transient duration. Combines well with Current Page and a match on count = 1 to create a Landing Page signal.
When a visitor has visited more than 3 pages during their current visit.
Query stringParameters added to the visitor's current URL by developers or marketing tools.When a page is visited that contains utm_campaign=ppcquery string value in the URL, such as https://yoursite.com/campaign?utm_campaign=ppc
QuirksMatch against values provided by integrations such as GeoIP or custom values set by developers.When the visitor country quirk equals Canada
  1. In Uniform, open your project.

  2. Navigate to Optimization > Personalization > Signals.

    no-signals
  3. Click the red Create a signal button.

  4. Enter the following values:

    FieldDescription
    NameName that describes the signal.
    Public IDValue that uniquely identifies the signal.
    Signal scoreThe Uniform tracker increases the signal score by this value when the signal is triggered.
    Max scoreThe Uniform tracker won't increase the signal score above this value, even if the signal is triggered.
    Duration
    • Current session: Score is reset when a new session begins.
    • Permanent: Score persists across sessions.
    • Transient: Score is reset before scores are updated.
  5. In the section SIGNAL CRITERIA BUILDER, select a criteria.

    About this step

    For more information about the available criteria, see the criteria types under capabilities.

    criteria-options
  6. Configure the signal criteria.

    About this step

    For details about the configuration options for each signal, see the criteria types reference.

  7. You can add additional criteria to your signal if required.

  8. Click Save and close.

    signal-added
  1. In Uniform, open your project.
  2. Navigate to Optimization > Personalization > Signals.
  3. Find the row that represents the signal you want to delete.
  4. Click the red trash can icon.

About this step

If the deleted signal was used to personalize any composition, when you open the composition you will see an "invalid" message. When you select the component with the personalization you will see
an error message about "criteria dimension doesn't exist."

You must either select another dimension or delete the personalization criteria before you are able to save any changes to the composition.

missing-signal