# Setup Guide

This guide will help you set up Gainsight PX as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Gainsight PX.

Connection compatibility

Destination Information
  • Status: Generally Available
  • Supported sources: Android (Java) , Android (Kotlin) , iOS (Obj-C) , iOS (Swift) , Web, Unity, AMP , Cloud, React Native , Flutter, Cordova, Warehouse, Shopify
  • Refer to it as Gainsight PX in the Integrations object.
Connection Modes
Source Cloud mode Device mode Hybrid mode
AMP supported not supported not supported
Android (Java) supported not supported not supported
Android (Kotlin) supported not supported not supported
Cloud supported not supported not supported
Cordova supported not supported not supported
Flutter supported not supported not supported
iOS (Obj-C) supported not supported not supported
iOS (Swift) supported not supported not supported
React Native supported not supported not supported
Shopify supported not supported not supported
Unity supported not supported not supported
Warehouse supported not supported not supported
Web supported supported not supported
Supported Message Types
Source Identify Page Track Screen Group Alias Record AudienceList
Cloud mode
Supported sources supported not supported supported not supported supported not supported not supported not supported
Device mode
Web supported not supported supported not supported supported not supported not supported not supported

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the Gainsight PX native SDK from the https://web-sdk.aptrinsic.com domain.

Based on your website’s content security policy, you might need to allowlist this domain to load the Gainsight PX SDK successfully.

Setup

In your RudderStack dashboard, add a source. Then, from the list of destinations, select Gainsight PX.

Connection settings

Setting Description
Name Assign a name to uniquely identify the destination.
API Key Enter the API key required for using the Gainsight PX REST API.

Generate the key by going to your Gainsight PX dashboard and navigating to Administration > Integrations > Rest API.
Product Tag Key Enter the product tag key by going to Administration > Products in your Gainsight PX dashboard.
User Attribute Mapping Use this setting to map your RudderStack event properties to custom user attributes in Gainsight PX.
Account Attribute Mapping Use this setting to map your RudderStack event properties to custom account attributes in Gainsight PX.
Global Context Mapping Use this setting to map the key-value pairs for the Gainsight PX global context metadata.
Consent management settings Configure the consent management settings for the specified source by choosing the Consent management provider from the dropdown and entering the relevant consent category IDs. See Consent Management in RudderStack for more information on this feature.

Create custom attributes

You can create custom attributes for the User and Account objects in Gainsight PX and map them to your RudderStack event properties.

To create custom properties:

  1. Log in to your Gainsight PX dashboard.
  2. Navigate to Administration > Attributes.
  3. Click the New Attribute button as shown:

You can map these attributes to your event properties in the RudderStack dashboard using these connection settings:

Next steps

FAQ

Where can I find the Gainsight PX product tag key?

  1. Log in to your Gainsight PX dashboard.
  2. Go to Administration > Products. You will see the product tag key listed here:

See the Gainsight PX documentation for more information on the setup.