URLs for Page tagging

Overlapping tagging rules

User interactions with your application are captured as raw events and sent to Pendo through the Pendo agent. Pendo processes these events and matches them against the rules you create for tagging Pages. Only events that you've defined in your tagging rule for a Page are pulled into the analytics for that Page. When you segment or filter based on a named Page in Pendo, you're searching every raw event and only pulling in events that match the rules that you've defined for that Page. This has implications for how overlapping rules impact your analytics.

A Pendo Page can be made up of several rules, as well as rules that include wildcards to capture multiple URLs. This allows you refine the search of raw events to define what counts towards a Page view, such as variations of the same URL. It also allows you to create a Page that represents views of an entire application or area of your application, which can be helpful for segments, reports, and guide targeting. For example, you might want to capture all the individual contact profiles under a single Page in Pendo called "All contacts".

You can capture both a group of URLs in a single Page and individual URLs belonging to that group in other individual Pages. This gives you flexibility in your analytics to see the data that's most useful to you. If an event satisfies the criteria defined by the tagging rules for more than one tagged Page, it's pulled into the metrics for each of those Pages. 

For example, as well as a single Page that captures a group of URLs called "All contacts" in Pendo, you might want to capture the individual contact profiles as separate Pages in Pendo. Overlapping or duplicate tagging rules between the "All contacts" Page and the individual contact profile Pages don't compete with each other. Rather, Pages that have overlapping or duplicate tagging rules count the same event against each relevant Page with a matching tag.

Parameterized URLs 

Pendo provides the ability to parameterize a URL. Parameters in Pendo Pages are specific query parameters or path variables that help you identify and track different variations of a URL or page within your application. These parameters allow you to gain a deeper understanding of user interactions with dynamic content or pages that share a common structure but vary by certain attributes.

This functions similarly to wildcard * except that it nests various wildcard results under the Pendo Page you created and is useful to create Page rules across a countable variety of URLs with a single entry.

For example, if you have the following three URLs that carry similar content or that you would like to view together:

https://www.pendo.io/features/foo/

https://www.pendo.io/features/bar/

https://www.pendo.io/features/ipsum/

You could use the following Page rule to capture all three:

//*/features/*parameter*/

These would appear inside your subscription under your Page rule showing the parameter value and number of Page views.

You can store a single query parameter as a Page Parameter using the same syntax described earlier, for example: //*/?first=*parameter*.

Pendo only tracks one list of parameters per Page tag, so a Page with multiple include rules with parameters will contribute to the same list of top parameters. Ensure you structure your rules accordingly to avoid data discrepancies.

Parameter values aren't case-sensitive, and only the top 100 parameters are displayed in the Pendo UI. To analyze all collected Page parameters, use the API described in Analyze Page parameters with the API.

URLs with UTM parameters

UTMs are tags added to the end of a URL to provide context on the source of the link. For example, a link embedded in an email might look like the following: www.example.com?utm_source=email. By adding utm_source to your URL, you can track activity from each source independently.

To view analytics for a UTM parameter value, you must tag your UTM parameters as Pages in Pendo. We recommend either of the following two approaches for tagging UTM parameter Pages in Pendo: 

• Tag each URL individually, creating one Page for every UTM parameter value.
• Create one Page that captures all possible UTM values using Pendo's parameter functionality.

Option 1. Create a Page for each UTM parameter value

If you have a limited number of UTM parameter values or are only interested in a select few, you can tag each value as an individual Page in Pendo. Since each UTM parameter value has its own page in Pendo, you can view usage analytics for each UTM source individually. You can also explore each value throughout the Pendo UI, including in Data Explorer, Funnel, and Path reports.

For example, to view activity for the three utm_source values below, you can create one Page in Pendo for each parameter value.

Option 2. Create a Page that captures multiple UTM parameter values

If there are many possible values for the UTM parameter, you can use Pendo’s parameter functionality to create one rule that captures all possible values in a single Page in Pendo.

For example, you can use a single rule with a parameter to create a Page that would allow you to view activity for all three utm_source values below. These values appear under your Top Parameters for that Page, aong with the number of views for each value on the Parameters table. 

Supported URLS

The table that follows lists supported standard URL syntax and examples.

Pendo understands the difference between https://domain.com/#page1 and https://domain.com/#page2. The Page rule, https://*, will match with both URLs. If your URLs are structured this way and you would like to have a Page rule that only corresponds with https://domain.com, review the Location API documentation.