Skip to main content
Gainsight Inc.

PX-CS Survey Configuration

ATTENTION: Documentation Updates are in Process
We are in the process of updating the screenshots, GIFs, and content to match the latest UX based on the Horizon Experience’s new look and feel. To learn more about the Horizon Experience in Gainsight PX, click here.

This article explains how to configure your CS tenant to receive and store Gainsight PX Survey data.  

Overview

Gainsight PX customers who have purchased Gainsight’s CS subscription, need to sync PX survey data to Gainsight CS. This sync helps them use PX survey data in various Gainsight CS modules. For instance, when a customer has responded with a negative NPS® score, a CTA can be created to discuss the issues the customer is facing.   

When you sync PX survey data to Gainsight CS, you must perform a few configurations in the CS Data management module (create object and fields), to ensure that the data is synced accurately. This article explains those configurations. Once the Data management configurations are performed, you must create a rule to fetch data from the CS S3 bucket and load the data to the newly created object. 

Prerequisites

Ensure that you have configured the following items: 

  • S3 Integration is configured in the required PX instance so that it can export data to the CS S3 bucket.

  • Obtain the PX credentials of the PX instance from which you wish to sync data. 

  • You must know the location of the Unique Identifier (UID) in Gainsight CS and PX.

  • You must have the Gainsight CS Org ID for the target org. 

  • Identify the field in the Company object that has a UID, which can be used to map with PX UID.

Setup Data Management

This section explains how to create a custom object and custom fields in the Gainsight CS Data Management module.

Create Object

This sub-section explains how to create a custom object. This object is used to store PX Survey data. We recommend that you refer to the Gainsight Data Management article and then proceed with this section. 

To create an Object: 

  1. Log in to Gainsight CS.

  2. Navigate to Administration > Operations > Data Management

  3. Click + OBJECT. The Create Object window is displayed.

  4. Enter the following details:

    1. Enter a name for the object in the Object display name field. 

    2. (Optional) Enter a description of the object in the Object description field. 

    3. Select the Low Volume Object checkbox. For more information about low volume objects, refer to the Low Volume Custom Objects article.

    4. Click NEXT.

T12.GIF

Create Fields

This sub-section explains how to create Fields in the Gainsight data management module. We recommend that you refer to the Add Custom fields in an Object section of the Gainsight Data Management module. You must create a field that has a UID.

To create custom fields:

  1. Enter a name in the Display name field.

  2. Select String from the Data type drop-down menu.   

  3. Select the Enable lookup checkbox. 

  4. Create a lookup relationship to the object which has the PX Account ID. Join this field to the Company object or other object, based on the settings configured in Adoption Explorer. 

  5. Select the Add another checkbox. 

  6. Click ADD.

t123.GIF

Similarly, create the following fields with the given data types:

Field Name

Data type

Lookup Required?

Survey Date

Date

No

User ID

String

Yes. Create a lookup relationship to the object which has the PX Identify ID. Join to Company Person or Person object, based on the Adoption Explorer setup.

Comment

String

No

Score

Number

No

Allow Contact

Boolean

No

Survey Name

String

No

Create Rule

This section explains how to create a rule that fetches data from the CS S3 bucket and loads it the newly created custom object. We recommend that you refer to the S3 Dataset task in Rules Engine article and then proceed with this article. 

To create a rule:

  1. Navigate to Administration > Operations > Rules Engine.

  2. Click + RULE.

  3. Enter a name in the Rule Name field.

  4. Click NEXT.

T1.GIF

Create S3 Dataset

  1. Click S3 DATASET TASK.

  2. Select the S3 bucket in which PX Survey data resides.

Configure the S3 Dataset to fetch data from the CS S3 bucket. Refer to the S3 File Configuration section of the S3 Dataset task article for more details.

 

NPS, Net Promoter, and Net Promoter Score are registered trademarks of Satmetrix Systems, Inc., Bain & Company and Fred Reichheld

 

  • Was this article helpful?