Installing the PropFuel Website Engagement Plugin

Edited

The PropFuel plugin is a small JavaScript snippet that you add to your website to enable Website Engagement and Visitor Tracking. Once installed, this plugin allows you to ask questions to visitors and track their activity across your site.

The installation is a one-time setup, after which all interactions are managed directly within the PropFuel admin.

Installation Options

You have two ways to install the PropFuel plugin:

  • Directly embed it in your website’s HTML using your CMS or website hosting tool.

  • Use Google Tag Manager to deploy it across your site.

To maximize engagement and tracking, we recommend including the plugin in your master site template, ensuring it loads on all pages, including:

  • Your main website

  • Member portals

  • Learning management systems (LMS)

  • Other platforms where visitor activity matters

What the Plugin Does

  • Loads asynchronously: The plugin does not slow down your site. It runs in the background without affecting page load speed.

  • Tracks visitor activity: Each time a visitor loads a page, the plugin sends a request to PropFuel containing:

    • The page being viewed

    • Any available cookies to help identify the visitor

  • Receives engagement instructions: PropFuel determines if an interaction should be displayed and sends back the necessary details.

  • Displays interactions: If an engagement is triggered, the plugin loads it in an iframe and injects it into your page according to your campaign settings.

  • Handles responses: When a visitor interacts, the plugin processes the response and:

    • Either dismisses the interaction

    • Or performs the configured action in PropFuel

Installing the PropFuel Plugin Directly in Your CMS

  1. Get the Plugin Code

    • Log in to PropFuel and navigate to Settings → Website Engagement.

    • Copy your unique plugin code (this is specific to your PropFuel account—copy it exactly as is).

  2. Embed the Code in Your CMS

    • Insert the plugin code into your website’s template:

      • Either in the header (<head>)

      • Or at the bottom of the page (<body>)

  3. Verify the Installation

    • Visit your website, then go back to PropFuel → Settings → Website Engagement.

    • Click "Check Connection" to confirm that visitor data is being received.

    • It may take up to 5 minutes for the first traffic data to appear.

Installing the PropFuel Plugin via Google Tag Manager

  1. Get the Plugin Code

    • Log in to PropFuel and go to Settings → Website Engagement.

    • Copy your unique plugin code.

  2. Add the Plugin to Google Tag Manager

    • Log in to Google Tag Manager.

    • Go to your workspace and click "Add New Tag".

    • Name your tag (e.g., "PropFuel Plugin").

    • Click "Tag Configuration", then select "Custom HTML".

    • Paste the PropFuel plugin code into the configuration box, ensuring you include the <script> tags.

  3. Set the Trigger to Fire on All Pages

    • Click "Triggering", then select "All Pages".

  4. Save & Publish Your Changes

    • Click "Save".

    • Click "Submit", then "Publish".

  5. Verify the Installation

    • Visit your website, then return to PropFuel → Settings → Website Engagement.

    • Click "Check Connection" to confirm that visitor data is being received.

    • It may take up to 5 minutes for traffic data to appear.

Was this article helpful?

Sorry about that! Care to tell us more?

Thanks for the feedback!

There was an issue submitting your feedback
Please check your connection and try again.