Developer Guide

Tracking Script Installation.

Add one script tag to start capturing events, click IDs, and attribution data. Works on any website -- no build step required.

Quick Install

Add this script tag to the <head> of every page you want to track. Replace YOUR_WORKSPACE_ID with your actual workspace ID from the dashboard.

html

<script
  src="https://vortextrk.com/tf.js"
  data-workspace="YOUR_WORKSPACE_ID"
  async
></script>

The async attribute ensures the script does not block page rendering. It loads in parallel and initializes automatically when ready.

What It Tracks

The tracking script captures the following data automatically, with no additional configuration required.

Page Views

Automatic page view tracking on every navigation. Captures URL, referrer, and time on page.

Click ID Capture

Automatically extracts fbclid, gclid, ttclid, and other click identifiers from URLs and stores them for attribution.

UTM Parameters

Preserves utm_source, utm_medium, utm_campaign, utm_term, and utm_content across the entire session.

Custom Events

Track any custom event with VTX.track(). Attach properties and metadata for full-funnel analysis.

Custom Events

Track any action with VTX.track(). Pass an event name and an optional properties object.

javascript

// Track a form submission
VTX.track("lead_submitted", {
  email: "user@example.com",
  name: "John Doe",
  form_id: "contact-form",
  page: window.location.pathname
});

// Track a button click
VTX.track("cta_clicked", {
  button: "pricing-start-free",
  section: "hero"
});

// Track a purchase
VTX.track("purchase", {
  value: 99.00,
  currency: "USD",
  product_id: "pro-monthly"
});

VTX.identify

Associate tracked events with a known contact. Call VTX.identify() once you have user information (e.g., after form submission or login).

javascript

VTX.identify({
  email: "user@example.com",
  name: "John Doe",
  phone: "+1234567890",
  company: "Acme Corp"
});

After calling identify, all subsequent events in the session will be attributed to this contact.

Platform-Specific Installation

Instructions for common website platforms.

WordPress

1Go to Appearance > Theme Editor > header.php
2Paste the script tag just before the closing </head> tag
3Save and clear any caching plugins

Wix

1Go to Settings > Custom Code (under Advanced)
2Click "Add Code to Head" and paste the script tag
3Set it to load on "All Pages" and save

Elementor

1Go to Elementor > Custom Code (requires Elementor Pro)
2Add a new code snippet, set location to "Head"
3Paste the script tag and publish

Verification Steps

After installing the script, verify it is working correctly.

Open your website in a browser and check the Network tab in DevTools for a request to tf.js from your Vortex domain
Open the browser Console and type VTX -- you should see the Vortex tracking object
Navigate between pages and check your Vortex dashboard for incoming page_view events
Submit a test form and verify the lead_submitted event appears with correct properties
Check that click IDs (fbclid, gclid) are captured by appending ?fbclid=test123 to your URL

javascript

// Quick verification in browser console
console.log("VTX loaded:", typeof VTX !== "undefined");
console.log("Workspace:", VTX?.config?.workspace);
console.log("Session ID:", VTX?.session?.id);

Script installed? Set up your integrations.

Now that tracking is live, connect your ad platforms to start sending server-side conversions.

Continue Setup Manage Pixels