Skip to main content
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: 
<script defer src="https://track.datalyr.com/dl.js"
  data-workspace-id="your_workspace_id">
</script>
Or install via npm: 
npm install @datalyr/web-sdk
See Web SDK 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: 
npm install @datalyr/api
Example: 
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 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
Installation: 
// Swift Package Manager
dependencies: [
  .package(url: "https://github.com/datalyr/datalyr-ios-sdk", from: "1.0.0")
]
Example: 
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 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
Installation: 
npm install @datalyr/react-native-sdk
Example: 
import { Datalyr } from '@datalyr/react-native-sdk';

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

await Datalyr.track('purchase', {
  revenue: 99.99,
  currency: 'USD'
});
See Mobile SDKs 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 for event limits.

​
Support

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

​
Next Steps

Web SDK

Browser tracking guide

Server SDK

Backend tracking guide

Mobile SDKs

iOS & React Native guide

Advanced Topics

Identity, batching, plugins