Gainsight Destination

Gainsight is a customer success software that empowers companies to increase revenue, decrease customer churn, and drive advocacy. Gainsight for Analytics Cloud is the first and only solution that runs predictive data science natively using Salesforce sales, service, marketing, and community data.

This document was last updated on October 18, 2018. If you notice any gaps, outdated information, or simply want to leave some feedback to help us improve our documentation, please let us know!

Getting Started

The first step is to make sure Gainsight supports the source type and connection mode you’ve chosen to implement. You can learn more about what dictates the connection modes we support here.

WebMobileServer
📱 Device-based
☁️ Cloud-based
  1. From your Segment UI’s Destinations page click on “Add Destination”.
  2. Search for Gainsight within the Destinations Catalog and confirm the Source you’d like to connect to.
  3. Copy your Gainsight Access Key and paste it into to the Access Key field in your Segment settings for Gainsight. This key can be generated from the integrations page under the admin area in Gainsight. It should be 36 characters long, for reference. If you need more information, please visit the relevant documentation provided by Gainsight.
  4. Start sending events!

Identify

If you haven’t had a chance to review our spec, please take a look to understand what the Identify method does. An example call would look like this (analytics.js):

analytics.identify('123', {
  accountId: 'o283h08fh2390f923uofu23',
  name: 'Miles Morales',
  email: 'mmorales@midtownhs.edu'
});

You can map identify calls to Salesforce by including the Salesforce Account ID as accountId. Gainsight will handle the rest and collect any additional info you send in your identify calls and attribute them to the correct Account.

Track

Important: You should only send the track events you need to Gainsight. You can whitelist the names of the events you need in your Segment UI settings for Gainsight. Once you pre-map your events, we will only send those events to Gainsight for you. However, if you do not map any events, we will by default send all your track events to Gainsight.

If you haven’t had a chance to review our spec, please take a look to understand what the Track method does. An example call would look like this (analytics.js):

analytics.track('Account Created', {
  accountId: 'o283h08fh2390f923uofu23',
  source: 'Invite',
  title: 'CEO'
});

Mapping your track calls to a Salesforce Account is only necessary if the user doing the event is not already identified or grouped. If the user is identified all their events will be picked up automatically.

If they haven’t been identified, pass the Salesforce Account ID as a property like in the example above.

Group

If you haven’t had a chance to review our spec, please take a look to understand what the Group method does. An example call would look like this (analytics.js):

analytics.group('555', {
  name: 'Twitter',
  url: 'https://twitter.com'
});

To map your group calls to a Salesforce Account, pass the Salesforce Account ID as the groupId, like what you see in the above example.


Personas

You can send computed traits and audiences generated through Segment Personas to this destination as a user property. To learn more about Personas, reach out for a demo.

For user-property destinations, an identify call will be sent to the destination for each user being added and removed. The property name will be the snake_cased version of the audience name you provide with a true/false value. For example, when a user first completes an order in the last 30 days, we will send an identify call with the property order_completed_last_30days: true, and when this user no longer satisfies we will set that value to false.

When the audience is first created an identify call is sent for every user in the audience. Subsequent syncs will only send updates for those users which were added or removed since the last sync.

Supported Sources and Connection Modes

WebMobileServer
📱 Device-based
☁️ Cloud-based

To learn more about about Connection Modes and what dictates which we support, see here.

Settings

Segment lets you change these destination settings via your Segment dashboard without having to touch any code.

Access Key

It should be 36 characters long, and look something like this: 35a84f9e-7084-47a1-b8a5-593444e9e862.

Whitelist Track Events

Whitelist Segment .track() events you’d like to send to Gainsight. By default, if you do not whitelist any events, we will send all .track() events. If you do whitelist any events, we will only send those events through. Put the name of your .track() events here, ie. ‘Order Completed’



Questions? Need help? Contact us!
Can we improve this doc?
Email us: docs-feedback@segment.com!