Overview
Tagging pages allows you to see page traffic and understand the flow & behavior of your mobile users.
Pendo’s Mobile SDKs start collecting analytics after a successful install. At the time of tagging, analytics will be retroactive to the time the SDK was installed. This means that Pendo automatically tracks any user action in your app, providing insights without any prior app tagging.
How to Tag a Page
- Go to Pages.
- Click on Manage Pages In-App to tag pages through our In-App Designer.
- Select your mobile application from the list and Launch Designer.
- Connect Your Device by using the Connect a new device button and follow the instructions. Or relaunch the App for an already connected device.
- Once your device is connected, a camera icon should appear on your device.
- Navigate in your app to the page you’d like to tag and click on the camera icon on your device. In a few seconds, you will see the page’s screenshot in the Pendo UI. Name the page. You may also assign it to a group.
- You can now select 'Save and Exit' to save the newly tagged page.
- Alternatively, you can select to Tag Features or continue tagging more pages. Don’t worry, you can always go back and tag more pages and features, analytics are constantly collected.
How is my page identified?
When tagging a mobile page, Pendo automatically sets a page rule for the page based on the page's structure.
Since applications vary, our automatic page rule is not always correct, and further configuration may be required to ensure the page rule yields the correct analytics.
This article will help you understand how you understand your automatically-assigned page rule, and how to customize it.
Page Rules when tagging
Page Rules and initial page views are visible while tagging Pages in the Pendo UI. The page views reflect the number of views from the last 24 hours as well as the percentage of views from overall traffic in the last 24 hours. This can give an indication of whether the automatically assigned page rule is accurate or needs refining.
Rule Components show you how Pendo identifies your page.
| Component | What is it | What should you do |
|
Page Title |
If this is selected, Pendo uses the page title information to identify the page. (iOS only, not relevant to React Native applications) |
If the title of your page changes between users or visits, you should exclude the title from the page rule.
|
| Selected Tab Index |
If this is selected, Pendo uses the index of the Selected tab in order to identify the page. (Note: Tab 0 refers to the first tab, Tab 1 to the second tab, and so force). |
If the position of your tabs changes between users, use the tab's title and not the index in the page rule |
| Selected Tab Title | If this is selected, Pendo uses the title of the Selected tab in order to identify the page. | If the title of your tab changes between users (for example, your app is localized to several languages), use the tab's index and not title in the page rule |
In this example:
- Pendo uses the Page title 'JUST ARRIVED' to identify the Page. Only pages with the 'JUST ARRIVED' title will be identified as this page.
- Pendo also uses the index of the selected tab in order to identify the page. Only when the selected tab is the first tab, Pendo attributes a view to this page. If another tab is selected, Pendo will consider this a different page.
- Pendo does not use the selected tab's title ('ARRIVED') to identify the page. This makes sense especially if this app is translated to several languages and this text is not consistent across users.
Managing Page Rules
After the initial tagging, you can access the Page Rules configuration and make further edits to manage your page rules, and add a Custom identifier if needed. In Pendo go to:
- 'Pages' > click on the relevant page
- Select 'Manage Page'
- Go to the Page Rules tab
Note: With any change you make, look at the number of page views in the last 24 hours to understand the effect of your changes.
Adding a 'Custom Identifier'
If different pages in your app have a similar structure, those pages might be assigned with the same page rule and show the same view analytics. Add a Custom Identifier when a page cannot be uniquely identified based on its structure. A Custom identifier is a unique label that exists only on this page.
To add a Customer Identifier, select a text label from the app's screen, and add it to the page rule. You can only add a Custom Identifier that exists across all of your app versions.
(Note that in React Native applications, you will usually not need a custom identifier).
Frequently Asked Questions
Why do I have several pages that show the same amount of data?
When several pages have the same structure, they might receive the same page rule and yield the same views. If this happens, try editing the rules of those pages and add a Custom Identifier unique to each page to increase the page identification accuracy.
What should I do if my iOS page shows no views?
When a page shows no views, it might mean the page rule is too specific. You can try removing any custom identifiers or excluding the page title from the rule and check the results. The page title should be included in the rule only if it uniquely identifies the page across all your users.
What happens when I have a new app version?
When releasing new app versions, pages will usually be identified with the existing rules. However, if changes were made to the page structure, page title, or the custom identifier, we recommend Updating the page, to make sure the page rule is updated with any changes made.
Why I’m not getting new analytics for some of the tagged pages?
Have you released a new app version to the store recently? If some of your pages/features changed in the newly released app version, you can update them by Updating the Mobile Page.
Since the Pendo's mobile page rule relies on the page's structure, major changes to your app require re-tagging the page, to continue getting analytics on the page. If button texts were changed in your app you might need to re-tag the page to update its features.
I can’t tag some of the features in my application. What do I do?
We’re constantly working on identifying as many mobile element types as possible. In iOS SDK 2.6 we've added support for gestures, if you have elements you couldn't tag we suggest updating the relevant page with SDK 2.6. If you’re unable to tag and get analytics for any of your mobile features, please contact our support. A possible workaround is either adding an accessibility label or adding Track Events for those features to collect that data.
How are advanced tagging rules relevant for my React Native applications?
In React Native, the title of the page is usually known at the Javascript level, so pages should generally be identified correctly by the automatic rule assigned by Pendo.
- Usually, a custom identifier will not be needed.
- Also, the page title is not identified for React Native iOS pages, so the option to include the page title will not be available.