Skip to main content
Gainsight Inc.

Surveys 2.0 Module Objects

Some of the most important MDA objects used in the Surveys 2.0 module are described here. For more information on other SFDC and MDA Objects used in different modules, refer to Gainsight Object Glossary.

Company Object 

This object is used in Scorecards 2.0, Surveys 2.0, and Journey Orchestrator modules. For example; to tie scorecards built on specific Company record in MDA.

The following table lists the data fields available in this object:

Field Name Description
ARR Used to store the average recurring revenue (ARR) of the customer.
Company Id Unique GSID of the Company, this Relationship is associated with.
CSM CSM information of the Relationship record. This field has a lookup to the User object. Values in this field are populated using derived mappings in the data ingestion channel.
Current Score Health score of a customer. This is overall health score of the current scorecard for a company.
Lifetime in Months The number of months from the original contract date.
MRR Current Monthly Recurring Revenue (MRR) of the Customer, net of all transactions to-date.
Name Used to store the name of a Relationship.
NPS Used to store the Net Promoter Score (NPS) of the Customer. This field cannot be editable.
Onetime Revenue Onetime Revenue of the Relationship.
Original Contract Date Original Contract Date of a Relationship (Customer acquisition date based on the first transaction (New Business)).
Previous Score Previous Health Score of a Customer.
Scorecard Id Fields from the Scorecard Master like Name, entity type, modified by, etc. can be fetched into this object through this unique Id. This field mentions from which scorecard the score is being fetched. This is the active scorecard id for the respective Relationship, there can be multiple scorecards in the system, but only one can be active at a time.
SFDCRelationship Id Equivalent unique Id from SFDC object Relationship.
Stage Stage of the Customer. Customer Stage is a configurable attribute that provides additional information on the customer journey/status. The default values of this field include New Customer, Kicked Off, Launched, Adopting, Will Churn, Churn.
Status Describes if the customer is Active or Inactive. The default values for this field include Active, Inactive, and Churn.
Trend Trend of a score. Up/Down/Same. This field is not editable and shows the difference between previous score and current score.
Type Id A unique Id from Relationship Type object.

User (MDA)

This object is used in Scorecards 2.0, Surveys 2.0, Journey Orchestrator, Timeline, and Dashboard Builder modules. For example; to store information about users in Gainsight

The following table lists the data fields available in this object:

Field Name Description
Company ID It is of datatype GSID. This has a lookup to Company object.
Created Date It is of datatype DateTime. Indicates when the record was created.
Email It is of datatype Email. Stores the Email address of the user.
External ID It is of datatype String. A unique account identifier in an external system. It identifies an account uniquely apart from Email and Name.
First Name It is of datatype String. It stores first name of a user.
Gainsight License Enabled It is of datatype Boolean (True/False). It indicates whether a Gainsight License is assigned to this SFDC User or not.
GSID GSID of a user record. For example: CSM in a Relationship or Company has a look up to this record in User object.
Is Active It is of datatype Boolean (True/False). It indicates whether a user is active in SFDC or not.
Is Active User It is of datatype Boolean (True/False). It indicates whether a user is enabled in Administration > User Management page or not.
Last Name It is of datatype String. It store the last name of a user.
Modified Date It is of datatype DateTime. Displays the date when the record was last modified.
Name It is of datatype String. It store the name of a user.
SFDC User Id It is of datatype SFDC ID. It stores the equivalent User Id of a user in SFDC.
Username It is of datatype Email. Stores username of a User. Username is unique in Gainsight and is used as a key to identify a user in Gainsight.
Manager It is of data type GSID. This field helps Admins to create User - Manager hierarchies, ‘My team’, and ‘Portfolio view’ reports.
Timezone It stores the Timezone of a user’s location. Admins can ingest a user’s timezone value from the User Management page > Manual page and through Rules Engine (Load to User Action).
Is Super Admin This field is of data type Boolean (True/False). It indicates whether a user is identified as Super Admin who has superior permissions on Dashboards and Dashboard Folders.
System Type It is of datatype Dropdown list to choose either Internal or External. A user is identified as an internal user when the user is part of your organisation. A user is identified as an external user when the user is part of your customer’s organisation. To enter external user information into User object, user’s organisation should have a record in the MDA object Company.

Relationship (MDA) Object 

This object is used in Scorecards 2.0, Surveys 2.0, and Journey Orchestrator modules. For example; to store information about Relationships context in Gainsight.

The following table lists the data fields available in this object:

