Skip to main content
Gainsight Inc.

Product Mapper FAQs

This article addresses some of the frequently asked questions in Product Mapper.

How to ensure element selectors configured in Gainsight are resilient against UI changes?

An example use case for the question: 

  • Main menu - the tool identifies selector as nth-child(2) = this will cause the tracking to fail if we add another menu before this
  • Safer would be using a combination of element name/id attributes. Any option to configure the tool to prefer a selector or have to provide it manually?

Answer:

Our product prefers a unique selector on the page being used in the following order of preference:

  • Element ID
  • Class
  • Element tag name
  • Href for an element from type a
  • Nth-child
  • A selector with id if it is available. 
  • Unique elements of attributes that can be added to the SDK settings (Administration > SDK Settings > DOM Elements) so that the selector detector uses the elements.
Pages with unique URLs to a test? Can I use a * in the middle of a URL and at the end?

Yes, it works.

Is a search box trackable?

Yes, using Custom Events. You need a developer to help you with this, it is the third option of tracking mentioned in the following:

  1. Tag UI element: clicks, buttons, etc
  2. URL: Link clicks, page views, etc
  3. Custom Events for tracking specific flows: For more information, refer to the Custom Event API article from the Additional Resources section.
  4. Are radio buttons trackable?

Yes, radio buttons are trackable using Tag UI Elements.

How do you tag/track a model?

You need to have a CSS Selector inside a Model. Selector becomes more robust with the help of class.

If I don’t name the modules/features with a more robust naming convention, will the customer success team see how they are nested in Gainsight CS? I do anticipate the CS team looking at an individual level.

CS has a productized connector that they are using to pull PX Usage data and currently it is available at a Feature level. If they want it at a Module Level, they can aggregate it within CS using a couple of rules.

Gainsight PX recommends the following options:

  • In PX, build your Product Tree and Hierarchy as needed [some work needed by the engineering team to send the modules and features]
  • In CS, use filters to get at the data you need.
Can we get historical matches if a feature is created after a few months?

Yes, using the backfill feature. This feature helps you fill in all usage data from the date of the PX tag installation in your product.

Additional Resources

Custom Event API

 

  • Was this article helpful?