LeadPulse Troubleshooting

Not Seeing Any Data?

1. Check Consent Integration

LeadPulse waits for consent by default. Make sure you're callingLeadPulse.grantConsent() when the user accepts cookies.

// In your cookie banner accept handler:
if (window.LeadPulse) {
  window.LeadPulse.grantConsent();
}

2. Check Console for Errors

Open DevTools (F12) and look for errors in the Console tab.

You should see:

[LeadPulse] Waiting for explicit consent...
// After accepting cookies:
[LeadPulse] Consent granted, initializing tracking

3. Check Network Requests

In DevTools Network tab, filter for "leadpulse". You should see:

• POST marketsage.africa/api/leadpulse/identify
• POST marketsage.africa/api/leadpulse/track

4. Disable Ad Blockers

Some ad blockers may block tracking scripts. Test in an incognito window with extensions disabled.

Events Not Being Tracked

Verify Consent is Granted

// In console, check:
console.log(window.LeadPulse.consent.granted);
// Should be: true

Check Event Name Format

Event names should be lowercase with underscores:

// Good
LeadPulse.track('button_click', {...});

// Bad
LeadPulse.track('Button Click', {...});

Visitor Not Being Identified

Call identify() After Consent

// Make sure consent is granted first
if (window.LeadPulse && window.LeadPulse.consent.granted) {
  window.LeadPulse.identify({
    email: 'user@example.com'
  });
}

Check Required Fields

Email is required for identification:

// Required
LeadPulse.identify({ email: 'user@example.com' });

// Optional additional fields
LeadPulse.identify({
  email: 'user@example.com',
  name: 'John Doe',
  company: 'Acme Inc'
});

Dashboard Shows Zero Visitors

Check Your Domain

Make sure you're viewing data for the correct domain in the dashboard.

Wait for Data Processing

Data typically appears within 1-2 seconds. If using filters, check the date range.

Verify Tracking Code

Ensure the tracking code is installed on all pages you want to track.

Common Error Messages

Still Having Issues?

Contact our support team:

• Email: support@marketsage.africa
• Phone: +234 908 000 1101

Related Documentation