Field Name Description
ARR Used to store the average recurring revenue (ARR) of the customer.
Billing Address Used to store the billing address of the customer.
Company Type Used to store the type of company.
CSM CSM information of the Company record. This field has a lookup to the User object. Values in this field are populated using derived mappings in the data ingestion channel.
Current Score Health score of a customer. This is overall health score of the current scorecard for a company.
Customer Lifetime in Months The number of months from the original contract date.
Employees The number of Employees in the Company.
Industry Industry of the company belongs to, ex: Software, Networking, Automobile, etc.
Lifecycle in weeks Lifetime of a customer in weeks.
MRR Current Monthly Recurring Revenue (MRR) of the Customer, net of all transactions to-date.
Name Used to store the name of the company.
NPS Used to store the Net Promoter Score (NPS) of the Customer. This field cannot be editable.
Original Contract Date Original Contract Date of the customer (Customer acquisition date based on the first transaction (New Business)).
Parent Company Parent company of the customer. This field has a lookup to self object Company. This field is populated using derived mappings in the data ingestion channel.
Previous Score Previous Health Score of a Customer.
Renewal Date Next Renewal Date of the customer.
Scorecard Id Fields from the Scorecard Master like Name, entity type, modified by, etc. can be fetched into this object through this unique Id. This field mentions from which scorecard the score is being fetched. This is the active scorecard id for the respective company; there can be multiple scorecards in the system, but only one can be active at a time.

Relationship Type (MDA) Object 

This object is used in Scorecards 2.0, Surveys 2.0, and Journey Orchestrator modules. 

The following table lists the data fields available in this object:

Field Name Description
Name Name of a Relationship.
SFDC Relationship Type Id A unique Id of a Relationship Type in SFDC.

Survey User Answer Object 

This object is used to store information about answers responded to Survey questions in the Surveys 2.0 module.

The following table lists the data fields available in this object:

Field Name Description
Answer Id Unique Id of a Survey answer from the Survey User Answer object. Id of an each allowed answer.
Answer Rank Sequence Number of an answer for Ranking question.
Answer Text To store Comment of an answer.
Participant Id Unique Id of a Participant from Survey Participant object.
Question Id Unique Id of a Question from Survey Question object.
Responded Date DateTime when an answer was responded.
Survey Id Unique Id of a Survey from Survey View object.

Survey Translation Object 

This object is used to store information about translation of survey data when a survey is multilingual in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Answer Id Unique Id of a Survey answer from Survey User Answer object. Id of an each allowed answer.
Category Category of a survey that is translated: Static Text/Survey/Question/Library Question/Allowed Answer.
Code A simple unique identifier of a Static Text.
Language Id A unique Id of a Language that is created by Admin.
Library Question Id A unique Id from Library Question object.
Survey Id A unique Id from Survey View object.
Survey Question Id A unique Id from Survey Question object.

Survey Question Library Object 

This object is used to store information of reusable questions that can be used in multiple surveys in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Active Flag that indicates whether a library question is Active or not. You can use only use Active questions. 
Allow Comment Flag that indicates whether a library question allows to insert comments or not. 
Comment Label Label of a comment box that displays before you add any comment in the comment box.
Display Order Display order of the library questions while configuring a survey.
Reporting Label Label of a library question in Reporting on any flattening object.
Selector To store different kind of options to select either a single select or multi select items, Ex: Radio/Multi select checkbox/Single Select Checkbox.
Title To store title of a Library question.
Type To store the type of a Question: Single select/Multi select/NPS.
Folder Id A unique Id of a Folder from Survey Folder object in which a library question is stored.

Survey Page Object 

This object is used to store information about Survey pages in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Display Order Display order of Survey pages.
Title Stores title of a Survey page.

 

Survey Question Object 

This object is used to store information of a survey question that is used in a Survey in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Active Flag that indicates whether a question is Active or not. You can use only use Active questions. 
Allow Comment (Boolean) Flag that indicates whether a question allows to insert comments or not. 
Comment Label Label of a comment box that displays before you add any comment in the comment box.
Display Order Display order of the questions while configuring a survey.
Page Id A unique Id of a Page where a specific question is used.
Reporting Label Label of a question in Reporting on any flattening object.
Select to To store different kind of options to select either a single select or multi select items, Ex: Radio/Multi select checkbox/Single Select Checkbox.
Survey Id A unique Id from Survey View object.
Title To store title of a Survey Question.
Type To store the type of a Question: Single select/Multi select/NPS.

Survey Folder Object 

This object is used to store information of a Survey folder that is used to store multiple library questions in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Name Name of the Survey Folder that stores few library questions

Survey View Object 

This object is used to store information of each Survey in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Allow Internal Submission (Boolean) Flag that indicates whether a survey allows Internal Submission (internal employee to respond to a Survey on behalf of another user).
Category To store category of a Survey Anonymous/non-anonymous/partial anonymous.
Code A simple unique code to identify a survey.
Description Description to a Survey. Displayed as Header in the Survey Page.
End Date Survey Expire date (Date by which a participant has to respond to a Survey).
Entity Type Company/Relationship
Last Response Tracked At To store DateTime when a Survey has been responded last time.
Link Expiry Days To store the number of days that a Survey link is active (after which the survey expires).
Name Name is mandatory. It appears to the end user when you do not assign a Title to a Survey.
NPS Survey (Boolean) Flag that indicates whether a Survey is of type NPS. It is true if a Survey has NPS question.
Owner Id A unique Id of owner who created the survey.
Partial Submit Days The number of days after which a survey that has been partially saved is responded as partially submitted.
Published Date Date on which the survey is published to send across.
Published URL Site URL of a Survey.
Question Count The number of Questions in a Survey.
Relationship Type Id A unique Id of a Relationship Id.
Start Date The date by when you can publish a Survey. Unless a Survey is published, you cannot send it across from any distribution channel.
Status of a Survey: Design/Published/Closed (Expired).
Title Display Name in UI and it is shown as Survey Title in the end user Response page.
Type of a Survey: Transactional (A survey that is sent on a specific context)/Non-Transactional.

