As your app changes and evolves, you sometimes make user interface changes to your app's screens and buttons.
Pendo rules are agnostic to most of the user interface changes, meaning that your Page/feature analytics will keep on working. Pendo also has an analytics 'rule' for each tagged Page and feature.
However, there are some changes that require you to capture the page again to keep seeing analytics for these Pages/features. During this 'update' flow, Pendo updates the Page and feature rules to match the change in the application's UI.
Examples of changes in the user interface that require update:
- Change of a page's title or change of the selected tab's label
- A substantial change in the page's structure in iOS (tab bar, navigation bar, main menu etc)
- An addition of a new button that you want to tag
- A major re-design in your app
How do I know if I need to update a page?
Pendo Page Alerts: Pages with no views in your newest app version
Pendo proactively shows you any pages that have stopped collecting analytics and displaying guides. See the article on Page Alerts to learn more.
Pages with low views
Page Alerts shows you pages that have no views in your newest app versions but you might also need to update a page if you notice a low number of views, visitors or accounts. This is your sign to investigate. You might need to update the page (steps below), or the page rule might be too specific. Try going to Manage Page > Page Rules tab and remove the Page Title Identifier. If the page still shows low views after you’ve done this, contact Pendo Support.
How do I update a page?
- Go to Pages and select your page.
- Click Manage Page in the top right corner.
- Under the page's screenshot, click Update Page.
- If your device is not yet connected, connect your device and follow the instructions to capture this page again.
Note: You can do this flow at any time. You will not lose analytics because analytics are retroactive.
Help us locate features that changed
After updating a page, Pendo will try to locate all the previously tagged features of the page. If we fail to find any of them, we ask for your help.
- If a feature was removed from the page, click on 'Don't fix' to remove this alert. Features marked as 'Don't fix' will no longer show under the list of features in 'Manage Page' but you can still see their analytics under 'Features'.
- If a feature still exists on the page, click Update and select the feature again on the page’s screenshot. The feature's rule will then be updated to match both the old and the new appearances of this page.
This message indicates that some of your features have changed. Find the features on the new page.
As long as there are some unidentified features on a page, you will see an alert as a reminder. If you wish to stop seeing that alert, update these features or select 'Don't fix'.
Frequently asked questions
Should I do this with each new app version I release to the store?
No! Thanks to our page identification mechanism, you usually don't need to do anything in Pendo after upgrading your app. Analytics and guides will keep working.
This flow is required when your app changes and, as a result, the page rule or feature rule that Pendo uses does not identify the revised page/feature correctly. You'll be able to see that this is happening by identifying that your analytics numbers decrease for a specific page/feature. You can proactively verify that everything is still working by updating the page after you did some visual changes in your app.
I see a message of 'Page does not match' after update. Why?
You will see this message when we identify that the page you've just captured does not match its original page's 'rule'. We want to ask you to make sure that you've indeed updated the correct page.
After verifying that you are working on the correct page, go ahead and click 'Update Anyway' to continue with the flow.
What if I update a page that hasn't changed?
In this case, Pendo will identify that the existing analytics rules work for the page and all its tagged features, and will not change anything in the page's definition.
What happens if my page changed and I don't update it?
If you keep the page as is, it means that it is using a page rule that might not match its new appearance. In this case, this page will not collect analytics from the new app versions of your app. Expect to see a drop in the analytics of this page at around the time you released a new app version.
If you see this happening, update the page to make sure.
It's important to note that you will never lose analytics because of an app page/feature change. Analytics are always sent from the device. As soon as you update the page, you will start seeing the correct analytics count.
Why am I getting this error 'Different Page Captured'?
Sometimes when capturing the page you might see this error indicating that the newly captured page matches a different page than the one you are now editing. If this is not the case, contact Pendo Support.
Can you notify me when I need to update?
Yes, learn more about our Page Alerts.