React Native AI ads SDK.
Monetize your React Native AI chatbot, companion, or agent app with Surfacedd. iOS and Android in one codebase. Works with Expo and bare React Native.
Install
npm install @surfacedd/react-native
Import
import { SurfaceddProvider, SponsoredAnswer } from '@surfacedd/react-native'Initialize
<SurfaceddProvider appId="app_xxx" platform="mobile">
{children}
</SurfaceddProvider>Fetch a sponsored answer
<SponsoredAnswer context={{ query: userMessage }} style={styles.ad} />Features
- Shared codebase for iOS and Android
- Expo SDK 50+ and bare React Native compatible
- Native-feeling SponsoredAnswer component (platform-specific styling)
- Offline-safe: queue impressions when network returns
- App Store and Play Store policy compliant ad disclosure
Install in three steps
- Install. Run npm install @surfacedd/react-native. If you are on Expo, also run expo install react-native-async-storage.
- Wrap your app. Wrap your App.tsx with SurfaceddProvider, passing your app ID and platform="mobile".
- Render inside chat messages. Drop SponsoredAnswer inside your FlatList or ScrollView chat UI. Pass the user query and an optional style prop for visual integration.
Frequently asked questions
Does the SDK work with Expo?
Yes. The @surfacedd/react-native package works with Expo SDK 50 and above, both in managed and bare workflows. No custom native modules required for the standard ad units.
Do I need to submit ads for App Store review?
Surfacedd ads comply with App Store 5.1 and Play Store User Data policies. The disclosure label ("Sponsored") is permanently visible, ad category filtering is supported, and no ads target users under 13. We maintain a reviewer submission guide you can reference during app review.
What's the performance overhead?
SponsoredAnswer adds ~8KB gzipped to your bundle. API latency is p50 ~80ms, p99 ~200ms on good mobile networks. Ads cache locally for 60 seconds so repeated queries do not round-trip.
Related SDKs
Ready to ship ads in your React Native app?
Join the waitlist for SDK access. 60% revenue share, no minimums, no contracts.