To collect usage data and deliver in-app messaging, you must create an extension app in Pendo. An application in Pendo corresponds with a specific site that you plan to overlay Pendo guides on and gather analytics from.
Create a new extension app
Applications are managed in Settings > Applications. From here:
-
Select Add Application in the top-right corner of the page.
-
Enter an App Name. Enter at least one character.
- Specify an Extension Platform Type. Applications in the Extension Platform Type receive pre-tagged features.
- Add Websites that you want to collect data and deploy guides on.
-
Select Save to add the application to the list in the Apps section.
When Salesforce is selected as the Extension Platform Type (when Pendo is deployed on Salesforce through the Pendo Launcher), the following Salesforce specific HTML attributes are also auto-captured:
1 const HTML_ATTRIBUTES = {
2 'sfdc': [
3 ' name',
4 ' data-component-id',
5 data-aura-class',
6 'role',
7 ' label',
8 'placeholder',
9 'contains',
10 'alt-text',
11 'title'
12 ]
13};
The following HTML attributes (classes and IDs) are ignored:
const TAGGING_CLASS_EXCLUSIONS = {
'sfdc': ['sc-*']
};
const TAGGING_ID_EXCLUSIONS = {
'sfdc': ['content_*']
};
Capture a domain name
The easiest way to collect the domain is by navigating to the application in the browser, right-clicking the extension, and selecting Show Debug Info. Then select Show Configuration Info. The "App Hostname" value is exactly what you want to copy.
Note: Don't add either http:// or https:// to the domain. The path of the website, for example, /home or /admin/app/12345?tab=details, is also unnecessary. If added, the New Extension Application doesn't save. Once the Add Extension App form is submitted, Pendo checks to ensure none of the domain(s) of the new application conflict with other applications. If there is a conflict, the new Extension Application doesn't save.
Access app details
App details are found in Settings > Subscriptions. Select an app and then View App Details. This shows you the following:
-
Display Name. Name of the application that appears in the top-right dropdown of Adopt.
-
Extension Platform Type. Applications that have been pre-tagged.
-
Websites. Websites that the Pendo Launcher and application are receiving event data from.
-
Disable Designer Launch URL Token. On by default. If you're considering disabling this box, speak with your Pendo representative.
-
Show Guides to Anonymous Visitors. Setting specific to extension application. Enabling this setting captures event data from contractors and users that are not full-time employees. Note that anonymous visitor analytics are enabled through a different setting; see Anonymous visitors to learn more.
-
Text Captured on Feature Clicks. Off by default.
Frequently Asked Questions
How do I add more domains to an existing application?
Select View App Details by hovering over the application you want to edit. In the App Details tab of the application, locate the URL Patterns row and select Edit. From here, you can add additional domains or edit the existing domains you’ve included.
How do I exclude certain data from being captured by Pendo?
Contact your Pendo Representative for requests about limiting which data Pendo captures.
How long will it take to see the new extension on the intended user’s system?
Setting up a new extension application doesn't immediately propagate to all users. Most users must wait 2 hours for the application to sync to their installed extension. To quicken the process, a user may select “Re-fetch Extension Settings” in the extension to prompt Pendo to begin collecting event data.
Why is my new application labelled "Not Installed" after I've created it?
The application isn't considered “installed” until Pendo receives its first event. Once Pendo receives its first event, a green “installed” label appears underneath the name of the application.