Visitor ID Setup
Install and configure Visitor ID tracking on your website.
Prerequisites
Section titled “Prerequisites”Before setup:
- ✅ HubSpot connected
- ✅ Website access (ability to add JavaScript)
- ✅ Privacy policy updated
- ✅ Compliance reviewed
Configuration
Section titled “Configuration”Navigate to Visitor ID and click the Configuration button.
Settings
Section titled “Settings”Exclude if Company Only: Toggle to filter visitor types
- ON: Only create records when person is identified
- OFF: Create company records even without person data
Pricing Display: “2 per visitor” shows cost per identified visitor
Tracking Code Setup
Section titled “Tracking Code Setup”Two-panel layout for installation:
Left Panel: Script Installation
Section titled “Left Panel: Script Installation”Choose tracking method:
1. Default Tracking (Simple implementation)
Recommended for most users:
- Standard identification
- Automatic person/company detection
- No custom configuration needed
2. Custom Tracking (Advanced)
For advanced use cases:
- External ID mapping
- First-party data stitching
- Custom user identification
Tracking Script
Section titled “Tracking Script”Copy the script snippet:
<script async src="https://cdn.sellestial.com/cs?cid=YOUR_CUSTOMER_ID"></script>Parameters:
cid— Your unique customer ID (pre-filled)async— Non-blocking load
Installation Steps
Section titled “Installation Steps”-
Choose Tracking Method
Select Default or Custom based on your needs
-
Copy Script
Click copy button to copy complete script
-
Add to Website
Place script before closing
</body>tag:<!DOCTYPE html><html><head><title>Your Site</title></head><body><!-- Your content --><script async src="https://cdn.sellestial.com/cs?cid=YOUR_CUSTOMER_ID"></script></body></html> -
Verify Implementation
Check Network tab for requests to
cdn.sellestial.com
Implementation Guide
Section titled “Implementation Guide”Placement Best Practices
Section titled “Placement Best Practices”Where to Place:
- ✅ Before closing
</body>tag - ✅ After main content
- ✅ With other tracking scripts
Why:
- Non-blocking page load
- Doesn’t affect performance
- Loads in parallel with other scripts
Don’t Place:
- ❌ In
<head>(blocks rendering) - ❌ Before critical content
- ❌ Inline in content
Script Attributes
Section titled “Script Attributes”async attribute:
- Loads script asynchronously
- Doesn’t block page rendering
- Improves page load time
src parameter:
- Points to Sellestial CDN
- Globally distributed
- High availability
- Fast load times
Custom User Identification
Section titled “Custom User Identification”For advanced implementations with first-party data:
Modify External ID Variable
Section titled “Modify External ID Variable”<script> // Set before Sellestial script loads window.sellestial_external_id = 'your_user_id_123';</script><script async src="https://cdn.sellestial.com/cs?cid=YOUR_CUSTOMER_ID"></script>Use Cases
Section titled “Use Cases”Existing User Database: Link Sellestial identifications to your user IDs:
- Match with internal systems
- Connect multiple sessions
- Track user journey across devices
CRM Integration: Map to existing CRM IDs:
- Deduplicate records
- Prevent duplicate creation
- Maintain data consistency
Analytics Integration: Connect with analytics platforms:
- Google Analytics user ID
- Segment anonymous ID
- Custom tracking IDs
Verification
Section titled “Verification”Check Implementation
Section titled “Check Implementation”-
Open Website
Navigate to page with tracking script
-
Open Developer Tools
Press F12 or right-click → Inspect
-
Go to Network Tab
Filter by “sellestial” or “cdn.sellestial.com”
-
Look for Requests
Should see requests to Sellestial CDN
-
Check Response
200 OK status means working correctly
Expected Network Activity
Section titled “Expected Network Activity”On Page Load:
Request: GET cdn.sellestial.com/cs?cid=YOUR_CUSTOMER_IDStatus: 200 OKType: scriptOn Identification:
Request: POST cdn.sellestial.com/identifyStatus: 200 OKType: xhr/fetchCommon Issues
Section titled “Common Issues”No Network Requests:
- Script not installed correctly
- Ad blocker interfering
- Browser privacy settings
404 Errors:
- Incorrect customer ID
- Typo in script URL
- Account not active
Script Not Loading:
- CDN blocked
- Network issues
- Corporate firewall
Testing
Section titled “Testing”Test Installation
Section titled “Test Installation”-
Visit Your Website
Open site in browser
-
Browse Multiple Pages
View 2-3 different pages
-
Check Dashboard
Go to Visitor ID dashboard in Sellestial
-
Wait 2-5 Minutes
Identification may take a few minutes
-
Look for Your Visit
Should appear in Recent Visitors feed
What to Verify
Section titled “What to Verify”Dashboard Shows:
- Your visit appears
- Location is correct
- Pages viewed are listed
- Timestamp is recent
HubSpot Shows:
- New contact created (if identified)
- Company created (if applicable)
- Page views logged
- Properties populated
Privacy Compliance
Section titled “Privacy Compliance”Privacy Policy
Section titled “Privacy Policy”Update your privacy policy to include:
**Visitor Identification**
We use Sellestial to identify website visitorsfor marketing and sales purposes. This servicemay collect:- IP address- Pages viewed- Visit duration- Browser information- Device type
To opt out of visitor identification, emailprivacy@yourcompany.com.Opt-Out Mechanism
Section titled “Opt-Out Mechanism”Provide easy opt-out:
Option 1: Email Request
- Provide email address in privacy policy
- Process opt-out requests promptly
- Confirm opt-out to requester
Option 2: Cookie Banner
- Include Sellestial in consent options
- Respect “do not track” selections
- Don’t load script if consent denied
Option 3: Dedicated Page
- Create /opt-out page
- Form to submit email/ID
- Automatic opt-out processing
Advanced Configuration
Section titled “Advanced Configuration”Conditional Loading
Section titled “Conditional Loading”Only load for certain visitors:
<script> // Only load for non-customers if (!userIsCustomer) { var script = document.createElement('script'); script.async = true; script.src = 'https://cdn.sellestial.com/cs?cid=YOUR_CUSTOMER_ID'; document.body.appendChild(script); }</script>Page Filtering
Section titled “Page Filtering”Exclude certain pages:
<script> // Don't track checkout or account pages var excludedPaths = ['/checkout', '/account', '/admin']; var currentPath = window.location.pathname; var shouldTrack = !excludedPaths.some(path => currentPath.startsWith(path));
if (shouldTrack) { var script = document.createElement('script'); script.async = true; script.src = 'https://cdn.sellestial.com/cs?cid=YOUR_CUSTOMER_ID'; document.body.appendChild(script); }</script>Event Tracking
Section titled “Event Tracking”Track specific events (if supported):
<script> window.sellestialTrack = window.sellestialTrack || [];
// Track button click document.getElementById('cta-button').addEventListener('click', function() { window.sellestialTrack.push({ event: 'button_click', properties: { button_id: 'cta-button', page: window.location.pathname } }); });</script>Troubleshooting
Section titled “Troubleshooting”No Visitors Appearing
Section titled “No Visitors Appearing”Check:
- Script installed correctly?
- Enough traffic to identify?
- Visitors mostly US-based?
- Time delay for processing?
- Dashboard filters applied?
Remember: Only ~25% of US visitors identified
Duplicate Records Created
Section titled “Duplicate Records Created”Possible causes:
- Multiple tracking scripts
- Script loaded multiple times
- External ID not consistent
Solutions:
- Check for duplicate scripts
- Ensure single script load
- Verify external ID logic
Geographic Data Wrong
Section titled “Geographic Data Wrong”Common issues:
- VPN usage by visitor
- Corporate proxy servers
- Mobile carrier locations
Note: Location is approximate based on IP
Performance Impact
Section titled “Performance Impact”Concern: Site speed affected
Reality:
- Async loading (non-blocking)
- CDN delivery (fast)
- Minimal payload
- No noticeable impact
Verify:
- Check Google PageSpeed
- Monitor load times
- Test with/without script
Next Steps
Section titled “Next Steps”- Visitor ID Overview — Understand the special pipeline
- Data Enrichment — Enrich identified contacts
- Usage & Billing — Monitor visitor ID costs