Common Issues

Check Script Inclusion

Verify the script tag is in your HTML:

<script src="https://cdn.convultra.com/ultra.min.js"></script>

Or if self-hosting:

<script src="/path/to/ultra.min.js"></script>

Check Initialization

Ensure you're calling init():

Convultra.init({
  apiKey: 'your-api-key',
  endpoint: 'https://your-endpoint.com'
})

Check Console Errors

Look for JavaScript errors that may prevent loading:

• Syntax errors
• CORS errors
• Network errors

Check Ad Blocker

Temporarily disable ad blockers to test. Some blockers block analytics scripts.

Verify API Key

Ensure the API key matches your project:

// Check in console
console.log(Convultra.getConfig().apiKey)

Check Endpoint

Verify the endpoint URL is correct:

console.log(Convultra.getConfig().endpoint)

Check Network Requests

In browser DevTools → Network:

1. Filter by "track" or your endpoint domain
2. Check request is successful (200 status)
3. Check response for errors

Check Project Filter

In dashboard, ensure:

• Correct project selected
• Time range includes recent events
• "Include bots" toggle if testing

Check Auto-Tagging

Ensure auto-tagging is enabled in ad platforms:

• Google Ads: Account Settings → Auto-tagging
• Microsoft Ads: Account Settings → URL options

Check Landing Page URLs

Verify click IDs are in URLs:

✅ https://yoursite.com/?gclid=Cj0KCQ...
❌ https://yoursite.com/

Check SDK on Landing Pages

The SDK must be on the first page user lands on to capture click IDs.

Check LocalStorage

Verify click IDs are being stored:

localStorage.getItem('_cu_gclid')
localStorage.getItem('_cu_fbclid')

Check UTM Stripping

Some systems strip URL parameters. Check:

• Redirects
• CMS/framework URL handling
• Server-side processing

Check Integration Status

Dashboard → Integrations

Verify the platform connection is:

• ✅ Connected
• ✅ Active (not expired)

Check Event Mapping

Ensure your event type is mapped:

Check Forwarding Logs

Integrations → [Platform] → View Logs

Look for:

• Error messages
• Failed requests
• Retry attempts

Check Click ID Presence

Conversions need click IDs for attribution:

// Verify click IDs exist
Convultra.getClickIds()

Re-authorize Integration

Token may have expired:

1. Disconnect integration
2. Reconnect with fresh OAuth

Check for Single-Page Apps

SPAs need manual page tracking:

// On route change
Convultra.page()

Check for Quick Exits

Users may be leaving immediately. Check:

• Page load time
• Content above the fold
• Mobile experience

Filter Bot Traffic

Bots inflate bounce rates. Enable bot filtering:

Dashboard → Toggle off "Include Bots"

Check Session Duration

Default session timeout is 30 minutes. Adjust if needed:

Settings → Session Timeout

Check Order ID

Always include unique order IDs:

// ✅ Good
Convultra.trackPurchase({
  orderId: 'ORD-12345-unique',
  value: 99.99
})
 
// ❌ Bad
Convultra.trackPurchase({
  value: 99.99
})

Check for Page Reloads

Thank you page reloads can fire events multiple times. Solutions:

• Use one-time session flag
• Check URL for already-tracked indicator
• Use server-side tracking

// One-time flag example
if (!sessionStorage.getItem('order_tracked')) {
  Convultra.trackPurchase({ orderId: '...' })
  sessionStorage.setItem('order_tracked', 'true')
}

Check for Multiple SDK Instances

Ensure script isn't included twice on the page.

Check Deduplication Windows

Adjust windows if legitimate events are outside default timeframes:

Settings → Deduplication

Check Domain Configuration

Both domains must be in the config:

Convultra.init({
  crossDomainDomains: ['site-a.com', 'site-b.com']
})

Check SDK on Both Domains

SDK must be installed and initialized on both domains.

Check Link Decoration

Verify _cvl parameter is added to links:

<!-- Should become -->
<a href="https://site-b.com?_cvl=eyJz...">Link</a>

Check for URL Stripping

Some systems strip unknown parameters. Check:

• Server redirects
• CMS settings
• Security plugins

Check Data Format

Ensure proper formatting:

// ✅ Good
{
  email: 'user@example.com',    // Lowercase, trimmed
  phone: '+14155551234',        // E.164 format
  firstName: 'John',            // Capitalized
  lastName: 'Doe'
}
 
// ❌ Bad
{
  email: '  USER@Example.COM ',  // Not normalized
  phone: '(415) 555-1234',       // Wrong format
  firstName: 'john',
  lastName: 'DOE'
}

Provide More Data

More fields = better matching:

Check Platform Diagnostics

• Google: Conversions → [Action] → Diagnostics
• Meta: Events Manager → Data Sources → Event Match Quality