SDK Overview

The Mobana React Native SDK provides attribution, conversion tracking, and in-app flows for mobile apps.

Introduction#

The Mobana SDK is a lightweight library that enables:

• Attribution — Track where users come from (campaigns, ads, referrals)
• Conversion Tracking — Measure key events like signups, purchases, and subscriptions
• In-App Flows — Display onboarding, paywalls, and surveys with native access

The SDK consists of a singleton class (Mobana) and an optional React provider (MobanaProvider) for displaying flows:

Mobana — Core class with static methods for initialization, attribution lookup, and conversion tracking. Works with any React Native architecture.
MobanaProvider — React context provider that renders flows using a WebView overlay. Required only if you're using flows.

Initialize the SDK with your app ID. Call once on app start.

Retrieve attribution data for the current device.

Send conversion events with revenue and metadata.

Display an in-app flow (onboarding, paywall, survey).

Preload a flow for instant display.

Enable or disable SDK tracking (for GDPR compliance).

Clear all stored data and generate a new install ID.

React component that enables flow display in your app.

A typical integration involves four steps:

Initialize — Call init() on app start with your app ID
Get attribution — Call getAttribution() to retrieve campaign, source, and referral data
Track conversions — Call trackConversion() when users complete key actions (signup, purchase, etc.)
Launch flows — Wrap your app in MobanaProvider and call startFlow() to display flows

Quick Start

New to Mobana? Check out the Quick Start guide for a step-by-step integration walkthrough.