Skip to main content

​
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

PropertyTypeDescription
valuenumberMonetary value
currencystringISO currency code
orderIdstringUnique order ID (deduplication)
itemsarrayLine items for purchases
*anyCustom 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]);