Path segment rules

Documentation - Path segment rules

Default behavior

Pulse receives URL paths for each page that your users visit on your site. Due to the common use of REST routes or other schemes, duplicate Pages would be created by default for the same view. Using a common forums web application example, the http://foo.com/thread/1 and http://foo.com/thread/2 otherwise show up as two Pages inside Pulse, when really they are two instances of the same Thread view.

By default, Pulse replaces both integer path segments and DateTime strings with the wildcard character *. Thus, the above two page views would be bucketed beneath the single Page http://foo.com/thread/*.

You can add new rules on the Pulse -> Settings page:

Any new or deleted rules are saved whenever you click 'Add Rule' or the delete button beside a rule.

Any changes to the two rule lists documented below may take up to 15 minutes to be reflected by new pages in the Pulse dashboard.

Grouping URLs

This allows you to add your own path segment wildcards for your routing scheme, if you have non-integer segments that can change for the same view. For instance, if you add a new row to the Grouping URL rule list containing this:

http://foo.com/forum/*

Page visits for the routes http://foo.com/forum/foo and http://foo.com/forum/bar will show up beneath the same Page in Pulse.

These can be made more specific. This grouping rule:

http://foo.com/forum/*/delete

will turn pages visit to /forum/foo/delete and /forum/bar/delete into /forum/*/delete.

Ungrouping URLs

Single URLs

If you want routes containing integer path segments to appear un-wildcarded, you can disable the default integer wildcarding by adding to the Ungrouping rule list on the Pulse Settings page. For instance:

http://foo.com/thread/1

http://foo.com/thread/2

Visits to the above two routes would show up as two Pages inside Pulse, while a visit to http://foo.com/thread/3 would show up under /thread/*.

All URLs

If you want to mass-ungroup segments all URLs that match a rule, you can do so by have an ungrouping rule with a wildcard character:

http://foo.com/thread/*

All pages such as /thread/1, /thread/2 etc. will appear as their own pages in Pulse.

Subdomains

Subdomains can also be grouped or ungrouped in the same way as the segments above. If you have multiple domains that each serve the same pages, you can set these up to be (un)grouped using rules such as:

https://*.foo.com

https://www.*.com

The protocol and domain is optional

Don't care about matching by the protocol/domain that your pages have? You can also add rules with just the path, e.g:

/forum/*

Mixing ungrouping with grouping

You can have ungrouping rules coexist alongside grouping rules. Ungrouping rules take precedence over (AKA override) grouping rules. For instance, this ungrouping rule:

http?://www.example.com/route/*

Combined with this grouping rule:

http?://www.example.com/route/*/*

Will cause the following two pages:

https://www.example.com/route/1/ff000

https://www.example.com/route/1/ee00ff

To appear in Pulse as this one page:

https://www.example.com/route/1/*

Documentation missing?

If we don't have documentation about your desired topic, send us a message and we'll create it for you.