Skip to main content

Page Groups

Page Groups​

Grouping pages by their type or the template they use makes Web Vitals data more actionable and filters easier to use.

By default pages are grouped by their title – document.title – but we recommend creating your own Page Groups to classify pages in a way that makes sense for your site or app. A retailer might choose Home, PLP, PDP etc, or a news publisher Home, Section, Article, Video article etc. for their Page Groups.

info

Page Groups are supported by SDK v2.14.0 or later.

Creating Page Groups using URL Patterns​

Using URL patterns allows you to create and update Page Groups without making code changes or redeploying your site or app.

Open the Settings for your App and click on the Page Groups tab.

The rules are evaluated in the order they are listed so the most specific rules should be at the top of the list.

Screenshot of List of Page Labels on Settings page

Adding a New Label​

Add Rule allows you to create more Groups or add a new URL patterns to an existing Group.

Screenshot of Adding a Page Group on Settings page

Each rule must have a Page Group name and at least one matching pattern.

Patterns are defined using RE2 syntax and each page label can have multiple matching patterns.

Checking Regex Patterns​

You can test patterns by adding a URL to the field at the bottom of the dialog and pressing the Test button.

Screenshot of Checking a URL Pattern on Settings page
note

Patterns are evaluated when the RUM data is ingested and Groups are immutable once ingested.

Only the protocol, domain and path components of a URL are used when matching labels, any query string or fragment is ignored.

Creating Page Labels via the SDK​

Page Groups can also be set directly via the SDK. URL based rules will take precedence over SDK set ones.

pageManager.setPageLabel('my-custom-label');
pageManager.setCurrentRoute({
  label: 'my-custom-label',
  path: '/products/:productId',
  url: '/products/123',
});