Events not appearing
If events are not showing up, debug using the browser console:
Copy the test QR Code URL
Open a new incognito window
Open DevTools → Console tab
Navigate to the URL
Common error:
installHook.js:1 [Insights:EventManager] - Failed to process queued event:
Error: Event enrichment failed: missing required fields (deviceId or sessionId)
What this means:
The Pixel failed to initialize. The most common cause is that the domain has not been whitelisted.
Resolution steps:
Confirm the destination domain is added to Configured Domains. Learn how to whitelist domains
If already whitelisted and events still don’t appear, escalate to our support team
Pixel blocked by CSP
If your website uses a Content Security Policy (CSP) that blocks the following URL, the Pixel will not load:
https://cdn.uniqode.com/insights/production/v1/latest/sdk.js
Resolution:
Ask your IT team to whitelist this URL in the CSP configuration.
FAQ
Is a new Pixel required per domain?
No. Each account has a single Pixel. The same Pixel code can be used across multiple domains.
Does every domain and subdomain need to be whitelisted?
Yes. Each domain and subdomain must be individually whitelisted.
What if the journey spans multiple domains (e.g., QR code → domain1 → domain2)?
This requires technical support from Uniqode
Key considerations:
Subdomain changes: Tracking works if cookies are retained and the Pixel is installed on each subdomain
Domain changes (or cookie loss): The
?uq=******URL parameter must be preserved throughout the journey for accurate tracking