Documentation

How to Install the LeadPulse Pixel

Install the native LeadPulse pixel on your website to capture page views, custom events, and downstream conversion signals.

Why install the LeadPulse pixel

Click analytics show acquisition quality, but they do not prove business outcomes on their own. The LeadPulse pixel adds post-click behavior, so you can measure which channels and campaigns actually generate signups, leads, and revenue actions.

How the pixel works

  1. The install script loads from /lp/pixel.js?key=....
  2. A persistent visitor token is stored in browser storage.
  3. A page_view event is sent automatically on page load.
  4. Custom events are sent with window.LeadPulse.track('event_name', metadata).
  5. LeadPulse stores event state for audience and attribution analysis.

1. Create your workspace pixel

Open Dashboard > Pixels and click Create LeadPulse Pixel. Copy the generated install snippet.

2. Install script in global head

Place the snippet before </head> in your main site template so it loads on all tracked pages.

<script defer src="https://www.getleadpulse.com/lp/pixel.js?key=lp_your_pixel_key"></script>

3. Add custom conversion events

Trigger custom events on meaningful actions, not generic clicks. Keep event names consistent and lowercase.

window.LeadPulse?.track('signup_completed', {
  plan: 'pro',
  step: 'checkout_success',
  source: 'pricing_page'
});

Recommended event schema

  • signup_started
  • signup_completed
  • demo_requested
  • checkout_started
  • checkout_completed

4. Verify installation

  1. Open your site and confirm the pixel script request succeeds in browser network tools.
  2. Trigger one custom event from a test flow.
  3. Confirm events appear in LeadPulse audience/event reporting.

Privacy and compliance checklist

  • Gate marketing events behind consent when required in your region.
  • Document tracked event types in your privacy policy.
  • Avoid sending sensitive personal data in event metadata.