How the Optibase Script Works

The Optibase Custom Script is the engine that powers your entire optimization suite. It is a lightweight JavaScript snippet that handles live testing, behavioral tracking (Heatmaps/Recordings), and conversion attribution in real time.

Without this script installed, Optibase cannot run tests, capture heatmaps, or track conversions.


Core Technical Functions

1. Dynamic Test Logic

On every page load, the script performs a secure handshake with Optibase servers to:

  • Identify active experiments for the specific URL.

  • Evaluate Audience Restrictions (Geo-location, Browser type, OS, etc.).

  • Determine if the user should be included in a test or a personalization campaign.

2. A/B & Multivariate Testing (No-Flicker Technology)

To ensure a seamless user experience, the script:

  • Scans the page for elements containing data-optibase-test-id and data-optibase-variant-id.

  • Assigns the user to a specific variant.

  • Instant Reveal: It removes the display:none style from the chosen variant and deletes non-selected variants from the DOM.

  • Pro-Tip: Ensure your "Main Variant" is the only one visible by default in your Webflow or WordPress editor to prevent a flash of unstyled content.

3. URL-Based Split Testing

For redirect-based experiments, the script:

  • Checks if the current URL is a "Split Test" entry point.

  • Decides whether to keep the user on the current page or trigger an immediate redirect.

  • Context Preservation: If a redirect occurs, it appends splitTestId and splitVariantId parameters to the URL so the destination page knows which experiment is active.

4. Behavioral Intelligence & Analytics

The script is also responsible for your site’s "Intelligence" features:

  • Heatmaps: Maps user clicks, scrolls, and mouse movements.

  • User Recording Sessions: Captures the visual journey of a user to find friction points.

  • Analytics: Collects page view data and interaction events.

Note: Page views only count toward your plan limits if an active or eligible test is present on the page.

5. Conversion Attribution

The script automatically attaches event listeners to track:

  • Click Conversions: (data-optibase-click-conversion-id)

  • Form Submissions: (data-optibase-submit-conversion-id)

  • Event Logic: When a user converts, the script attributes that success to all active A/B variants the user has seen during that session.


Debugging and Developer Controls

You can control how the script behaves in your specific browser using URL parameters. This is essential for testing your setup before going live.

Action

URL Parameter

Result

Enable Debug Mode

?optibaseEnableDebugMode

Shows step-by-step logic in the browser console.

Disable Debug Mode

?optibaseDisableDebugMode

Stops logging to the console.

Disable All Scripts

?optibaseDisableScript

Blocks all tests and tracking in your browser.

Re-enable Script

?optibaseEnableScript

Restores normal script behavior.


Summary of Capabilities

The Optibase script is a multi-purpose tool that:

  1. Determines test eligibility based on audience and URL.

  2. Renders the correct A/B or Multivariate variant instantly.

  3. Redirects users for Split Tests.

  4. Records heatmaps and user session replays.

  5. Tracks conversions and sends data to your Optibase Dashboard.

Last updated