JavaScript SDK

The ListenLayer JavaScript SDK for browser-based tracking.

Installation

Script Tag

<script src="https://cdn.listenlayer.com/ll.js"></script>
<script>
  _ll('init', 'YOUR_ACCOUNT_ID');
</script>

NPM

npm install @listenlayer/sdk

import { ListenLayer } from '@listenlayer/sdk';

const ll = new ListenLayer('YOUR_ACCOUNT_ID');

Basic Usage

Track Events

_ll('track', 'button_clicked', {
  button_id: 'signup-cta',
  page: '/pricing'
});

Identify Users

_ll('identify', 'user_123', {
  email: '[email protected]',
  name: 'Jane Doe',
  plan: 'pro'
});

Track Page Views

_ll('page', {
  title: 'Pricing Page',
  category: 'marketing'
});

Configuration Options

_ll('init', 'YOUR_ACCOUNT_ID', {
  debug: true,           // Enable debug mode
  trackPages: true,      // Auto-track page views
  trackForms: true,      // Auto-track form submissions
  trackClicks: false,    // Manual click tracking
  consent: 'granted'     // Consent state
});

TypeScript

Full TypeScript support included:

import { ListenLayer, TrackOptions } from '@listenlayer/sdk';

const options: TrackOptions = {
  event: 'purchase',
  properties: {
    value: 99.99
  }
};