Agent
additionalApiKeys : Array.<string>
Array of additional API keys that are set in the config. If no primary API key is set,
the first in this array will be assigned to pendo.apiKey
.
Example
pendo.additionalApiKeys => ['FIRST_API_KEY', 'SECOND_API_KEY']
apiKey : string
API key that is associated with the current Pendo installation as a string.
Example
pendo.apiKey => 'API_KEY'
getVersion() ⇒ string
Returns current version of the Agent as a string. Also directly accessible at pendo.VERSION
.
Returns: string
- agent version
Example
pendo.getVersion() => '2.150.0'
initialize(options)
Initializes the Pendo Agent in a browser window.
See: Pendo Installation
Param | Type | Description |
---|---|---|
options | object | identity metadata and configuration to initialize agent |
Example
pendo.initialize({
visitor: {
id: <visitor-id-goes-here>, // Required if user is logged in
// full_name: "John Doe", // Recommended if using Pendo Feedback
// email: "user@acme.com", // Recommended if using Pendo Feedback or NPS email
// role: "Viewer" // Optional
// You can add any additional visitor level key-values here,
// as long as it's not one of the above reserved names.
},
account: {
id: <account-id-goes-here>, // Recommended, required if using Pendo Feedback
// name: "Acme Co", // Optional
// is_paying: false, // Recommended if using Pendo Feedback,
// monthly_value: 0, // Recommended if using Pendo Feedback
// You can add any additional account level key-values here,
// as long as it's not one of the above reserved names.
}
});
isReady() ⇒ boolean
Returns boolean representing whether the Agent is fully loaded and has an API key.
Example
if (pendo.isReady()) {
// runs if agent has fully loaded
}
teardown() ⇒ void
Shuts down the agent and cleans up all timers and listeners. Upon completion the agent will be able to be re-initialized when needed or cleaned up from the window. This will halt all guides and data collection.
Example
window.pendo.teardown();
pendo.isReady(); // this will return false
delete window.pendo;