Skip to main content
Gainsight Inc.

Scorecards 2.0 Module Objects

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

Scorecard Fact Object  

This object is used to store the scores of the measures in the Scorecards 2.0 module. For example; Mass Edit view in Reports, C360/R360.

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

Field Name Description
Company Id Unique Id of an account from the MDA object Company. This field helps to fetch information of an account from the MDA object Company.
Created Date The date on which a Scorecard is created.
Current Score Id Fields from the Scorecard Scheme Definition like Color, Name, Score, etc. can be fetched into this object through this unique Id.
Measure Id Fields from the Scorecard Measures like Name, Nature, etc. can be fetched into this object through this unique Id.
Modified Date The date on which a Score is modified.
Previous Score Id Fields from the Scorecard Scheme Definition like Color, Name, Score, etc. can be fetched into this object through this unique Id.
Score Modified By User who last modified the score.
Scorecard Id Fields from the Scorecard Master like Name, entity type, modified by, etc. can be fetched into this object through this unique Id.
Trend Trend of the score. Up/Down/Same.

Relationship Scorecard History Object  

This object is used to store the historical scores of the measures in the Scorecards 2.0 module. For example; R360 and Habits Reports.

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

Field Name Description
Company Id Unique Id from the MDA object Company from which details about Company will be fetched into this object.
Created By User who created a Scorecard.
Created Date The date on which a Scorecard is created.
Modified By User who last modified the scorecard.
Modified Date The date on which a Scorecard is modified.
Overall Score (Relationship) Overall score of a specific Relationship.
Relationship Id Unique Id from the MDA object Relationship from which details about the Relationship are fetched into this object.

Account Scorecard History Object  

This object is used to store the historical scores of the measures in the Scorecards 2.0 module. For example; C360 and Habits Reports.

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

Field Name Description
Company Id Unique Id from the MDA object Company from which details about Company will be fetched into this object.
Created By User who created a Scorecard.
Created Date The date on which a Scorecard is created.
Modified Date The date on which a Scorecard is modified.
Modified By User who last modified the scorecard.
Overall Score (Account) Overall score of a specific account.

Scorecard Master Object  

This object is used to store all the scorecard in the Scorecards 2.0 module. For example; used in Reporting.

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

Field Name Description
Active Flag that indicates whether a specific scorecard is in use.
Created By User who created a Scorecard.
Created Date The date on which a Scorecard is created.
Entity Type Account/Relationship.
Is Default Flag that indicates whether a specific scorecard is marked as the default among multiple scorecard.
Modified By User who last modified the scorecard.
Modified Date The date on which a Scorecard is modified.
Name Name of the Scorecard.

Scorecard Measures Object  

This object is used to store the measures in the Scorecards 2.0 module. For example; used in Reporting.

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

Field Name Description
Active Flag that indicates whether a specific scorecard is in use.
Created By User who created a Scorecard.
Created Date The date on which a Scorecard is created.
Entity Type Account/Relationship
Input Type Manual/Calculated
Level Type Measure/Group/Rollup (Overall)
Modified By User who last modified the scorecard.
Modified Date The date on which a Scorecard is modified.
Name Name of a Scorecard.

Scoring Scheme Definition Object  

This object is used to store the definition of the scores and scoring bands in the Scorecards 2.0 module. For example; used in Reporting.

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

Field Name Description
Active Flag that indicates whether a scheme definition is in use.
Color Defined for a scheme definition.
Created By User who created a Scorecard.
Created Date The date on which a Scorecard is created.
Deleted Flag that indicates whether a scheme definition is deleted.
Label Range from which the score is extracted (Example: If score is 55, defined Range can be 50-75).
Modified By User who modified a Scorecard.
Modified Date The date on which a Scorecard is modified.
Name Name of a Scorecard.
Range From First value of the Range assigned to a scorecard.
Range To Last value of the Range assigned to a scorecard.
Score Score values.

Company Object

This object is used in Scorecards 2.0, Surveys 2.0, and Journey Orchestrator modules. For example; to tie scorecard 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 scorecard 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 organization. A user is identified as an external user when the user is part of your customer’s organization. To enter external user information into User object, user’s organization 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 scorecard 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.
  • Was this article helpful?