Decibel Insight
Knowledgebase

Page Groups

Page Groups are a way of grouping pages together and allow you to analyse on-page activity aggregated across a number of pages, rather than on an individual page-by-page level. 

Page Groups can be accessed by going to Settings > Page Groups, which can be found under the Property Settings heading.

There are multiple ways to configure Page Groups, all of which have been detailed below.

Page Groups can then be used in Aggregate Heatmaps, Funnels and Segments which, in turn, can be used to filter any report where Segments can be used.

Grouping Pages Using URLs

To create a Page Group using URLs, simply click Add Page Group, provide this Group with a name which will be used throughout the platform, before selecting Regex from the Type dropdown.

If selecting Regex, you will need to enter a valid regex statement in the Regex text field that would group together URL paths, as the Regex does not take into account query or fragments. Upon entering a Regex, you will be presented with a list of the pages that will be included in the Page Group, such as in the image below.

Grouping Pages Using Data Layer Variables

Decibel has the ability to define Page Groups based on Data Layer variables using our Data Layer Management.

Data Layer Management can be found within Decibel by going to Settings > Data Layers. Please note that Data Layer Management is only available to users with Administrator privileges. 

To begin configuring Data Layer Management, click the Add Data Layer button, where you will be presented with a number of options such as in the image below. 

You will need to input the variable name, such as dataLayer.pageType which is being used in the example, not including the value of the Data Layer variable. The Page Group will be named based on the value of the Data Layer variable. 

Following this, add a description of the variable name that is being used before selecting Create Page Group from the Action dropdown. This will create a new Page Group based on the value of the variable. In the example above, we are using dataLayer.pageType, which returns values such as PDP, Checkout and Home. Page Groups will be created and named after the values that are returned. If a group has already been created, then the page will simply be added to this group. You can select a limit to the number of Page Groups that will be created.

Select Automatic from the Execution dropdown, before clicking Save Data Layer in order to save your changes. 

Grouping Pages Using sendPageGroup

Decibel can also collect Page Groups using the sendPageGroup end-point. To do this, you will need to follow the above steps under the Grouping Pages Using Data Layer Variables header. However, under Execution, you will need to set this to Manual, such as in the image below.

After clicking Save Data Layer, you will now need to click the Edit icon on the Data Layer that you have just created. From here, you will be able to see the ID of the Data Layer, as shown in the image below. This ID will need to be used when calling the sendPageGroup end-point.

On the relevant pages that you wish to put into a Page Group, you will need to send the sendPageGroup end-point, such as in the below example:

decibelInsight.sendPageGroup("Page Group Name", 7)

In the above example, Page Group Name should be replaced with the name of the Page Group that you would wish to place the Page in, while the second parameter (7 in the above example) should be replaced by the Data Layer ID referenced in the above screenshot.

Grouping Pages Using Page Roles

Page Groups can also be configured using the setPageRole end-point. The passing of Page Roles will need to be configured before creating Page Groups. You can find out more about defining Page Roles here.

Please note: Page Roles are limited to 20 types of Page Role. If you are looking to use an end-point for the passing of Page Groups, we would advise using the sendPageGroup end-point, mentioned above.

To create a Page Group using URLs, simply click Add Page Group, provide this Group with a name which will be used throughout the platform, before selecting the relevant Role from the Type dropdown. Upon selecting a Page Role, you will be presented with a list of the pages that will be included in the Page Group, such as in the image below.