Suggested Pages

Last updated:

The Suggested Pages table generates recommended rules based on URLs from your event data. Use this feature to accept or delete the recommended rules to tag the Pages that your visitors have seen in the last 48 hours.

Screenshot_2023-03-02_at_17.37.18.png

The Suggested Pages table populates data based on recent events over the last 48 hours from both public and staging environments. It shows the following:

  • A suggested Page Name.
  • The Include Rules that define what URLs would be included in each suggested Page.
  • Up to five Sample URLs that are captured by the rule for the suggested Page. 
  • The Application that the Sample URLs come from.
  • The Number of Views for each suggested Page using that rule.

A suggested Page can be associated with multiple URL visits. The Sample URLs list shows the top five URLs captured by the suggested Page rule as an expandable dropdown. This list isn't exhaustive. A Page rule could capture more URLs than what's listed under Sample URLs. If the list has fewer than five URLs, then these are all the URLs captured by the suggested Page rule.

Note: You can tag a Page multiple times using the same rules. It's therefore possible for suggestions to include rules that are already implemented in other tagged Pages.

Activate or deactivate suggested Pages

Suggested Pages are activated for each app individually by a Pendo Admin in Subscription Settings. Turning Suggested Pages on for any application makes the Suggested Pages table visible to the entire subscription, which individual users can turn off for their account under Settings > User Profile > User preferences. The table only recommends tags for apps with Suggested Pages turned on.

  1. Navigate to Settings > Subscription Settings.

  2. Open the Applications tab.

  3. Find and open the relevant app from your Applications list. This opens the App Details tab by default.

  4. Under Basic settings, use the checkbox next to Suggested Pages to turn Suggested Pages on or off.

AppSettings_SuggestedPages.png

Adjust notifications for suggested Pages

A red dot and a counter next to the Suggested Pages header indicates the number of pending Pages for all apps with Suggested Pages turned on.

You can turn notifications on or off for Suggested Pages at the user level. Navigate to Settings > User Profile, and look for User preferences where you can turn on or off the following:

  • The Suggested Pages table at the top of your Pages list. Turning this option off also turns off Notifications about suggested Pages.
  • Notifications about suggested pages. If you turn this option off, you can still choose whether you want to see the Suggested Pages table with or without the notifications.

UserProfile_SuggestedPages.png

Review suggested Pages

You must have Pendo Admin permissions to accept Suggested Page tags.

Find suggested Pages in Product > Pages > Overview. The Suggested Pages table shows all untagged Pages that appeared in your events in the previous 48 hours for both public and staging environments. If a suggested Page isn't used in 48 hours, it's dropped from the table until it's used again.

Suggested Pages haven't been tagged or processed yet. You can't see full retroactive analytics and you can't use suggested Pages in reports or tagging until after suggested Pages are tagged and data processing is complete.

The data you see in the Suggested Pages table can be different from the data you see when you tag them to add them to your Pages list. This is because the Suggested Pages table includes data from both your public and staging environments, while tagged Pages includes data only from your public environment.

The App filter limits which apps' Pages appear in the Suggested Pages table, in addition to filtering existing tagged Pages.

Suggested Page rules identify unique text in the URL and build a rule based on that unique element, ignoring the rest of the URL. Depending on the structure of your app, a suggested rule might tag a single Page or an entire area of your application. Both are good tags that provide meaningful data, but it's important to know what a tagged Page is capturing.

Long URLs with multiple sections might have multiple suggested Pages in the table with different specificity.

Accept or delete Suggested Pages

To take action on Suggested Pages, take the following steps:

  1. Look at the URL, rule, and number of views. This tells you what the suggested rule is tagging on your website and how much usage that page has gotten. It can be helpful to compare number of views to other similar suggested pages to see the specificity of different tags.
  2. Edit the name. Suggested Pages provide a simple default name based on the URL. You can change the name to something more detailed or keep the default name.
  3. If it needs to be tagged, accept the suggested Page. Select Accept at the end of the row to begin processing Page data. This moves the URL into the Pages list with a processing status.
  4. If it doesn't need to be tagged, delete the suggested Page. This removes the suggested Page from the table and doesn't suggest the URL and Page rule again.

After tagging a Page, processing can take up to one hour, and data is typically visible in the UI at the top of the hour.

Understanding URLs and suggested Page rules

Suggested Page rules use basic Pendo Page tagging rule syntax with text, as well as forward slashes (/) for paths, asterisks (*) for wildcards, question marks (?) for queries, and hashtags (#) for fragments.

Wildcards and text define the values in the URL. The rule is used to search the URLs saved in your captured event, and to match the structure and values in the rule while ignoring wildcard values. Every time the rule matches the URL in a raw event, it's counted as a Page view for that tagged Page, and the associated visitor, account, and Feature data is brought together.

For more information about Page tagging and more complex, manual Page tagging rules, see Tagging and viewing Pages and URLs for Page tagging.

Page rules

Page rules mirror the Website URL structure, but they remove the parts that you don't need and identify the parts that you do. Suggested Page rules do this for you automatically. When you know the structure of your URL and what the rule is searching for, you can confirm that the Page view data represents what you want to capture in that tag.

  • The beginning of the rule always starts with //. This cuts off the scheme. The rest of the rule looks at everything after it: //app.example.com/category/user/profile.html.
  • The entire domain is skipped with a wildcard //*/. All events are coming from the app where your Pendo install script is, and the install script for one app isn't typically installed on multiple domains: //*/category/user/profile.html.
    • This structure accounts for subdomains and other common configurations of the root URL. For example, dev.pendo.io, staging.pendo.io, and app.pendo.io might all have the same Pendo install script as code promoted between environments, and all are simplified down to //*/ in the Page tagging rule.
    • You can add the domain to a Page rule for greater specificity if needed, but this isn't done automatically in suggested Pages.
  • A unique value is identified in the path, while everything else is a wildcard: //*/*/user. This rule matches every page URL that ends with the user folder.
  • A unique value can be identified in the middle of a path and everything after is ignored: //*/category/**. This rule matches every URL with category in the path. It includes /category, /category/user, /category/user/profile.html, and any other branches on the website that fit.

Tip: For a real-world example of overlapping tags, we have Pendo installed over our Help Center. The base domain support.pendo.io is tagged as a Page to track usage of the entire website as a single Page. Each article is also tagged as a Page to track usage of a single article. Being able to target a single Pendo Page that represents usage of the entire app is a Pendo shorthand that's helpful in segments and reports.

Was this article helpful?
0 out of 1 found this helpful