Insight & Predict Setup for Motivate

This page goes through how to set up and configure the Prediction functionality that is available in Opportunity Insights, as well as how to deploy Insight & Predict in your Salesforce org.

For further information on how to use and manage Opportunity Insight, please refer to the Opportunity Insight Training page.

Enabling Insights

Insight generation will be enabled by default on new installations of version 8; therefore, users can skip to the Define Winning Way step below. However, if you have upgraded from v7 to v8, Insight generation will need to be enabled so that Opportunity Insight uses Insight records instead of Reward records. To enable Insight generation, please follow the steps below:

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Installed Packages
3. Click on Configure next to the Motivate package name
4. On the Application Configuration page, click on the Insight & Predict section
5. Under Insight Migration, click the Run button

Define the Winning Way

The first step in configuring Insight & Predict is to define the Winning Way, which needs to be created for each Opportunity Record Type that you intend to use the Prediction capability on. A Winning Way record is linked to an Opportunity Record Type, and within each Winning Way are a number of Winning Way Steps. Each Winning Way Step relates to a specific Sales Stage in the Sales Process and, for each Winning Way Step, a Behaviour Template must be defined that contains the Behaviours that are to be completed for that Winning Way Step (i.e. Sales Stage).

1. Go to the Winning Ways tab
2. Click New to create a new Winning Way (one is required for each Opportunity Record Type that is to include the Prediction capability)
3. Enter a name in the Winning Way Name field, e.g. "Default" for the default opportunity record type
4. Enter Opportunity in the Object API Name field
5. Leave the Status Field as StageName

6. Enter the Record Type ID of the required Opportunity Record Type (either the 15- or 18-character value)
   
   Note:

   If required, a Winning Way can be set up which will be utilised for any Sales Processes that don't match any defined Winning Ways, by leaving the Record Type ID field blank. An example where this could be used would be when multiple Opportunity record types are used within a single sales process (which has been defined programmatically).
   
   Also, if the org has only one sales process, the Record Type ID field could be left blank for convenience. Then, if any new Sales Processes are subsequently added, for which different Winning Ways are required, the Record Type ID would then need to be added.

7. Click Save

   Prior to performing the following steps, it is recommended that you create a Behaviour Template for each step in the sales process. These Behaviour Templates should in turn be populated with the Behaviours that are required to drive a successful opportunity to closure. Completing these behaviours at each stage of the process will be an important factor in determining an outcome prediction.

8. Click the New Winning Way Step button in the Winning Way Steps related list
9. Enter the first Stage as required, e.g. Prospecting (the name must be an exact match to the stage name)
10. Use the Behaviour Template lookup to select which Behaviour Template you'd like to use for the individual sales stage being defined within the Winning Way.
11. Click Save & New, and continue setting up a Winning Way Step for each of the Sales Stages as required.

For example, if Salesforce's default opportunity record type sales stages are being configured, the following Winning Way Steps will need to be defined:

Opportunity Insight Page - Lightning

The standard installation includes an Insights tab deployable in the Classic Salesforce UI. A native Lightning Experience tab can also be created for use in Lightning applications. If you are setting up a native Lightning Insights Tab (as described below), you should either hide the Classic UI version of this tab (from Lightning Experience users) or give the Lightning Experience tab a unique name to differentiate it.

1. Click on the Setup button at the top of the screen and then click on the Setup link
2. Within the sidebar under Platform Tools | User Interface click on Tabs
3. Under Lightning Page Tabs, click on the New button
4. In the Lightning Pages picklist, select Opportunity Insight [success__Insight]
5. For the Tab Label and Tab Name fields, enter Insights or a unique name if the Classic version of the page is in use
6. For the Tab Style, choose Lightning from the lookup and then click the Next button
7. Assign the Lightning Page Tab to all of the Profiles that require access
8. Click the Save button to complete the task and to create the Lightning Page Tab
9. Within the sidebar under Platform Tools | Apps click on Lighting App Builder
10. Click on View next to Opportunity Insight, and then click on the Activation button
11. In the Activation modal under the Lightning Experience tab, select the Sales Lightning App in the left column, and then click on the Add page to app button to add the Performance Centre page to the right column 
12. In the right column, drag and drop the Insights page to the desired position that it will be displayed on the Tab bar
    
13. If the Insights page should be accessible in Salesforce1, click on the Salesforce1 tab and then click on the Add page to app button
14. Repeat steps 12 and 13 for all other Lightning Apps that require access to the Insight page
15. Click the Save button to return to the Lightning App Builder
16. Click the Back button to complete the task and finish configuring the Performance Centre page

Opportunity Record Page - Lightning

This section contains describes how to configure a Lighting Opportunity record page to include Insight & Predict information in line with the opportunity information already displayed on the page. The configured page can then either be assigned as the default record page (visible in apps that don't have another custom record page assigned), or be assigned to specific apps.

1. To begin with the current default page layout, open an existing Opportunity
2. From the Salesforce setup icon at the top right, select Edit Page
3. Decide where on the page you would like to add the Insight Detail component, the following instructions describe placing it in our recommended position
4. Hover over the Tabs section - with Activity, Chatter and Details - until the blue dot becomes a plus sign and click to select this location
   
5. Click on the Insight Detail component in the Lightning Components list on the left, in the "Custom - Managed" section. This will add the component to that position.
6. In the right-hand column, you'll see 7 different items that can be displayed or hidden on the Insight Detail section of the Opportunity page layout:
   • Show Behaviours by Type Chart
   • Show Behaviour by User Chart
   • Show Behaviours by Value over Time Chart
   • Show Charts
   • Show Related Tables - i.e. the Rewards and Behaviours tables
   • Show KPI Cards
   • Show Prediction
7. Uncheck any of the sub-sections that are not required for display within the page, e.g. the "Show Related Tables" (the list of Reward earned and Behaviours required) and "Show KPI Cards" as shown in the screenshot below
8. Click Save
   
   
9. To Activate this page to make it visible to your users straight away, click Activate on the resulting popover
10. In the next popover, Activation for Opportunity Record Page, select the required option, e.g. "Assign this page to specific apps" to assign it to the Sales App.
11. Click Next and then Save

Opportunity Record Page - Classic

The following steps are optional and only required if the Opportunity Prediction component should be visible to users when they view Opportunity record pages in Salesforce Classic. The Opportunity Prediction component is also displayed on the Insights tab which can be limited to a subset of users, e.g. Sales Operations and Sales Management, if required. It is, therefore, not necessary to also place this component into the opportunity details page viewed by all users unless that is specifically required.

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Customize | Opportunities | Page Layouts
3. Click Edit beside the Opportunity Layout page layout on which you wish the Prediction to appear
4. Add a new section to the page named Prediction. The Prediction section can be placed anywhere you wish; our suggestion is to place it immediately below the Opportunity Informationsection
5. Leave the Detail Page and Edit Page checkboxes selected in the Section Properties
6. Click 1-Column in the Layout section
   
7. Click OK
8. In the Opportunity Layout section at the top of the page, click on Visualforce Pages:
   
9. Drag the Opportunity Prediction element and drop it into the new Prediction section.
   
10. Hover the cursor over the Opportunity Prediction element and click the Properties "wrench" icon that appears in the top-right corner
11. In the resulting pop-up window, set the Height (in pixels) field to 80
    
    
12. Click OK
13. Click the Save button to complete the task and save your changes to the page layout