This article details how to tag Features in your mobile application, and how to troubleshoot Feature tagging.
Tag a new Feature
Feature tagging can either be done when tagging a Page or by accessing the designer via Tag Pages:
- Go to Pages and select Tag Pages.
- Filter to your mobile app.
- Select the Page you want to tag Features on.
- Select Manage Page and start tagging your Features in the screenshot on the right, or select the button to let Pendo tag all the Features on the page for you. Each Feature shows up in a table on the left, where you can name it, group it, edit its attributes, and then save it.
To edit an existing tagged Feature, see Editing an Existing Tagged Mobile Feature for more information.
Suggested Features (open beta)
The Suggested Features list generates recommended Feature tags for UI elements in your application that receive high engagement. It gives you an overview of how users engage with UI elements in your application and the ability to prioritize tags based on engagement data.
Pendo detects UI elements in your application that are buttons, links, and input boxes (not the text inside an input box) and identifies the relevant rule tagging these elements. Pendo then populates the Suggested Features section based on events indicating high engagement with these elements over the last 36 hours.
Pendo only begins processing Feature data after you've tagged it. Suggested Features haven't been tagged or processed yet. You can't see full retroactive analytics and you can't use suggested Features in reports or tagging until after suggested Features are accepted (tagged) and data processing is complete.
You can either accept and finish creating a suggested Feature or delete it.
Before making a decision to accept or delete a suggestion, hover over a suggested Feature from the list to see which UI element you would be tagging and how much usage that UI element has gotten.
To accept the suggested Feature, select Tag at the end of the suggested Feature's row. This moves the rule into the Features list with a processing status. Processing can take up to an hour.
Delete a suggestion
To delete the suggested Feature, select the trash icon at the end of the suggested Feature's row. This removes the suggested Feature from the list and doesn't suggest the Feature again. Deleted suggestions don't reappear in the list, but can be created manually following the instructions outlined in Tag a new Feature.
Code-base solution for tagging Features
Note: Currently available for native iOS and Android apps, and React-Native apps only. We plan on adding this feature to Xamarin Forms in the future.
Pendo might not always recognize a Feature in your apps. It can either render it as untaggable in Pendo, or it does show as taggable but doesn't show any analytics. Our code-based solution solves this problem by allowing your mobile developers to tag and get analytics for any Feature using an API.
To implement this, your developer must set this up. See Setting up a code-based solution for Mobile Tagging.
Frequently asked questions
How are my Features identified?
- A Feature is always tagged in the context of a Page.
- A rule is created for each tagged Feature that relates to the "class" of the element, the element's text if such exists, its position in the list, its position on the Page, and many other parameters.
- If a Feature is not identified correctly, contact Pendo Support so that we can modify the Feature's rule to match your needs.
- Features will usually be identified correctly across your app versions. However, if you performed User Interface changes to your app and specifically changed button texts, you might need to Update the Mobile Page to make sure all Features are identified correctly and fix the tagging if needed.
I hover above a Feature, but more than one Feature is highlighted instead of the desired one. What should I do?
We now highlight all matching Features upon tag to prevent situations where Pendo's automatic feature identifier (rule) isn't enough to distinguish between several Features on the Page. This means, that without refining the automatic rules, these Features would count as the same Feature.
To fix this, tag the first C, refine its rules to be more specific to this Feature, and then tag the other Feature.
I can’t tag some of the Features in my application. What do I do?
There are many ways to implement mobile buttons within an App and we are optimizing the way our SDK identifies Features. However, if you’re unable to tag and receive analytics for specific mobile Features, contact Pendo Support. A possible workaround is using Track Events to track specific Features to collect that data.
Note: Pendo automatically tracks events for back button clicks on Android devices. This is relevant only when the app is in the foreground and in focus. These events are included in the path data, so you can see if the back button was clicked when navigating between pages. This event is not available for Guides and other analytics reports.
I stopped getting new analytics for some of the tagged Pages. Why is that?
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.