Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents
maxLevel2

...

This document presents an installation and user guide towards a Salesforce Managed packaged app developed and hosted privately on Salesforce.com. If you are interested in Sales Insights in your Salesforce Account, you first have to link your Activate ABM account to your Salesforce Instance.

Authorize Salesforce

  1. Once logged into Activate ABM, go

...

  1. to User Menu under your account on the top right hand side of the page and click Integrations
    • Image Modified
  2. Click the plus icon on the Salesforce tile
    • Image Modified
  3. Choose which Salesforce.com environment you want to

...

  1. integrate with
    • Image Modified
  2. You will be directed to authenticate your

...

  1. SFDC instance with Madison Logic.  You will need to enter your

...

  1. SFDC username and password, and grant permission for Madison Logic to leverage your

...

  1. SFDC data. You must have admin rights in Salesforce in order to integrate it with Activate ABM™. 
    • Image Modified

Manage Integration

  1. Once you have successfully logged in, you will be brought to the Manage Integration Page for Salesforce. Click

...

  1. Sales Insights Setup

...

  1. in the left hand menu. 
    • Image Modified
  2. Choose

...

  1. the SFDC environment you want to integrate Sales Insight with and the Salesforce Organization ID of that instance. Click Save. (More information on finding your Salesforce Organization ID can be found here)
    • Image Modified
  2. The private Madison Logic Salesforce package URL and authorization code can be found once you

...

  1. save the integration setting. 

...

  1. Makes sure to

...

  1. copy the Authentication code and hold onto in for a future step.
    • Image Modified


Package Installation in Salesforce 

...

  1. Log into Salesforce in a new window. Click the link to install the package.

...

  1. Enter the password provided by Madison Logic and then select the group of users or user profiles that the package will be installed for and click the Install button.

    Image Removed

    ...

      • Image Added
    1. Authorize Activate ABM platform to communicate with Salesforce to grant access to Madison Logic
      • Image Modified

    Package Authentication and Listing

    Once installation is successful, the Client's Madison Logic package will require a shared key for further communication with Madison Logic’s Activate ABM Platform

    Enter the provided authentication code in the configuration setting field located on the same page as the package link in Activate ABMUser menu > Integration > Sales Insights Setup

    Image Removed

    Offline Installation


    In some cases, the installation may take more time than expected. In such situations, Salesforce , does the installation offline and sends an email to the user post installation.
    After  After you receive the email confirmation, follow the steps in our offline installation here rather than the below steps to complete authentication.

    1. In the Quick Search field, search for “Custom settings”.
      • Image Removed
    2. Click on Manage link beside “Settings”
      • Image Removed
    3. Click on ‘New’ button and create 3 separate fields with following value as below:

      1. ClientId : <your AABM Client Id>
        • Image Removed
      2. ML Key Updation Time : 2018-11-01 07:45:30 (put in today's time & ensure the format is same as given)
        • Image Removed
      3. ML Shared Key - <your shared key>
        • Image Removed

    These steps would require Salesforce Admin or developer expertise. 

    Package Authentication and Listing

    1. Once the installation is successful, the package will require a shared key for further communication with Madison Logic’s Activate ABM Platform
    2. Enter the authentication code you retrieved from User menu > Integration > Sales Insights Setup
      • Image Added

    Anchor
    Authorization  and Assigning Layouts
    Authorization  and Assigning Layouts
    Adding to Layout

    ...

    1. Go to Setup > Accounts > Layouts
    2. A list of all available layouts will be shown. Click

    ...

    1. Edit next to Account Layout, or whichever custom layout you use to show accounts. 

    ...

    1. Create a new section in the Account Layout
      • On top of the Edit Page Layout page, select

    ...

      • Fields

    ...

      • and then click

    ...

      • Section

    ...

        • Image Added
      • Drag the new section to where you want Madison Logic Sales Insights to appear on the Salesforce page

    ...

    1. Set the Section Properties
      • Section Name = "Madison Logic Sales Insights"
      • Layout = 1-Column

    ...

      • Image Added

    ...

    1. Add Madison Logic Data to the new section
      • Select "Visualforce Pages" on the top, edit control
      • Click "ViewMadisonLogicSalesInsights" and drag in it into the newly created section
        • Image Added

    ...

    1. Format the new section
      • Hover in the new "Madison Logic Sales Insight" section
      • Either double click in the section or select the tool icon on the top right hand side of the section
        • Image Added
      • Madison Logic recommends the following format settings. Feel free to adjust as needed:
        • Width = 100%
        • Height = 600 pixels
        • Show scrollbars

    ...

        • Image Added

    ...

    1. Click "Save" to save changes to the layout
      • Image Added

    Activate ABM Account Analytics Dashboard

    Authorized users can view Activate ABM's Account details on the account detail page under the new section (Madison Logic Sales Insights).

    Image RemovedImage Added

    Syncing Accounts

    Madison Logic uses the website object to sync your targeted accounts with Salesforce. In order to insure that accounts in Salesforce are synced with Madison Logic, please make sure that the website field on the Salesforce Account page is filled in.  


    Anchor
    PackageListing
    PackageListing
    Package Listing

    The Madison Logic installed package can be viewed under the installed packages in Salesforce. After successful installation of the “Madison Logic Sales Insight” package, the Salesforce admin will receive a confirmation email from support@salesforce.com.


    Image RemovedImage Added

    Troubleshooting

    Wrong key - If the Salesforce admin has entered wrong authentication code by mistake, he/she can update the shared key as below:

    1. Go to Set Up > Custom Setting > Settings > Manage
      • Image Removed
    2. Click on the Edit button of ML Shared Key to update the shared key
      • Image Removed

    Connection error Connection Error - If there is any issue with connecting the Activate ABM platform, the following error message will appear:

    Image RemovedImage Added


    No domain mapped errorDomain Mapped Error - If any domain is not available in account's Website field, the following error message will appear. The admin will need to add the domain name in the Website field to see Activate ABM's data.

    Image RemovedImage Added


    No data available error Data Available Error ML Account Data Section will display a No Data Available message if no match is found between the website field for the Salesforce account and the associated domain in Activate ABM for any program you are running.

    Image RemovedImage Added


    Anchor
    uninstall
    uninstall
    Uninstalling Madison Logic Package

    ...