React Native SDK

Reflect SDK for React Native — a thin JS + native bridge over the shared ReflectCore engine. Mobile attribution, event tracking, deep linking, and SKAN for iOS and Android.

Installation

Install from GitHub, pinned to a tagged release — this package is not published to the public npm registry:

npm install github:bablu147/reflect-sdk-react-native#v2.0.4

This is an autolinked native module. On iOS, ReflectCore is not published on CocoaPods trunk, and CocoaPods will not follow this package's podspec dependency to a git source — so you must declare the pod explicitly in your ios/Podfile, pinned to the tag below:

pod 'ReflectCore', :git => 'https://github.com/bablu147/reflect-ios.git', :tag => '1.1.4'

Then install the pods:

cd ios && pod install

On Android, the shared core is pulled from JitPack. React Native 0.73+ resolves dependencies per-project, so add the repository to an allprojects block in your app's root android/build.gradle. A settings.gradle dependencyResolutionManagement block is ignored on RN 0.73+, so the build fails with Could not find com.github.bablu147:reflect-android:1.1.2. A native module cannot inject a repository into the consuming build, so this step is unavoidably yours:

// android/build.gradle — after the buildscript { } block
allprojects {
  repositories {
    maven { url 'https://jitpack.io' }   // com.github.bablu147:reflect-android
  }
}

Then rebuild the native app — a Metro/JS reload is not enough for a newly-added native module:

npx react-native run-android

The Android AAR brings its transitive dependencies (Play Install Referrer, App Set ID, ads-identifier) and R8 keep-rules automatically.

Requirements

• React Native >=0.71.0
• React >=18.0.0
• iOS 13+, Android (Google Play Services)
• Supports both Old Architecture (Bridge) and New Architecture (legacy bridge via the interop layer)
• Pulls the shared native core — com.github.bablu147:reflect-android:1.1.2 from JitPack on Android, the ReflectCore pod (~> 1.1, currently 1.1.4) on iOS

Quick start

import { Reflect } from '@reflect-sdk/react-native';

// Initialize once at app startup
Reflect.initialize({
  appKey:     'app_live_...',
  companyKey: 'co_live_...',
  baseUrl:    'https://api.reflect.cloud',
  // signingSecret: 'sec_...',  // optional — HMAC-signs ingest + surfaces attribution
});

With a signingSecret set, every event batch is HMAC-signed and posted to the authenticated /event endpoint; without one the SDK falls back to the unsigned /event/batch path. baseUrl already defaults to https://api.reflect.cloud. An app_open event is sent automatically on init. Events from this release carry sdk_version react-native-2.0.4 on the wire — use it to confirm in the dashboard that your build picked up the upgrade.

API reference

Event tracking

// Custom event
Reflect.trackEvent('level_complete', { level: 5, score: 12340 });

// Revenue
Reflect.trackRevenue({
  amount: 4.99,
  currency: 'USD',
  productId: 'gems_500',
  transactionId: 'txn_abc123',
});

// Attribute installs/revenue to an email (pass it RAW — the server hashes it;
// only sent while consent is not denied).
Reflect.setEmail('[email protected]');
Reflect.clearEmail();   // on logout

The SDK sends the event property bag on the wire as properties; the server maps it to its canonical props field, so props.email reaches attribution.

Deep linking

import { useEffect } from 'react';
import { Reflect } from '@reflect-sdk/react-native';

function App() {
  useEffect(() => {
    // Cold launch deep link (incl. server-resolved deferred links)
    Reflect.getInitialDeepLink().then(data => {
      if (data) navigate(data.path);
    });

    // Warm deep links
    const unsub = Reflect.onDeepLink(data => {
      navigate(data.path);
    });

    return unsub;
  }, []);
}

Android captures warm (onNewIntent) and cold-launch links automatically. On iOS, forward the URL callbacks from your AppDelegate into the module (ReflectModule.stashLaunchURL: / handleURL:) — see the package README for the exact hooks.

SKAN (iOS)

const result = await Reflect.updateConversionValue(42, 'high', false);
if (!result.success) console.warn('SKAN error:', result.error);

Standard events

Pre-built helpers with typed parameters:

import { signUpWith, levelCompleted, addedToCart, adShown } from '@reflect-sdk/react-native';

signUpWith('google');
levelCompleted(5, 12340);
addedToCart('gems_500', 4.99, 'USD');
adShown('admob', 'interstitial', 0.02, 'USD');

Global properties & audience

Reflect.setGlobalProperty('ab_group', 'variant_b');
Reflect.setAudience('whale', 'early_adopter');

Purchase & subscription

Reflect.trackPurchase({
  productId: 'gems_500',
  price: 4.99,
  currency: 'USD',
  receiptData: '<base64>',
});

Reflect.trackSubscription({
  productId: 'pro_monthly',
  price: 9.99,
  currency: 'USD',
  isTrial: true,
});

// Verify a receipt server-side without tracking (returns a typed result)
const result = await Reflect.verifyPurchase({
  productId: 'gems_500',
  transactionId: 'txn_abc123',
  receiptData: '<base64>',
});

Privacy (GDPR)

const deleted = await Reflect.deleteUserData();
// Clears local state + sends server deletion request