Skip to main content
Gainsight Inc.

Configure Multi-Question Survey Response in Adoption Explorer

This article helps admins enable Multi-Question Survey Response data ingestion into Gainsight CS.

This article helps admins enable Multi-Question Survey Response data ingestion into Gainsight CS.

Overview

Multi-Question Surveys in Gainsight PX enable you to collect structured, in-depth feedback from users at key points in their journey, such as during onboarding or when engaging specific user segments. By designing surveys with multiple questions and customizable answer formats, you can capture user intent, assess sentiment, and gather actionable insights across critical touchpoints.

Multi-Question Surveys support broader customer feedback programs and empowers product teams to make informed decisions based on real user input.

When Gainsight PX is integrated with Gainsight CS, admins can export Multi-Question Survey Response data directly into Adoption Explorer, driving deeper insights into product usage.

For more information on the Multi-Question Surveys, refer to the list of articles:

Prerequisites: Gainsight recommends creating an integration between Gainsight PX and Gainsight CS before proceeding ahead.

Enable Multi-Question Surveys Data in Adoption Explorer

Adoption Explorer provides integration with Gainsight PX to automatically pull pre-aggregated feature usage and engagement data. This enables quick access to insights through built-in metrics and dashboards.

To bring MQS data into Adoption Explorer, complete the following steps:

  1. Establish a connection between Gainsight PX and Gainsight CS
  2. Configure an Adoption Explorer project
  3. Ingest Custom Files from PX

Establish a Connection Between Gainsight PX and Gainsight CS

Before bringing MQS data into an Adoption Explorer project, you must establish a connection between Gainsight PX and Gainsight CS using the PX Connector. For more information on how to establish a connection, refer to the Product Experience (PX) Integration article.

Configure an Adoption Explorer Project

Once the connection is established, you can configure an Adoption Explorer project to ingest the MQS data.

To configure the Multi-Question Survey:

  1. Navigate to Administration > Adoption Explorer.
  2. Click Create Project. The Select Type of Project Setup dialog box appears.
  3. Select Gainsight PX and click Continue. The Project Setup page appears.

    Adoption Explorer modal showing project setup options for Gainsight PX and Standard, with Continue button highlighted
     
  4. In the Project Setup page, enter the following details:
    1. From the Gainsight PX Connection, select the appropriate PX connection pertaining to the Multi-Question Survey.
    2. From the Associate usage data identifier to the Gainsight record ID, map the source fields to Gainsight CS objects.
    3. Click Create Project. A new project in Adoption Explorer is created.

You are redirected to the Object Configuration page.

Project setup screen showing Gainsight PX connection selection and usage data configuration options.

Ingest Custom Data Files from PX

On the Object Configuration page, you can configure data sources to begin ingesting data into Gainsight objects.

For Multi-Question Survey, once the PX connection is established, the following file becomes available:

  • Time Series Files:
    • File PrefixesGainsightPX_MultiQuestion_Survey_Responses_
    • Mapped To: Person Daily Time Series Object.
    • Purpose: Includes User and Account identifiers to analyze daily engagement patterns.

Create Data Source

You need to map the above files to the respective objects for data ingestion. To map fields:

  1. On the Object Configuration page, select the Person Daily Time Series object.
  2. Click Add Source. The Establish Configuration page appears.

    Adoption Explorer object configuration showing Person Information selected with option to add a data source
     
  3. In the Enter Source Name field, enter the source name for identification.
  4. From the Connection Type dropdown list, select the Amazon S3 connection type.
  5. Select Managed by Gainsight PX.
  6. From the PX Custom Files dropdown list, select the file with the prefix GainsightPX_MultiQuestion_Survey_Responses_

    Establish Connection step showing Amazon S3 selected and data managed by Gainsight PX.
     
  7. Click Import Metadata. The Select Identifiers page appears.

Configure Identifiers

On the Identifiers page, you need to map identifiers in Adoption Explorer to objects with identifiers in the source.

  1. From the Person ID dropdown list, select the unique user identifier.
  2. From the External ID dropdown list, select an ID that helps Adoption Explorer identify the field used as Customer Identifier in the current source.
  3. From the Enable aggregation from Daily to Weekly objects dropdown list, select Yes or No.
    Note: Select Yes to roll up Daily time-series to Weekly time-series data.

    Select Identifiers step showing person ID, external ID, and aggregation fields for data mapping.
     
  4. Click Next. The Select Fields page appears.

Select Fields

  1. On the Select Fields page, select the relevant fields from the MQS to be ingested into Adoption Explorer.
  2. Click Next. The Complete Field Settings page appears.

    Select Fields step showing Gainsight PX Knowledge Center fields with identifiers highlighted during data source setup.
     
  3. Click Save to complete the configuration of the Source data.