Install in a mobile app

Add a native SDK to your app. It sends app_install, session_start, and session_end without more code.

Before you start

You need a write key from Settings → API, and a development build you can install on a clean device or simulator.

Your app	SDK	Reference
Native Swift	`DatalyrSDK` 2.1.10	iOS SDK
React Native or Expo	`@datalyr/react-native` 1.7.15	React Native SDK

Do not load the web snippet inside a WebView as a replacement for an SDK. The web tracker gets a separate visitor_id and cannot read install attribution.

Install

iOS
React Native

In Xcode, open File → Add Package Dependencies. Add https://github.com/datalyr/swift. Add the DatalyrSDK product to your app target.

import DatalyrSDK

// Call this once, at app launch. A second configure() creates a second SDK.
Task {
    try await DatalyrSDK.configure(apiKey: "dk_your_write_key")
}

# expo-modules-core is required in bare React Native too.
npm install @datalyr/react-native expo-modules-core
cd ios && pod install

// Use the named import. The default import is the class, not the singleton.
import { Datalyr } from '@datalyr/react-native'

await Datalyr.initialize({ apiKey: 'dk_your_write_key' })

Expo apps import from @datalyr/react-native/expo instead.

Install expo-modules-core in bare React Native too. The SDK loads a native module at import time and throws without it.

Set up the rest

Initialize once, at launch

Put the call in your app entry point. A second initialize() creates a second SDK.

Send a screen event on navigation

Call screen(). It sends an event named pageview, not screen.

Identify after sign-in

Pass the same user ID your backend and billing provider use.

Pass every deep link to the SDK

On iOS, call handleDeepLink(url). React Native reads links on its own.

Pass identity to your subscription SDK

Call getRevenueCatAttributes() or getSuperwallAttributes() after both SDKs start.

Call identify() once per signed-in person. A call with a different user ID runs reset() first, which rotates the anonymous ID and erases attribution and the journey.

Subscription revenue

Mobile purchases reach Datalyr through RevenueCat or Superwall, not the SDK.

Provider	Attribute the app must set	Guide
RevenueCat	`datalyr_id`, from `getRevenueCatAttributes()`	RevenueCat
Superwall	`datalyr_id`, from `getSuperwallAttributes()`	Superwall

Connect RevenueCat or Superwall, never both. Each writes the same event names for one store transaction, so your reports add the same purchase twice.

Web-to-app campaigns

A campaign that lands on a website before the App Store needs web tracking on the landing page as well. Datalyr matches the two by email or by IP, and records $web_attribution_matched. See app campaigns.

Verify

Delete the app, or reset the simulator.
Launch a fresh install.
Open Events in Datalyr.
Confirm app_install and session_start arrive within 30 seconds.
Open one screen. Confirm a pageview arrives.

When no event arrives

Symptom	Cause	Fix
No events at all	`initialize()` never ran	Call `getStatus()` and read `initialized`
No events, queue growing	The write key is wrong	Compare it against Settings → API
Events in development only	The release target lacks the key	Check the release build configuration
No `app_install` on relaunch	The install guard is already set	Delete the app before you test
Two `pageview` events per screen	Manual and automatic screen tracking both run	Remove one
Subscription revenue with no campaign	The app never set `datalyr_id`	Set it after both SDKs initialize

iOS SDK: every method, option, and limit.
React Native SDK: every method, option, and limit.
Verify your setup: test through to a delivered conversion.

Get started

Installation

Revenue

Using Datalyr

Advanced

Integrations

Account & billing

Troubleshooting

Install in a mobile app

Before you start

Install

Set up the rest

Subscription revenue

Web-to-app campaigns

Verify

When no event arrives

Next

​Before you start

​Install

​Set up the rest

​Subscription revenue

​Web-to-app campaigns

​Verify

​When no event arrives

​Next

Before you start

Install

Set up the rest

Subscription revenue

Web-to-app campaigns

Verify

When no event arrives

Next