React Native

@trueorigin/react-native is an Expo module around the TrueOrigin iOS and Android SDKs. On web every call is a no-op and the attribution status is unsupported. Requirements: Expo SDK 53 or later (any Expo app, or a bare React Native app with Expo Modules installed); iOS 15.1 or later and Xcode 16 or later; Android 7.0 (API 24) or later.

Install

npx expo install @trueorigin/react-native
npx expo prebuild   # or: npx expo run:ios / run:android, or an EAS build

The module needs a new native build. It is not part of Expo Go.

Configure

Your SDK key is shown when you create the app, and can be rotated in the dashboard under Settings → SDK key. It is a public client key, like RevenueCat’s: keep it in your app’s public config.

import TrueOrigin from '@trueorigin/react-native'

// as early as possible, e.g. at the top of your root layout
TrueOrigin.configure('to_…')

On Android, the app’s Android URL in the dashboard must be its Google Play URL: see how Android installs match. Next: read the attribution in your app.

Options

TrueOrigin.configure('to_…', {
  logging: __DEV__,     // iOS: unified logging, subsystem dev.trueorigin.sdk; Android: Logcat, tag TrueOrigin
  reportTimeout: 21600, // seconds to keep retrying the first report
})

API


`configure(apiKey, options?)`	Start the SDK. Only the first call counts.
`attribution()`	Promise of the final attribution. Never rejects.
`onAttribution(handler)`	Callback form; returns a cancel function.
`currentAttribution()`	The stored attribution, without waiting.
`installId()`	The SDK’s id for this install. `null` on web, and on Android before `configure`.
`revenueCatAttributes()`	Attributes for RevenueCat, see RevenueCat. `{}` on web, and on Android before `configure`.
`isAvailable`	Whether the native SDK is linked.
`sdkVersion`	Version of the bundled native SDK on this platform.

Types are exported: Attribution, AttributionStatus, ConfigureOptions.

Universal Links

Universal Links are optional and iOS only. To use them, add the associated domain in app.json, then follow Universal Links for the dashboard side:

{
  "expo": {
    "ios": {
      "associatedDomains": ["applinks:appdownload.link"]
    }
  }
}

Privacy

The package contains the same binaries as the native SDKs: the iOS SDK with its privacy manifest, and the Android SDK. It does not read the IDFA, the IDFV, Android’s advertising ID or the Android ID. For Google Play’s Data safety form, see Google Play Data safety.

Get started

SDK

Campaigns

Help

Install

Configure

Options

API

Universal Links

Privacy

​Install

​Configure

​Options

​API

​Universal Links

​Privacy

Install

Configure

Options

API

Universal Links

Privacy