Support Center

Integration Quick-Start

Last Updated: Dec 17, 2012 06:13PM MST

Integrating purlHub personalization on your landing pages is simple, requires nothing to install server side, and can be completed in less than 10 minutes with these 4 steps:

  1. Setup a purlHub campaign service token with your access and permissions.
  2. Include the purlHub base library (our middleware, or JSAPI).
  3. Configure purlService initialization options.
  4. Flag or tag your page for personalization.

First, (1) set up your token with its access rules and permissions.  Log in to your account portal and goto the "API access & Security" tab of your campaign.  A default token is created each time a campaign is created, but its access is limited to offline mode only (local.files).  You'll want to add a rule for your website, allowing at a minimum Read-Only access.  Make a note of the token, you'll use that value later.

Next, (2) including the JavaScript library on your pages.  This is accomplished by simply adding a single line of code the the HTML HEAD section of each page that you want to add purlHub integration to.  

<script type="text/javascript" src="http://api.purlhub.com/JSAPI/purlServiceApi.min.js?vz=1425"></script>

Then, (3) configure your initialization options.  This requires adding a JavaScript snippet to the HEAD of your page or commonly included JavaScript file.  At a minimum, the serviceToken must be provided in the options object.  View the complete list of options...

<script type="text/javascript">
    var options = {
        pageName: 'My pURL Landing Page',
        serviceToken: '083f4237f6a894753b77a929f9378bad',
        purlCodeStickyDays: 90

Finally, (4) add Class Flags to the elements on your page where you want to add personalization.

    <p id="welcome-block">
        Welcome <span class="phProfileData-firstName">Guest</span>
        <span class="phProfileData-lastName">Visitor</span>!

On the "Landing Page Integration" tab of any purlHub campaign in your account portal, a basic JavaScript Code snippet can be copied an pasted on your landing page.  This simplifies the setup process into 3 steps (configure access, copy / paste code, and Flag elements).  

Contact Us

  • Post a Public Question
  • Ask the Community
  • Email Us

Recent Discussions