> ## Documentation Index
> Fetch the complete documentation index at: https://docs-v2.adscrush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Web SDK

> Lightweight JavaScript library for conversion tracking

## Installation

```html theme={null}
<head>
  <script src="https://sdk.adscrush.com/v1/index.iife.min.js"></script>
</head>
```

The SDK auto-initializes and captures the `tid` parameter from your URL.

## NPM (Optional)

```bash theme={null}
npm install @adscrush/web-sdk
```

```javascript theme={null}
import AdsCrushSDK from '@adscrush/web-sdk'
```

## Configuration (Optional)

Set before loading the SDK:

```html theme={null}
<script>
  window.adscrushConfig = {
    domain: 'track.yourdomain.com', // Custom tracking domain (default: "track.adscrush.com")
    paramName: ['clickid', 'tid'], // Ordered URL params (default: platform `clickid`, legacy `tid`)
    cookieDomain: '.example.com',  // Cross-subdomain tracking
    cookieExpiry: 30,        // Days to keep click ID
    debug: true,             // Enable console logging
    keymapping: ['sub1:aff_sub1'] // Map URL params to SDK fields
  }
</script>
<script src="https://sdk.adscrush.com/v1/index.iife.min.js"></script>
```

The `domain` option is used by **both** `trackConversion()` and `trackLead()`.
Per-call `domain` overrides take precedence over this config value.

## Manual Click ID

```javascript theme={null}
AdsCrushSDK.setClickId('abc-123-def-456')
```

## Verify

```javascript theme={null}
console.log(AdsCrushSDK.getClickId()) // Click ID or null
```

**See also:** [Track Clicks](/sdk/track-click) · [Track Conversions](/sdk/track-conversion) · [Track Leads](/sdk/track-lead) · [API Reference](/sdk/api-reference)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.