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

# SDKs Overview

> Track events across web, server, and mobile with DATALYR SDKs

DATALYR provides SDKs for all major platforms, enabling you to track user behavior and conversions across web browsers, server-side applications, and mobile apps.

## What It Does

**Track Events Everywhere:**

* Web SDK for browser tracking
* Server SDK (Node.js) for backend events
* iOS SDK for native Apple apps
* React Native SDK for cross-platform mobile apps
* Consistent API across all platforms
* Automatic identity resolution across devices

## Available SDKs

### Web SDK (JavaScript)

**Best For:**

* Website tracking
* Single-page applications (SPAs)
* Client-side event tracking
* Attribution tracking
* Session management

**Features:**

* Automatic pageview tracking
* Custom event tracking
* User identification
* Attribution capture
* Fingerprinting
* Cookie management
* Container/tag manager support

**Installation:**

```bash theme={null}
npm install @datalyr/web
```

Or use a script tag for sites without a build system:

```html theme={null}
<script defer src="https://track.datalyr.com/dl.js"
  data-workspace-id="your_workspace_id">
</script>
```

See [Web SDK](/sdks/web) for full documentation.

### Server SDK (Node.js)

**Best For:**

* Backend event tracking
* Server-side conversions
* Webhook processing
* API integrations
* Bulk data imports

**Features:**

* Server-side event tracking
* Identity resolution
* Event batching
* Automatic retries
* Offline queue
* TypeScript support

**Installation:**

```bash theme={null}
npm install @datalyr/api
```

**Example:**

```javascript theme={null}
const Datalyr = require('@datalyr/api');
const datalyr = new Datalyr('dk_your_api_key');

await datalyr.track({
  event: 'purchase',
  userId: 'user_123',
  properties: { revenue: 99.99, currency: 'USD' }
});
```

See [Server SDK](/sdks/server) for full documentation.

### iOS SDK (Swift)

**Best For:**

* Native iOS apps
* iPad apps
* App Store attribution
* SKAdNetwork integration

**Features:**

* Native Swift API
* App lifecycle tracking
* Attribution tracking
* SKAdNetwork support
* Session management
* Offline queue
* Third-party integration helpers (`getSuperwallAttributes()`, `getRevenueCatAttributes()`)

**Installation:**

```swift theme={null}
// Swift Package Manager
dependencies: [
  .package(url: "https://github.com/datalyr/swift", from: "2.1.3")
]
```

**Example:**

```swift theme={null}
import DatalyrSDK

try await DatalyrSDK.shared.initialize(config: DatalyrConfig(
  workspaceId: "your_workspace_id",
  apiKey: "dk_your_api_key"
))

await DatalyrSDK.shared.track("purchase", eventData: [
  "revenue": 99.99,
  "currency": "USD"
])
```

See [Mobile SDKs](/sdks/mobile) for full documentation.

### React Native SDK

**Best For:**

* Cross-platform mobile apps (iOS + Android)
* React Native projects
* Expo apps

**Features:**

* Works on both iOS and Android
* React Native hooks support
* Attribution tracking
* Session management
* Offline queue
* TypeScript support
* Third-party integration helpers (`getSuperwallAttributes()`, `getRevenueCatAttributes()`)

**Installation:**

```bash theme={null}
npm install @datalyr/react-native
```

**Example:**

```javascript theme={null}
import { Datalyr } from '@datalyr/react-native';

await Datalyr.initialize({
  workspaceId: 'your_workspace_id',
  apiKey: 'dk_your_api_key'
});

await Datalyr.track('purchase', {
  revenue: 99.99,
  currency: 'USD'
});
```

See [Mobile SDKs](/sdks/mobile) for full documentation.

### Public API

**Best For:**

* Read-only access to analytics data
* Building custom dashboards
* AI-powered data queries
* Programmatic reporting

**Features:**

* 14 REST endpoints covering all analytics data
* Authenticate with SDK key (`dk_`) or Agent key (`dk_agent_`)
* 100 requests/minute rate limit
* JSON responses

**Base URL:**

```
https://datalyr.com/api/v1
```

See [Public API](/sdks/api) for full documentation.

## Choosing the Right SDK

**Use Web SDK when:**

* Tracking website visitors
* Building web applications
* Need browser attribution data
* Want automatic pageview tracking

**Use Server SDK when:**

* Processing backend events
* Tracking server-side conversions
* Building webhooks or APIs
* Need secure API key tracking

**Use iOS SDK when:**

* Building native iOS apps
* Need SKAdNetwork integration
* Want App Store attribution
* Require native performance

**Use React Native SDK when:**

* Building cross-platform apps
* Using React Native framework
* Need both iOS and Android support
* Want single codebase

## Common Features

**All SDKs Include:**

* Event tracking with custom properties
* User identification
* Anonymous visitor tracking
* Session management
* Event batching and queue
* Automatic retries
* Offline support
* Debug mode

**Identity Resolution:**
All SDKs use consistent identity fields (`anonymousId`, `userId`, `visitorId`) to link users across platforms and devices.

**Event Format:**
Events tracked from any SDK appear identically in DATALYR dashboard with platform-specific metadata.

## Authentication

**Web SDK:** Uses `workspaceId` (public identifier from tracking script)

**Server/Mobile SDKs:** Require `apiKey` (secret key from Settings → API Keys)

Keep API keys secure - never expose in client-side code.

## Getting Started

**Quick Start:**

1. Choose SDK for your platform
2. Install via npm/Swift Package Manager
3. Initialize with workspace ID or API key
4. Track your first event
5. Verify in Event Stream

**Best Practices:**

* Use Web SDK for browser tracking
* Use Server SDK for backend events
* Use Mobile SDKs for apps
* Combine SDKs for full-stack tracking
* Track same user across platforms with `identify()`

## Event Limits

All tracked events count toward your plan limits regardless of SDK used.

See [Pricing](/account/pricing) for event limits.

## Support

**SDK Issues:**

* GitHub Issues for each SDK repository
* Email [hello@datalyr.com](mailto:hello@datalyr.com)

**Example Code:**
Each SDK includes example projects showing common implementations.

## Next Steps

<CardGroup cols={2}>
  <Card title="Web SDK" icon="globe" href="/sdks/web">
    Browser tracking guide
  </Card>

  <Card title="Server SDK" icon="server" href="/sdks/server">
    Backend tracking guide
  </Card>

  <Card title="Mobile SDKs" icon="mobile" href="/sdks/mobile">
    iOS & React Native guide
  </Card>

  <Card title="Advanced Topics" icon="code" href="/sdks/advanced">
    Identity, batching, plugins
  </Card>

  <Card title="Public API" icon="plug" href="/sdks/api">
    REST API for analytics data
  </Card>
</CardGroup>