---
title: Salesforce Classic Setup
slug: user-analytics/salesforce-classic-setup
description: Set up Unaric User Analytics for Salesforce Classic to track usage and behavior in the older interface.
createdAt: 2025-10-30T02:25:45.425Z
---

Tracking users using the Salesforce Classic interface requires setting up a **Visualforce sidebar component**. This component will run a **Position Detector** in *Help Cue* mode to record page impressions for licensed users.

## How it works

Once deployed, the sidebar component automatically logs an **interaction record** in the **Help Interaction** object (depending on your *Help Global Settings*).

Each time a permissioned user views a page in Salesforce Classic, an interaction record will be created — allowing accurate user tracking and engagement analytics.

## 1. Create a Visualforce page

1. In Salesforce, navigate to **Setup > Custom Code > Visualforce Pages**.
2. Click **New **to create a new Visualforce page. You can use any name for the page; for example, *UserAnalyticsClassic*. 
3. You need to configure the Visualforce page to load the **Position Detector** component in *Help Cue* mode. To this end, use the following markup, replacing the placeholders in **\[SQUARE BRACKETS]** with your own values:

:::CodeblockTabs
iframe

```html
<apex:page>
  <iframe 
    src="https://[LOCAL VISUALFORCE ROOT HERE]/apex/iahelp__IHLUXOutHost?
    NSApp=iahelp&
    App=appIH&
    NSComp=iahelp&
    Comp=IHPosDetect&
    Parms=PositioningRole~HelpCue^LogContextInteraction~true^PositioningGroup~[YOUR CHOICE OF COMPONENT ID HERE]^HelpRecordId~HelpRec^recordId~{!$CurrentPage.parameters.Id}" 
  />
</apex:page>
```
:::

- **\[LOCAL VISUAL FORCE ROOT] URL:&#x20;**&#x59;ou can find it  by going to **Help Settings** from the app launcher and look for **Remote Site for metadata API access**. It should look something like this: *https\://acme–iahelp.vf.force.com***.**
- **\[YOUR CHOICE OF COMPONENT ID]:&#x20;**&#x49;t can be something report friendly, for exampl&#x65;**&#x20;USER\_TRACKING** (Don’t have spaces or special characters between words).

:::Paragraph{indent="1"}
Using the above examples, your iframe code should look something like this:
:::

:::CodeblockTabs
iframe

```html
<iframe
  src="https://acme–iahelp.vf.force.com/apex/iahelp__IHLUXOutHost?
  NSApp=iahelp&
  App=appIH&
  NSComp=iahelp&
  Comp=IHPosDetect&
  Parms=PositioningRole~HelpCue^LogContextInteraction~true^PositioningGroup~USER_TRACKING^HelpRecordId~HelpRec^recordId~{!$CurrentPage.parameters.Id}"
/>
```
:::

4. Click **Save&#x20;**&#x74;o finish.

## 2. Create a custom Home Page component

Create a new **Custom Home Page Component** in Salesforce Classic with the following settings

- **Type:** *Visualforce Area*&#x20;
- **Column:** *Narrow (Left) Column*&#x20;
- **Visualforce Page:** Select the Visualforce page you created.
- **Height:** *Minimal*&#x20;
- **Options:** Deselect *Show Label* and *Show Scrollbars*

## 3. Add the component to the Home Page layout

Edit the desired **Home Page Layout&#x20;**&#x61;nd add the component created in the previous step. The placement doesn’t affect functionality —however, adding it near the **bottom&#x20;**&#x6F;f the layout is recommended.

The component will log an interaction record in the **Help Interaction** Object (subject t&#x6F;**&#x20;Help Global Settings**) on each page impression, for each permissioned User.

:::hint{type="warning"}
Ensure users have the correct permissions to log interactions:

- Licensed for **Help Analytics**.
- Granted at least the **Helped User** permission.
:::