SDK Reference - Datalyr Docs

Pick the SDK that matches where your code runs. Use one SDK per runtime.

SDK	Package	Version	Endpoint
Web	`@datalyr/web`	`1.7.6`	`https://ingest.datalyr.com`
Node.js	`@datalyr/api`	`1.3.1`	`https://ingest.datalyr.com/track`
iOS	`DatalyrSDK`	`2.1.10`	`https://ingest.datalyr.com/track`
React Native	`@datalyr/react-native`	`1.7.15`	`https://ingest.datalyr.com/track`

Time units differ between SDKs

Never copy a numeric configuration value from one SDK to another. timeout: 15000 means 15 seconds on React Native and 15,000 seconds on iOS. sessionTimeout: 60 means 60 milliseconds on the Web SDK, not 60 minutes.

Option	Web	Node.js	iOS	React Native
Request timeout	None	`timeout` ms	`timeout` seconds	`timeout` ms
Flush interval	`flushInterval` ms	`flushInterval` ms	`flushInterval` seconds	`flushInterval` ms
Retry delay	`retryDelay` ms	None	`retryDelay` seconds	`retryDelay` ms
Session timeout	`sessionTimeout` ms	None	`sessionTimeoutMs` ms	`sessionTimeoutMs` ms
Attribution window	`attributionWindow` ms	None	Fixed at 90 days	Fixed at 90 days

Identity differs between SDKs

Wire field	Web	Node.js	iOS	React Native
Anonymous ID	`visitor_id`	`anonymousId`	`anonymousId`	`anonymousId`
Anonymous ID format	`anon_<uuid>`	`anon_<uuid>`	`anon_<UUID>`	`anon_<uuid>`
Identified ID	`user_id`	`userId`	`userId`	`userId`
Resolved identity	`distinct_id`	Not sent	Not sent	Not sent
Session	`session_id`	No session concept	`context.session_id`	`context.session_id`

To join a server event to a browser visit, read datalyr.getVisitorId() in the browser. Pass that value as anonymousId from your server.

Authentication differs between SDKs

SDK	Credential	Where it goes
Web	Workspace ID	`data-workspace-id`, or `init({ workspaceId })`
Node.js	Write key, `dk_…`	The `X-API-Key` header
iOS	Write key, `dk_…`	The `X-API-Key` header
React Native	Write key, `dk_…`	The `X-API-Key` header

Copy the workspace ID from Settings → Install. Generate a write key under Settings → API. See API keys.

Use the write key, not the agent key. An agent key starts dk_agent_ and authenticates the read API only. Keep the write key on a server, since a write key in browser code lets anyone write to your workspace.

Choose an SDK

Web

Page views, campaign parameters, 15 click IDs, and Stripe link decoration.

Node.js

Trusted server events, with idempotency and drop callbacks.

iOS

Native Swift, with SKAdNetwork, Apple Search Ads, and App Tracking Transparency.

React Native

React Native and Expo, with Play Install Referrer and SKAdNetwork.

Verify

Install one SDK. Open Events. Confirm the first event arrives within 30 seconds. If nothing arrives, see No events.

​Time units differ between SDKs

​Identity differs between SDKs

​Authentication differs between SDKs

​Choose an SDK

Web

Node.js

iOS

React Native

​Verify

Time units differ between SDKs

Identity differs between SDKs

Authentication differs between SDKs

Choose an SDK

Verify