Facebook Pixel & CAPI Deduplication

When you use both Facebook Pixel (browser-side) and ClickerVolt's Conversion API (CAPI) integration, the same conversion can be counted twice. ClickerVolt provides fully automatic deduplication to ensure each conversion is counted only once.

How It Works

ClickerVolt automatically generates a unique event_id for each conversion or event, then ensures both Facebook Pixel and CAPI receive the same ID. Facebook uses this ID to deduplicate events within a 48-hour window.

1. When you call cvConvert() or cvEvent(), ClickerVolt generates a unique event_id based on the visitor's click ID

2. ClickerVolt intercepts your fbq() calls and automatically injects this event_id

3. The same event_id is sent to Facebook via the server-side CAPI

4. Facebook matches both events by their event_id and counts only one conversion

Requirements

For deduplication to work correctly, you must follow this call order on your thank-you page:

1. Call cvConvert() or cvEvent() FIRST

2. Then call fbq('track', 'Purchase') or other FB Pixel events

Important: If fbq() fires before cvConvert(), deduplication will not work because no event_id will be available to inject.

Example Code

Here's the correct order for your thank-you page:

// ✅ CORRECT ORDER
cvConvert(49.99, 'order-123');  // Call ClickerVolt first
fbq('track', 'Purchase', {      // Then call FB Pixel
  value: 49.99,
  currency: 'USD'
});

// ❌ WRONG ORDER - Deduplication won't work
fbq('track', 'Purchase', {...}); // FB fires before ClickerVolt
cvConvert(49.99, 'order-123');   // Too late!

Console Debugging

Open your browser's Developer Console to verify deduplication is working. You should see these log messages:

• [CV] FB Pixel interceptor attached (FB loaded first) - or (CV loaded first)

• [CV] Injected eventID into fbq: click123_order456

Warning message: If you see "[CV] fbq fired before cvConvert/cvEvent - FB Pixel/CAPI deduplication will not work", it means fbq() was called before cvConvert(). Fix the call order on your page.

Event ID Format

ClickerVolt generates event IDs in these formats:

• Conversions: {clickId}_{transactionId} or {clickId}_conv if no transaction ID

• Events: {clickId}_event_{eventNumber} (e.g., click123_event_1)

These IDs are guaranteed unique per visitor and per event type, ensuring accurate deduplication across all your campaigns.

No Configuration Required

This feature is completely automatic. Once you have both the ClickerVolt tracking script and Facebook Pixel installed on your page, deduplication happens behind the scenes. There are no settings to configure.

Note: Make sure your Facebook CAPI integration is configured in Settings → Ad Platforms → Facebook to enable server-side conversion tracking.