Script Integration

The VisitorFilters collector is a lightweight JavaScript snippet that captures visitor events and sends them to our processing pipeline for real-time analysis.

Installation

Add the following script to your website's <head> section, replacing YOUR_SITE_ID with your actual Site ID:

<script
  src="https://visitorfilters.com/vf.js"
  data-site="YOUR_SITE_ID"
  defer>
</script>

How the Collector Works

Loads asynchronously — zero impact on your page load time.
Collects visitor fingerprint data (IP, user agent, screen, timezone, referrer).
Sends a signed event payload to our collector endpoint via HTTPS.
Our backend evaluates the event against your rules in real-time.

Verification

After installation, visit your website and check the VisitorFilters dashboard. You should see events appearing within seconds under Dashboard → Live Events.

Advanced Options

Custom Data Attributes

Attribute	Default	Description
`data-site`	—	Your Site ID (required)
`data-endpoint`	Auto	Custom collector endpoint URL
`data-spa`	`false`	Enable SPA mode (track route changes)

Content Security Policy (CSP)

If your site uses a strict CSP, add the following directives:

script-src https://visitorfilters.com;
connect-src https://visitorfilters.com;

Subresource Integrity

For maximum security, you can pin the script hash. Contact support for the current SRI hash of the collector script.