JavaScript SDK

Track conversions with the JavaScript SDK

JavaScript SDK

Track conversions on your website using the Linquid JavaScript SDK.

Installation

Add to your page:

<script src="https://cdn.linquid.io/pixel.js"></script>

Or install via npm:

npm install @linquid/pixel

import { linquid } from '@linquid/pixel';

Configuration

Initialize with your campaign pixel code:

linquid.init('lw_px_your_pixel_code');

Tracking Events

Basic Conversion

linquid.track('conversion');

Purchase with Value

linquid.track('purchase', {
  value: 99.99,
  currency: 'USD',
  orderId: 'ORD-12345'
});

Signup

linquid.track('signup', {
  plan: 'pro',
  method: 'email'
});

Lead

linquid.track('lead', {
  source: 'contact_form',
  interest: 'enterprise'
});

Custom Event

linquid.track('custom_event', {
  category: 'engagement',
  action: 'video_complete',
  label: 'product_demo'
});

Event Properties

Property	Type	Description
value	number	Monetary value
currency	string	ISO currency code
orderId	string	Unique order ID (deduplication)
items	array	Line items for purchases
*	any	Custom properties

E-commerce Tracking

linquid.track('purchase', {
  value: 149.98,
  currency: 'USD',
  orderId: 'ORD-12345',
  items: [
    {
      sku: 'WIDGET-1',
      name: 'Widget Pro',
      price: 49.99,
      quantity: 2
    },
    {
      sku: 'GADGET-2',
      name: 'Gadget Plus',
      price: 50.00,
      quantity: 1
    }
  ]
});

Click ID

The SDK automatically captures the click_id from the URL. You can also access it:

const clickId = linquid.getClickId();

Debug Mode

Enable console logging:

linquid.init('lw_px_xxx', { debug: true });

SPA Support

For single-page applications, track route changes:

// React Router example
useEffect(() => {
  linquid.pageview();
}, [location.pathname]);