Pendo

Pendo is a software platform that offers product experience and digital adoption solutions to product-led organizations. These solutions help product teams and application owners understand the customer’s product journey, guide users through in-app messaging, and collect feedback to deliver better product experiences.

Pendo allows creating accounts for your subscription only in the US or the EU region. Your data is stored in a regional data center, and Pendo does not allow migrating data between subscriptions or regions. Read Subscription Change Limitations.

Hevo uses the Pendo v1 API endpoints to replicate your data into the desired Destination database or data warehouse. For this, you must provide Hevo with an integration key to access your account’s data. Refer to the Data Model section for information on the objects that Hevo creates in your Destination.


Prerequisites

  • An active Pendo user account with Admin permissions. Read Roles and Permissions for information on granting admin privileges to a user.

  • The integration key for your account is available to Hevo for accessing your Pendo account’s data.


Configuring Pendo as a Source

Perform the following steps to configure Pendo as the Source in your Pipeline:

  1. Click PIPELINES in the Asset Palette.

  2. Click + CREATE in the Pipelines List View.

  3. In the Select Source Type page, select Pendo.

  4. In the Configure your Pendo Source page, specify the following:

    Configure your Pendo Source

    • Pipeline Name: A unique name for your Pipeline, not exceeding 255 characters.

    • Region: The subscription region of your Pendo account. Default value: Region - US.

    • Integration Key: A secret value with read-write access to your Pendo data via v1 APIs.

      Note: This key is specific to the subscription region of your account.

    • Historical Sync Duration: The duration for which the existing data in the Source must be ingested. Default value: 3 Months.

      Note: If you select All Available Data, Hevo fetches all the data created since January 01, 2013 for your account.

  5. Click TEST & CONTINUE.

  6. Proceed to configuring the data ingestion and setting up the Destination.


Generating the Integration Key

Pendo authenticates requests from Hevo to access the information about your users and accounts with an integration key.

Perform the following steps to generate the integration key:

  1. Log in to your Pendo account as an Admin user. Use one of the following URLs:

    • US region: https://app.pendo.io/login.

    • EU region: https://app.eu.pendo.io/login.

  2. In the left navigation pane, click the Settings ( ) icon, and click Integrations.

    Settings - Integrations

  3. In the Integrations page, select the Integrations Keys tab, and click + Add Integration Key.

    Add Integration Key

  4. In the Add New Integration Key dialog box, do the following:

    Add New Integration Key

    • In the Description box, describe the key to help you identify it. For example HevoIntegrationKey.

    • Select the Allow Write Access check box to grant read-write access to your integration key.

    • Click Create.

  5. Copy the new integration key, and save it in a secure location like any other password.

    Created Integration Key


Source Considerations

  • Pendo imposes a strict limit of 100 calls per second to any single API endpoint. Therefore, data ingestion is deferred for a second if the number of calls made by Hevo to any single API exceeds 100.

Data Replication

Default Pipeline Frequency Minimum Pipeline Frequency Maximum Pipeline Frequency Custom Frequency Range (Hrs)
15 Mins 5 Mins 12 Hrs 1-12

Note: You must set the custom frequency in hours as an integer value. For example, 1, 2, 3 but not 1.5 or 1.75.

  • Historical Data: In the first run of the Pipeline, Hevo ingests the historical data for all the objects using the Recent Data First approach. The data is ingested on the basis of the historical sync duration selected at the time of creating the Pipeline and loaded to the Destination. Default duration: 3 Months.

  • Incremental Data: Once the historical load is complete, all new and updated records are synchronized with your Destination as per the ingestion frequency.


Schema and Primary Keys

Hevo uses the following schema to upload the records in the Destination:


Data Model

The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:

Object Description
Account Contains information about the accounts that are associated with a user. In Pendo, accounts are a collection of your product’s users.
Application Contains information about the applications integrated with your user’s account.
Events Contains information about the events that Pendo automatically tracks from your browser interactions.
Feature Contains information about the features your users interact with while using your product.
Feature Events Contains information about events matched to features marked for tracking by your users.
Guide Contains information about the in-app messages you show your users to inform them about new features and feature upgrades, walk them step-by-step through tasks, and so on.
Guide Events Contains information about the interactions your users have with the guides you created.
Page Contains information about the pages your users visit when using your product.
Page Events Contains information about events matched to pages marked for tracking by your users.
Poll Events Contains information on all the interactions your users have with any polls you created.
Track Events Contains information about the events you create to track user actions, such as creating or deleting a record or logging a specific error case for monitoring purposes.
Track Types Contains information about the properties that uniquely identify a Track Event while processing it.
Visitor Contains information about your product’s users, which includes internal customers.



Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Sep-05-2022 NA Updated section, Data Replication to reorganize the content for better understanding and coherence.
May-24-2022 1.89 New document.
Last updated on 05 Sep 2022

Tell us what went wrong