emptyStringNOTE: This content is not relevant for customers that use the LiveEngage platform.

With custom variables, you can present important, business-specific data that will help your online Agents in selling and servicing your customers. You can choose to display this data for each visitor or only for visitors who request a call. Any web-accessible information from your Web Site or databases can be used as a tracking variable. For example user login, shopping cart value, and marketing campaign data.


You can pass information from existing custom variables or to set new custom variables through the LivePerson Button Code and Monitor Tag.

To implement custom variables:

  1. Log in to your LivePerson Admin Console.
  2. In the left navigation bar, click Account Set Up>> Page Code Builder. The Page Code Builder page appears.
  3. In the Page Code Builder, select the Design, Display, and Invitation options in the Get Your Button Code Area.


  4. After you have selected the Design, Display and Invitation options, in the Get Your Monitor Code area, click Advanced. The Add Routing Options window appears.


  5. In the Add Routing Options window, enter the required information in the Add Tracking Variables area.
    In the name field, enter the name of the existing or new custom variable.
    In the Value field, enter the value of the variable
    In the Scope dropdown list, you may choose one of three scopes:

    Visitor Scope: This scope sets a unique variable per visitor. The variable is saved in the visitor's cookie and remains set until the visitor clears their cookies, for example: Name, Email Address, Phone Number.
    Session Scope: This scope sets a unique variable for the visitor's browsing session, the variable follows the visitor throughout the entire session and is cleared automatically when the session ends, for example: Visitor Profile

    Page Scope: This scope sets a unique variable only for the page the visitor is browsing. When leaving the page, the variable can get a new value if set in the code, for example: Skill

  6. After selecting the scope, click Add New to add additional variables
    Click Applyto apply the new variables. The Add Routing Options dialog appears. The code is updated in the Get Your Monitor Code area.


  7. In the Get Your Monitor Code, click the Copy HTML Code button and add the code to the required site.
<!-- BEGIN LivePerson Monitor. -->
<script language='javascript'> var lpMTagConfig = {'lpServer' : "base.liveperson.net",'lpNumber' : "5296924",'lpProtocol' : "https"}; function lpAddMonitorTag(src){if(typeof(src)=='undefined'||typeof(src)=='object'){src=lpMTagConfig.lpMTagSrc?lpMTagConfig.lpMTagSrc:'/hcp/html/mTag.js';}if(src.indexOf('http')!=0){src=lpMTagConfig.lpProtocol+"://"+lpMTagConfig.lpServer+src+'?site='+lpMTagConfig.lpNumber;}else{if(src.indexOf('site=')<0){if(src.indexOf('?')<0)src=src+'?';else src=src+'&';src=src+'site='+lpMTagConfig.lpNumber;}};var s=document.createElement('scriptraSingleQuote);s.setAttribute('type','text/
('head').item(0).appendChild(s);} if (window.attachEvent) window.attachEvent('onload',lpAddMonitorTag); else window.addEventListener("load",lpAddMonitorTag,false);</script>
<!-- END LivePerson Monitor. ->
<!- BEGIN Monitor Tracking Variables ->
<script language="JavaScript1.2">
if (typeof(lpMTagConfig.sessionVar) == "undefined"){ lpMTagConfig.sessionVar = new Array();}
lpMTagConfig.sessionVar[lpMTagConfig.sessionVar.length] = 'skill=Support';
lpMTagConfig.sessionVar[lpMTagConfig.sessionVar.length] ='visitor_profile=support';
<!- End Monitor Tracking Variables -->