InfluTo React Native SDK

Track influencer referrals and conversions in your React Native app.

Prerequisites

You need a free InfluTo account to use this SDK.

1. Sign up at https://influ.to (free)
2. Create your app in the dashboard
3. Copy your API key from Settings → API Keys

Your API key starts with it_ (e.g., it_abc123...)

Installation

``bash
npm install @influto/react-native-sdk

or

yarn add @influto/react-native-sdk
`

Peer Dependencies:
`bash
npm install @react-native-async-storage/async-storage
`

Quick Start

$3

`typescript
import InfluTo from '@influto/react-native-sdk';

// In your App.js or root component
await InfluTo.initialize({
apiKey: 'it_abc123...', // Get from InfluTo dashboard
debug: __DEV__ // Enable logging in development
});
`

$3

`typescript
// During onboarding, check if user came from a referral
const attribution = await InfluTo.checkAttribution();

if (attribution.attributed) {
console.log('User came from:', attribution.referralCode);

// Show trial or special offer
showTrialPaywall(attribution.referralCode);
} else {
// Organic user - show regular paywall
showRegularPaywall();
}
`

$3

`typescript
// After user completes onboarding or you have their ID
await InfluTo.identifyUser('revenuecat_user_id_123');
`

$3

`typescript
// Track key events for analytics
await InfluTo.trackEvent({
eventType: 'trial_started',
appUserId: 'revenuecat_user_id_123',
properties: {
trial_days: 7,
product_id: 'monthly_subscription'
}
});
`

Complete Integration Example

`typescript
import React, { useEffect, useState } from 'react';
import InfluTo from '@influto/react-native-sdk';
import Purchases from 'react-native-purchases';

function App() {
const [hasReferral, setHasReferral] = useState(false);
const [referralCode, setReferralCode] = useState(null);

useEffect(() => {
async function setupInfluTo() {
// 1. Initialize InfluTo
await InfluTo.initialize({
apiKey: 'it_abc123...',
debug: __DEV__
});

// 2. Check attribution
const attribution = await InfluTo.checkAttribution();

if (attribution.attributed) {
setHasReferral(true);
setReferralCode(attribution.referralCode);

// 3. Store in RevenueCat for webhook attribution
await Purchases.setAttributes({
'influto_code': attribution.referralCode
});
}

// 4. Identify user when available
const customerInfo = await Purchases.getCustomerInfo();
await InfluTo.identifyUser(customerInfo.originalAppUserId);
}

setupInfluTo();
}, []);

// Show appropriate paywall based on attribution
const showPaywall = async () => {
const offerings = await Purchases.getOfferings();

if (hasReferral) {
// Show trial offering
const trialOffering = offerings.all['trial'] || offerings.current;
await RevenueCatUI.presentPaywall({ offering: trialOffering });

// Track event
await InfluTo.trackEvent({
eventType: 'trial_paywall_shown',
appUserId: customerInfo.originalAppUserId,
properties: { influto_code: referralCode }
});
} else {
// Show regular offering
await RevenueCatUI.presentPaywall();
}
};

return (

);
}
`

API Reference

$3

Initialize the SDK. Call once when app starts.

Parameters:
- config.apiKey (required): Your API key from InfluTo dashboard
- config.debug (optional): Enable debug logging (defaults to false)

Returns: Promise

$3

Check if user was referred by an influencer.

Returns: Promise

Example:
`typescript
const result = await InfluTo.checkAttribution();
// { attributed: true, referralCode: 'FITGURU25', clickedAt: '2025-12-01T10:30:00Z' }
`

$3

Identify user with their app user ID.

Parameters:
- appUserId (required): RevenueCat ID or your custom user ID
- properties (optional): Additional user properties

Returns: Promise

$3

Track custom analytics event.

Parameters:
- options.eventType (required): Event name
- options.appUserId (required): User ID
- options.properties (optional): Event properties
- options.referralCode (optional): Associated referral code

Returns: Promise

$3

Get list of active campaigns for this app.

Returns: Promise

$3

Get stored referral code (if any).

Returns: Promise

$3

Clear stored attribution data (useful for testing).

Returns: Promise

Integration with RevenueCat

InfluTo works seamlessly with RevenueCat:

1. Store referral code in RevenueCat attributes:
`typescript
const attribution = await InfluTo.checkAttribution();
if (attribution.attributed) {
await Purchases.setAttributes({
'influto_code': attribution.referralCode
});
}
`

2. Configure RevenueCat webhook in InfluTo dashboard

3. InfluTo automatically tracks subscription events and calculates commissions

Platform Support

- ✅ iOS 13.0+
- ✅ Android 5.0+ (API level 21+)
- ✅ Expo (managed & bare workflows)

Troubleshooting

Attribution not working?
- Ensure you called initialize() before checkAttribution()
- Check API key is correct
- Verify app is configured in InfluTo dashboard
- Check network connectivity

User not identified?
- Make sure you call identifyUser() after user completes onboarding
- Verify user ID matches what RevenueCat sends in webhooks

Promo Code Integration

InfluTo supports manual promo code entry for users who hear about codes via social media, podcasts, or word-of-mouth.

$3

`typescript
import { ReferralCodeInput } from '@influto/react-native-sdk/ui';

onValidated={(result) => {
if (result.valid) {
navigation.navigate('Paywall');
}
}}
onSkip={() => navigation.navigate('Paywall')}
/>
`

$3

`typescript
import InfluTo from '@influto/react-native-sdk';

// User enters code
const result = await InfluTo.applyCode('FITGURU30', userId);

if (result.valid && result.applied) {
// Code is validated AND set in RevenueCat automatically
showPaywall(result.campaign);
}
`

📚 Complete Promo Code Guide - Examples, customization, best practices

---

New in v1.1.0

✅ Manual promo code entry - Users can type codes in your app
✅ Pre-built UI component - with full customization
✅ Headless API - Build your own UI with validateCode(), setReferralCode(), applyCode()`
✅ Auto-prefill - Automatically fills code if user came via link
✅ Custom callbacks - React to validation results
✅ Full internationalization - Customize all labels and messages

---

Support

- Documentation: https://docs.influ.to
- Help Center: https://influ.to/help
- Email: hello@influ.to

License

MIT © InfluTo