Deduplication

Convultra automatically prevents duplicate conversions from being counted or forwarded to ad platforms. This ensures your conversion data is accurate and your ad platform reporting is not inflated.

How deduplication works

When a conversion event arrives, Convultra checks it against multiple deduplication methods before accepting and forwarding it. If a duplicate is detected, the event is silently dropped.

Deduplication methods

Convultra uses five deduplication methods, applied in order of specificity:

Method	Description
Event ID (primary)	Each conversion event is assigned a unique event ID. If the same event ID is received twice, the duplicate is dropped.
Conversion ID	If you provide a unique business identifier (`orderId`, `leadId`, `transactionId`), Convultra deduplicates on that identifier.
Click ID	Prevents the same click ID (`gclid`, `fbclid`, etc.) from generating duplicate conversions of the same type within the dedup window.
Fingerprint	A fingerprint is generated from the visitor's device, browser, IP, and event metadata. Near-identical events from the same fingerprint within the dedup window are dropped.
Time window	Events of the same type from the same visitor within a configurable time window are treated as potential duplicates and evaluated against the methods above.

For best results, always provide a unique business identifier such as orderId or leadId in your conversion calls. This gives the deduplication engine a definitive signal.

Configuration

Navigate to Settings → Project Settings → Deduplication to configure deduplication for your project.

Default settings

Setting	Default value
Deduplication	Enabled
Default window	24 hours
Maximum window	30 days

Per-conversion-type configuration

You can configure different deduplication windows for each conversion type. For example:

Purchases -- 24-hour window (a customer is unlikely to buy the exact same order twice within a day)
Leads -- 1-hour window (form resubmissions typically happen within minutes)
Pageviews -- 5-minute window (page refreshes)

To configure per-type windows:

Open deduplication settings

Go to Settings → Project Settings → Deduplication.

Select a conversion type

Choose the conversion type you want to configure from the dropdown.

Set the deduplication window

Enter the window duration. Minimum is 1 minute; maximum is 30 days.

Save

Click Save to apply the changes. The new window takes effect immediately for incoming events.

Best practices

Always provide unique identifiers. Pass orderId for purchases, leadId for leads, transactionId for custom conversions. This is the most reliable deduplication signal.
Use reasonable time windows. A 24-hour default works well for most use cases. Shorter windows risk allowing true duplicates; longer windows risk blocking legitimate repeat conversions.
Do not disable deduplication unless you have a specific reason and your own deduplication logic upstream.

Example: providing unique identifiers

// Purchase with orderId -- best for deduplication
Convultra.trackPurchase({
  orderId: 'order_abc123',   // unique per order
  value: 149.99,
  currency: 'USD'
})
 
// Lead with leadId -- best for deduplication
Convultra.trackLead({
  leadId: 'lead_xyz789',     // unique per lead
  value: 50.00,
  email: '[email protected]'
})

💡

Deduplication is automatic and requires no manual intervention. Providing unique identifiers improves accuracy but is not strictly required -- the other deduplication methods serve as fallbacks.

Click ID Persistence Pixel Tracking