Visitor and Account metadata are collected under Visitor and Account IDs. Visitor and Account IDs are how you describe and label your users, and can't be changed. Visitors represent individual users of your application, and Accounts represent groups of associated users, typically the company they belong to.
This article describes how to supply metadata at the Visitor and Account levels to enrich your analytics and your options for guide targeting. You can leverage this metadata when you build segments and reports, and you can add and remove metadata over time.
Send us metadata
Before installing Pendo, identify what information and metadata you want to capture. Add any variables to your Pendo install script under the Visitor and Account sections. For guidance, see the Developer's guide to installing Pendo.
Unlike Visitor and Account IDs, you can change metadata fields. Examples of Visitor-level metadata include: first name, last name, email address, user permissions, and role or title. Examples of Account-level metadata include: account name, industry, market segment, account creation date, signup date, contract start date, renewal date, and contract value.
Map your metadata
Your metadata is configured in Data Mappings, which has a separate tab for Visitor Level Data and Account Level Data. This is where admin users can specify the type of data fields that are sent to Pendo. For more information, see Data Mapping and Data Types in Pendo.
View your metadata
Visitor and Account metadata are different for every Pendo customer because not everyone sends the same metadata fields. Admin users can check the metadata being sent to Pendo in Settings > Data Mappings. The Data Mappings page is where you can see the names and types of data Pendo uses for analytics.
If you're not an admin user, you can instead go to http://app.pendo.io/metadata. The first dropdown menu lists all the metadata currently sent to Pendo. Selecting an item from the dropdown shows you metrics, such as how many unique values are being sent for that metadata field.
Promote your metadata (beta)
Visitor and Account metadata always show the details associated with the last recorded event for a user. If you want to have historical context around user metadata, you can choose to enable historical metadata for up to five data mapping fields in your subscription.
When you enable historical metadata, it's considered a global event property, as it allows that data to function like an event property by capturing the value on every event at the time it occurred.
You can't enable historical metadata for default values of Visitor ID and Sample Group, metadata with a list type, and Segment.com metadata.
To learn more, see Historical metadata (beta).
Metadata groups
Visitor-level and Account-level data have the following metadata groups associated with them.
Agent metadata
This is metadata from your product that's passed through the install script, commonly referred to as "the snippet". You can't modify these fields manually or through the API—you can only change them within the code. The agent data must be reviewed inside of Pendo to ensure that the data type listed in Pendo matches the actual data type sent in the install script.
This metadata automatically updates when a user visits a page in your application and passes the fields to Pendo. If an agent metadata field is incorrectly populated, it can only be updated the next time the user visits your application and passes the correct information. Several metadata fields are provided out of the box:
Default Account Metadata:
- First Visit
- Last Visit
- Number of Days Active
- Number of Events
- Number of Visitors
- Time on Site
Default Visitor Metadata:
- First Visit
- Last Visit
- Number of Days Active
- Number of Events
- Time on Site
- Most recent browser version and name
- Most recent operating system
- Most recent server name
Salesforce metadata
These metadata fields are pulled in from Salesforce through our integration. This is only an option if the Salesforce integration is enabled. These fields are not editable. For more information, see the Salesforce Integration Overview.
Segment.com metadata
These metadata fields are pulled in from the Segment.com integration and are not editable from the Data Mappings page. This type of metadata is only used with the integration. For more information, see Segment.com Integration Overview.
Custom metadata
Use custom ("Pendo only") metadata fields if the data you want to add doesn’t fall into any of the above groups. You can add custom fields on the Data Mappings page. These must link to a visitor or account. To do this, open the details of an individual visitor or account and add a value.
Update this field manually on a specific Visitor or Account details page, or update in bulk through our API to add larger amounts to custom fields.
Acceptable metadata format
When adding any new type of metadata (agent, custom, Salesforce, or Segment) that is a date, Pendo uses the ISO8601 W3C (ex: 2006-01-02T15:04:05.999-05:00) format. Make sure you’re using this format before sending data into Pendo. Contact Pendo Support for additional assistance if you want to change and use a different date format.
Metadata field names must start with a letter or an underscore and can include any combination of letters, numbers, and underscores. Field names containing spaces or other unsupported characters won't be created in Pendo.
For more information on supported data formats, see Data Mapping and Data Types in Pendo.
Remove agent or custom metadata
Agent or custom metadata can be removed or deleted through the Data Mappings page. To delete a metadata field, hover over the field, select Remove, and then confirm the deletion. The confirmation prompt displays for a couple of seconds to prevent accidental deletions. If no confirmation occurs, the button reverts to the Remove state.
Once you confirm, the metadata field is removed from the list and is no longer available for use in segmentation.
Note: If you delete an Agent type field from the Pendo UI, but don't delete it from your install script, Pendo will continue capturing the data but won't re-populate into the UI. To undo the deletion, contact Pendo Support.
Frequently asked questions
What types of metadata should I send to Pendo?
We recommend you send us anything you would find beneficial in segmenting your Visitor and Account base. Several examples include Role, Account Status, Account Manager, Contract Expiration Date, Account Creation Date, and so on.
How do I send custom language metadata?
The default language metadata field in Pendo is collected from the visitor's browser settings by the agent. Custom visitor metadata can be passed through by the agent or integrations, like Salesforce. Custom language metadata fields must use a name other than language. This name is reserved for browser language metadata and cannot be replaced.
You can specify a different metadata field in Localization settings. Learn more about localization in the Localization Overview article.
What key values are supported when passing metadata through the snippet?
A custom "key" must start with a letter or a "_". No other types of syntax is supported. For example, if you have a key such as "300", it needs to be changed to "_300" to work properly with Pendo. If this syntax is not followed, you cannot create segments or run reports using those custom fields.
Supported syntax includes:
- letters
- numbers
- _