Troubleshooting Gainsight PX Installation

Updated 1 month ago by Kiran Devathi

1) How does Gainsight PX track and identify elements?

Gainsight PX tracks any CSS selector in combination with a URL to identify elements which include Button/Link Clicks, Text Match on elements and all other activities on your web application via Custom Events. For more information on how to work on CSS selector, refer to Advanced Instrumentation article.

2) Does PX Tag track every single data on our Webapp?

No. Gainsight PX tag only captures the following:

DOM Element

Captured

ID

Value

Class

Value

A (href)

Value

Button

Name, value and type

Img

Src, alt

Select (dropdown)

Name

Input

Name, Type (NOT the value)

Textarea

Name

Custom

You can configure the SDK to capture any data element via Account Settings -> SDK Settings

3) What are CSP whitelist URLs to put in our website headers to allow specific traffic to Gainsight sites?

Csp : *.aptrinsic.com

4) Do developers need to do identify calls multiple times for each user session? OR Is it once?

No. You just need to make one call until the user gets successfully authorized in your web app. Once authorization is successful, it establishes a PX user session to track events.

You can make multiple identify calls as per your wish, but it is not required.

5) Are there any recommendations to make OUR application work best with Gainsight PX?

The majority of new web-apps are Single-page application (SPA) which leverage either React, Angular, or VUE. So, PX uses React and CS uses Angular. Additionally, putting IDs of the meaningful elements that the team wants to map as features is recommended.

6) How many user accounts do we get?

The contract charges are based on your MAUs not based on the internal users of your company.

7) With the tokens that need to be placed to grab the information- Do they need to be entered in the User tab as well as the Account tab (in Attributes)?

To know how to code Identify call in your application, refer The Configuration Checklist - Standard (Step 3) article.

8) How does PX Data flow into CS?

Refer Gainsight PX Connector article to know how data flows from PX connector in Gainsight application.

9) Does User ID token needs to be unique across all users? Is this for all accounts or just the account the user ID, it is associated with the customer?

PX requires a unique user id for all of the users to track/ associate the events in the web application to "who". In addition to user tracking, PX also provides tracking at an account level for which you need to provide a unique Account id, if you wanted to track at the account level and want to associate multiple users to one account. For example, the way Gainsight PX tracks you is:

  • User > Jessica > Unique User id1234
  • User > Mark > Unique User Id: 2345
  • Account > New Innovations > Account ID9876 > 2 users 1234 and 2345

10) Do we need to create a custom attribute in Gainsight PX before a team can use it in the javascript snippet or can teams add the attributes they need to the snippet and then PX is able to backfill these values once they are created in the dashboard?

Any attribute which is not part of the standard list of attributes is available in PX at an account or user level. To achieve this, first needs to be added in PX and then sent via the javascript snippet. For more information, refer Track your Users and Accounts article.

11) Is there a way to exclude internal traffic from the analytics view?

Yes. You can exclude specific users from tracking. For more information, refer Exclude Specific Users from Tracking article.

12) If a user has an AdBlocker ON, can we still track and deliver engagements?

Yes, we can track. We are not on any blacklist. Also, we have a proxy solution which means all traffic would come from their domain name. If they explicitly set aptrinsic as blocked, then they need to whitelist the *.aptrinsic.com domain.

13) Can we track our website in PX? If yes, how does it work?

There is no charge for this functionality. Here's how it works:

  • Adding the Website tracking code (the “-1” key), tracks the anonymous usage and that usage will be stored/maintained on PX database.
  • That anonymous user/data won’t be exposed to PX UI anywhere until that user fills out a form on the website in which case a lead will be created on PX and exposed on PX UI with all of the previous usage data.


How did we do?