Mobana Documentation

Everything you need to integrate attribution, conversion tracking, and in-app flows into your React Native app.

Mobana is a lightweight mobile attribution and deeplinking solution designed to simplify integration and give you complete visibility into your marketing performance.

Quick Example#

App.tsx
import { Mobana } from '@mobana/react-native-sdk';

// Initialize once on app start (attribution starts in the background)
Mobana.init({ appId: 'YOUR_APP_ID', appKey: 'YOUR_APP_KEY' });

// --------------------- Attribution ---------------------
// Get attribution data (usually already cached from init)
const { attribution } = await Mobana.getAttribution();

if (attribution) {
  console.log('Install source:', attribution.utm_source);
  console.log('Campaign:', attribution.utm_campaign);
}

// --------------------- Conversions ---------------------
// Track post-install events (fire and forget — queued if offline)
Mobana.trackConversion('signup');
Mobana.trackConversion('purchase', 49.99);

// --------------------- Flows ---------------------------
// Show an in-app flow and react to the result
const result = await Mobana.startFlow('onboarding', {
  params: { userName: user.name },
});

if (result.completed) {
  // Link any follow-up purchase to this flow session
  Mobana.trackConversion('purchase', 29.99, result.sessionId);
} else if (result.dismissed) {
  console.log('User dismissed the flow');
}

See the Quick Start guide for a complete walkthrough.

Key Features#

  • Privacy-focused — No device IDs (IDFA/GAID) required. Uses probabilistic matching and Android Install Referrer.
  • Simple integration — Single SDK for attribution, conversions, and flows. 5-minute setup.
  • TypeScript-first — Full type definitions with generics for custom data types.
  • Offline support — Conversions are queued and sent when connection is available.
  • Custom endpoints — Proxy through your domain for cleaner URLs and ad-blocker bypass.

Getting Help#

If you have questions or need help integrating Mobana, reach out at [email protected].

AI agents: for complete Mobana SDK & API documentation, get full context here or visit llms.txt