Cross-Device Tracking and Identity Resolution

Tracking & Analytics

Cross-device tracking allows you to maintain visitor continuity when someone interacts with your campaigns on multiple devices. ClickerVolt offers two methods for cross-device identity: automatic email-based resolution (recommended) and manual visitor ID passing.

Email-Based Identity Resolution (Recommended)

The easiest and most powerful way to track visitors across devices is through email addresses. ClickerVolt automatically detects, captures, and uses email addresses to maintain visitor identity—no manual setup required.

Automatic Form Detection

ClickerVolt's Universal JavaScript automatically hooks into all forms on your pages. When a visitor enters their email address into any email input field, ClickerVolt:

Detects email input fields by type, name, ID, or common patterns
Captures the email when the visitor types, pastes, or uses autofill
Associates the email with the current visitor profile
Creates an email→visitor mapping for future cross-device recognition

This works with opt-in forms, checkout pages, contact forms, and any page element that collects email addresses. No code changes required—it just works.

Email in URL Parameters

When visitors click links containing email addresses (common in email marketing), ClickerVolt automatically extracts and uses them for identity resolution:

https://yourdomain.com/offer?email=user@example.com

The email can be in ANY query parameter—ClickerVolt scans all URL values for email patterns:

?email=user@example.com ?cc=user@example.com ?subscriber_email=user@example.com ?custom_field=user@example.com

How Identity Consolidation Works

When ClickerVolt sees an email address that was previously associated with a different visitor profile, it automatically consolidates these profiles:

All historical data is merged into a single unified profile
The browser cookie is updated to use the consolidated identity
Future visits on any device are correctly attributed
Funnel positions and Progressive Exposure states are preserved

Example: A visitor first clicks your ad on mobile (Profile A). They later return via email link on desktop (Profile B). ClickerVolt detects the same email in both sessions and merges them into a single profile with complete cross-device history.

Manual Email Attachment with cvIdentify

While automatic form detection handles most cases, you can manually attach an email to a visitor session using cvIdentify:

cvIdentify({ email: 'user@example.com' });

Use this when:

Capturing email from custom JavaScript (AJAX forms, single-page apps)
Integrating with third-party form builders that don't use standard inputs
Attaching additional PII like firstName, lastName, phone, dob (date of birth), or gender.

Extended example:

cvIdentify({
email: 'user@example.com',
firstName: 'John',
lastName: 'Doe',
phone: '+1234567890',
dob: '1970-01-01, // yyyy-mm-dd
gender: 'm' // 'm' | 'f'
});

Visitor ID Parameter (Advanced)

For scenarios where email isn't available, you can pass visitor IDs directly via the cvid parameter. This is useful for:

Anonymous tracking without collecting PII
Integrations with systems that don't capture email
Passing visitor context between domains you control

URL Format

Add the cvid parameter to any tracking link:

https://track.yourdomain.com/username/slug?cvid=ULA2tY4M8QkKyJnWO2bVg

The visitor ID is a 21-character alphanumeric string generated using nanoid.

Getting Visitor IDs

Capture the current visitor's ID using JavaScript:

var visitorId = window.CV.getVisitorId(); console.log(visitorId); // "ULA2tY4M8QkKyJnWO2bVg"

Store this ID alongside the visitor's email in your CRM or database, then include it in future personalized communications.

Best Practices

Use email-based tracking for personalized campaigns (email, SMS)—it's automatic and most reliable
Ensure your forms use standard HTML email input types for automatic detection
For AJAX forms, call cvIdentify() after successfully capturing email
Test cross-device flows by opting in on one device and clicking links on another
Don't rely on cvid for public links—only use it where you have prior visitor context

Technical Details

Email Detection Patterns

ClickerVolt identifies email fields by:

Input type="email"
Name or ID containing "email" (case-insensitive)
Common patterns like "contact", "subscribe", "e-mail", "e_mail"
Platform-specific patterns (JVZoo, WarriorPlus, ClickBank)

Profile Merge Behavior

When profiles are consolidated:

The most recent profile becomes the "primary" identity
All activity logs are combined chronologically
Conversion attribution is preserved from original source
Progressive Exposure states are maintained
The email mapping is updated to point to the consolidated profile

After identity resolution, ClickerVolt updates the browser cookie with the consolidated visitor ID. This ensures subsequent page views on the same device maintain the correct identity without requiring the email or cvid parameter again.