React Native / Expo

npm

npm install postback-react-native@2.0.1

# iOS only
cd ios && pod install

For Expo prebuild, add the config plugin to app.json and run npx expo prebuild. The plugin adds the required Android INTERNET / ACCESS_NETWORK_STATE / AD_ID permissions and does not add an iOS tracking-usage description.

Published on npm. Always use the latest version.

import { Platform } from 'react-native';
import { Postback } from 'postback-react-native';

// Call as early as possible. App.tsx, root layout, or _layout.tsx.
await Postback.configure({
  apiKey: Platform.select({
    ios: 'pb_ios_live_xxxxx',
    android: 'pb_android_live_xxxxx',
  })!,
});

Non-blocking. configure() resolves after local state is restored; install registration runs in the background on the native side. Lifecycle observers register automatically.

// Standard event
await Postback.sendEvent('login');

// Revenue event. Currency must be exactly three ASCII letters.
await Postback.sendEvent('purchase', null, {
  revenue: 9.99,
  currency: 'USD',
});

// Custom event with parameters
await Postback.sendEvent('custom', 'level_complete', {
  level: 5,
  score: 1200,
});

• Custom events require a trimmed, non-empty name of 1-255 UTF-16 code units with no U+0000 character. Invalid custom events are not queued.
• For standard event types, an invalid optional name is omitted and the event is still queued.
• Currency must be exactly three ASCII letters. Lowercase values are normalized to uppercase; an invalid currency field is omitted and the event is still queued.

Once install registration completes, the SDK caches the attribution result from the install response. Native iOS and Android expose synchronous getters; React Native and Flutter bridge calls are asynchronous.

const attr = await Postback.getAttribution();
console.log(attr?.source);         // "apple_ads", "tracking_link", or "organic"
console.log(attr?.isAttributed);   // boolean
console.log(attr?.campaignName);   // Campaign name when available
console.log(attr?.appleAds?.campaignId);
console.log(attr?.link?.name);

Send a test event to confirm end-to-end delivery. You should see it in the Postback dashboard within seconds.

const result = await Postback.sendTestEvent();
console.log(result.success, result.message);