@advenue/react-native

React Native / Expo SDK for Advenue — the open-source, self-hostable mobile attribution platform (MMP). Tracks installs, sessions and in-app events, resolves deferred deep links, and feeds Advenue's attribution engine.

Install

npx expo install @advenue/react-native \
  react-native-mmkv expo-secure-store

The iOS and Android Expo native modules ship inside this package (ios/, android/) and are built by your app's own Gradle/Xcode build — no manual linking.

Quick start

import { Advenue } from '@advenue/react-native';
import { MMKV } from 'react-native-mmkv';
import * as SecureStore from 'expo-secure-store';

await Advenue.initialize({
  apiKey: 'apk_live_...',        // from your Advenue dashboard
  platform: 'ios',               // or 'android'
  mmkv: new MMKV(),              // offline event buffering
  secureStore: SecureStore,      // durable device identity
  // endpoint: 'https://ingest.your-domain.com',  // self-hosted only
});

Advenue.track('signup_completed', { plan: 'pro' });

The adv_ event-name prefix (e.g. adv_meta_aem) is reserved for Advenue-internal signals — don't name your own custom events with it. Such events are still accepted by track() (the pipeline relies on them) but are hidden from analytics surfaces like the dashboard's funnel event picker.

Deep links (Universal Links / App Links)

Add the config plugin so install-time deep links resolve on device:

// app.json
"plugins": [
  ["@advenue/react-native/plugin", { "domains": ["go.advenue.io"] }]
]

Docs

Full integration guide, event reference and self-hosting docs: docs.advenue.io

License

MIT — the SDK is intentionally MIT-licensed so it can ship inside any app. The Advenue server platform is licensed separately (AGPLv3).