Page Groups

Page groups allow you to semantically group pages together to analyze on-page activity aggregated across multiple pages instead of individual pages.

Page groups can be used in aggregate heatmaps, funnels, and segments and then used to filter any report where segments are used.

Note: Page Groups replace Page Roles, which are not customizable or useful in reporting.

There are several ways to create page groups in DXA. Each method is outlines below.

Creating a page group using URLs

  1. On the navigation bar, go to Define > Page Groups > + Create.Adding a page group

  2. Enter a page group Name.

  3. In Type, select Regex.
    Note: This is already selected by default.

  4. In the Regex box, enter a valid regex statement to group URL paths, as the Regex does not take into account query or fragments.

    A list of pages from the property that will be included in the page group appears.Adding a regex statement to group URL paths

  5. Click Save Page Group.

The page group is saved.

Creating a page group using data layer variables

  1. On the navigation bar, go to Settings button settings > Property Settings > Data Layer and click + Add Data Layer.

    Note: Data layer settings are only available to users with administrator permissions. For more information, see Roles.
    Add data layer screen

  2. Enter a Variable name, such as dataLayer.pageType.

  3. Enter a Description about the data layer.

  4. In Action, select Create page group.

  5. (Optional) In Limit, enter a limit to the number of page groups that will be created.

  6. In Execution, select Automatic.

  7. Click Save Data Layer.

A new page group is created based on the data layer variable value. For example, using dataLayer.pageType 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 be added to this group.

Creating a page group using the sendPageGroup endpoint

  1. Follow steps 1 to 5 in Creating a page group using data layer variables.

  2. In Execution, select Manual.

  3. Click Save Data Layer.

    The page group appears on the list in Data Layer Settings.

  4. In the Actions column, click Edit button Edit.

    From here, you can see the data layer ID. This will be required to call the sendPageGroup endpoint.Data layer ID

  5. On pages you want to put in a page group, send the sendPageGroup endpoint. For example:
    decibelInsight.sendPageGroup("Page Group Name", 1)

    In the above example. replace "Page Group Name" with the name of the page group and replace "1" with the data layer ID.

Creating a page group using page roles

Page groups can also be configured using the setPageRole endpoint. The passing of page roles will need to be configured before creating page groups.
Note: For more information, see Pages.
To create a page group using URLs, simply click + Add Page Group, provide this group with a Name which will be used throughout DXA, before selecting the relevant role from the Type dropdown menu. Upon selecting a page role, you will be presented with a list of the pages that will be included in the page group.
Note: Page roles are limited to 20 types. If you are looking to use an endpoint for the passing of page groups, DXA suggests using the sendPageGroup endpoint, mentioned above.