Skip to main content

Please know that we will cloning this site from August 3rd to August 15th. Any content changes you make will not be saved past that date. Please do not make any updates to the site on August 3rd through the 15th. If you have any questions please contact your site administrator. 

Gainsight Inc.

Find Usage Data Trends

Depending on a customer’s needs and perhaps their lifecycle stage, they may not use all of the features of your product. However, if they aren’t using key features that are likely to ensure their renewal, or if their usage suddenly changes, your CSMs need to know.

This tutorial guides Admins to create a rule which pushes customer usage data into snapshot fields, every week. You can now monitor which features customers are using the most, on a weekly basis.

Create the Rule

  1. Navigate to Administration > Operations > Rules Engine.
  2. Click + RULE.

  1. In the New Rule window:
  1. Select the Bionic Rule Type.

  2. Create the Rule For an Account.

  3. Enter a Rule Name.

  4. (Optional) Enter a Description.

  5. Click NEXT.

The Setup rule window is displayed.

Set up the Rule

  1. Click DATASET TASK.
  2. Enter a Task Name.
  3. Select Salesforce as the Data source.
  4. Select Usage Data as the Source Object.

  1. Drag and drop the fields, shown in the image below, to Show section. To know more creating tasks in Bionic Rules, refer this article.

You can drag and drop additional fields as required. If you do not find any field in your environment, it implies that the custom field is not yet created and you need to create the same. Refer this article, to learn how to create custom fields and custom objects in Salesforce.

  1. Drag and drop the following fields in the Filter section.
  • Week Label (Usage Data)
  • Usage Data Aggregation Level Name (Usage Data)
  • Status (Customer Info)

  1. In the Filters section:
  • Select = and First Day of Previous Week filter, for Week Label field.
  • Select Contains and enter ACCOUNTLEVEL as filter, for Usage Data Aggregation Level Name field.
  • Select = and Active filter, for Status field.

  1. Click SAVE.
  2. Click Setup Action.

Configure the Rule Action

  1. Click +Action and select T1 (or whatever name you entered in Step 2 of the ‘Setting up the Rule’ section). as Source Dataset
  2. Select Load to Usage as the Action Type.

The Load to Usage Action Type is displayed only when you select a field which can store data. To learn more about Action types, refer this article.

  1. Perform the field mappings as shown in the table below. Click ADD CUSTOM FIELD, to add more fields.
T1 field Load to Usage field
Week Label (DATE) Date (DATE)
Stage Name (TEXT) Lifecycle Stage Snapshot (STRING)
Id (ID) Account (ID)
Full/Platform users (DOUBLE) Full Licenses Snapshot (DOUBLE)
Support package sold (PICKLIST) Support & Success Pkg SOLD Snapshot (PICKLIST)
CSM Name (TEXT) CSM Snapshot (TEXT)
Support Package delivered (PICKLIST) Support & Success Pkg delivered Snapshot (PICKLIST)
Renewals and Expansion Ownership (STRING) Renewal & Expansion Ownership Snapshot (STRING)
Status Name (TEXT) Status Snapshot (TEXT)
CSM Team Manager (PICKLIST) CSM Team Manager Snapshot (PICKLIST)
Renewal Date (DATE) Renewal Date Snapshot (DATE)
Owner ID Name (TEXT) SFDC Account Owner Snapshot (TEXT)
Open Support Cases (High Priority) (DOUBLE) Open Support Cases (High Prio) Snapshot (DOUBLE)
Open Support Cases (DOUBLE) Open Support Cases Snapshot (DOUBLE)
Assigned Licenses  (DOUBLE) Assigned License Snapshot  (DOUBLE)
Provisioned Licenses  (DOUBLE) Provisioned Licenses Snapshot (DOUBLE)
Deployment % (PERCENT) Deployment Snapshot (PERCENT)
Users  (DOUBLE) Available Licenses (DOUBLE)



  1. Click SAVE.
  2. You can run the rue now or schedule it to run later.
  • Was this article helpful?