NPS Survey Response Object 

This object is used to store information about an NPS Survey and its Response in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Company Id A unique Id from the Company object that a survey is associated with.
Company Person Id A unique Id from the Company Person object, details of a participant associated with a Company.
Email Email Id of the participant which is fetched from Survey Participant object.
Language Id Details of a language in which an end user has responded.
Name Participant Name.
NPS Score NPS Score of a Survey.
Participant Id A unique Id of a Participant fetched from the Survey Participant object.
Person Id A unique Id from Person object.
Relationship Id A unique Id from the Relationship object that a Survey is associated with.
Relationship Person Id A unique Id from the Relationship Person object, details of a participant associated with a Relationship.
Responded Date The date on which an NPS Survey is responded.
Score Type Score type of an NPS survey: Promoter/Detractor/Passive.
Sentiment Sentiment is stored from the analytics on the Survey comments.
Survey Id A unique Id from the Survey view object that helps fetch Survey details.

Survey Allowed Answer Object 

This object is used to store information about the number of answers supported for any Survey (for an NPS Survey, the number of allowed answers is 11 (0 to 10)) in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Answer Score Score assigned to each answer.
Display Order The display order of the answers that are displayed in a Survey.
Other Option (Boolean) Flag that indicates whether a Survey question has other option (true/false).
Survey Id A unique Id from the Survey view object that helps fetch Survey details.
Survey Question Id A unique Id from the Survey Question object that helps fetch Survey question details.
Title The title of the answers.

Survey Text Analytics Object 

This object is used to store information about analytics applied on the Survey comments in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
Aspect System dynamically analyses the Survey comments and provides a random Aspect (Ex: If system identifies a word ‘Cockpit’ in the survey comment, the Aspect can be ‘Cockpit’.
Aspect Group Logical groups of Aspects. Ex. the Aspects “business partner” and “business need” would be grouped together under the "business" Aspect group as this is a logical way of categorizing them together.
Company Id A unique Id from the Company object that fetches details of a Company.
NPS Response Id A unique Id from the NPS Survey Response object that fetches details about NPS Survey.
Run Date The date on which Analytics applied on the Survey comments.
Sentence It stores each Sentence in a Survey comment.
Sentence Category It stores either Positive, Negative, or any suggestions that system dynamically categorizes.
Survey Id A unique Id of a Survey that helps fetch details of a Survey.
Survey User Answer Id A unique Id from Survey User Answer object that fetches details of a Survey answer from each user.
Participant Id A unique Id of a participant fetched from Survey Participant object and helps fetch details of a participant.

Survey Participant Object 

This object is used to store details of Survey Participants in the Surveys 2.0 module. 

The following table lists the data fields available in this object:

Field Name Description
AO Participant Id A unique Id of a participant from AO Participants object if the survey is sent from Journey Orchestrator.
Company Id A unique Id from the Company object that fetches details of a company, a survey is associated with.
Distribution Channel A channel from which a survey is distributed: AO (Program)/Email Assist/any anonymous channel.
Email Email Id of a participant.
External Id of a participant when the participant details are fetched from. Salesforce Id of participant when surveys are migrated from 1.0 to 2.0.
External Source External source of Participant when surveys are migrated: It can be either Salesforce or SurveyMonkey.
First Name The first name of a participant.
Full Name The full name of a participant.
Internal Question Submission Date When a survey is responded internally by another person (Ex: CSM) as a survey response to end user’s survey submission. The date on which an internal question is submitted.
Internal Question submitted (Boolean) Flag that indicates whether an internal question is submitted or not. (true/false)
Internal Question Submitted By It stores the user details who submitted the internal question. This field fetches details from the User object.
Language Id A unique Id of Language in which a participant has responded in.
Last Name The last name of a participant.
Last Response Record Time A datetime on which a participant has responded to a Survey.
Person Id A unique Id from Person object that this participant is tied to. This field fetches details from the Person details of this participant.
Relationship Id A unique Id from Relationship object that this participant is associated with. This field helps fetch details from the Relationship object.
Responded (Boolean) Flag that indicates whether a participant has responded to a specific Survey or not.
Responded By User details of a person who has responded to a Survey on behalf of a participant. This field fetches details from the User object through Lookup (internal Submission).
Responded Date The date on which a participant has responded to a specific Survey.
Response Status Partially saved/Partially submitted/Submitted.
Survey Id A unique Id of a Survey from the Survey View object that helps fetches details of a specific Survey.
Survey Opened Date The date on which a participant has opened a Survey.
Survey Sent Date The date on which a Survey is distributed to the participants.
Survey Opened (Boolean) Flag that indicates whether a Survey is opened by a participant or not.
Test Participant (Boolean) Flag that indicates whether a Survey sent to a participant is Test Participant.
Token A unique identifier from which a Survey is distributed from.
  • Was this article helpful?