React Native

The Ezoic React Native SDK lets you use Ezoic mobile app ads from React Native while relying on the native Android and iOS SDKs for ad loading, Prebid, Google Ad Manager, consent handling, pageview tracking, and remote configuration.

The React Native package is a bridge over the native SDKs. It does not reimplement the ad stack in JavaScript.

Requirements 🔗

• React Native 0.72 or higher
• Android SDK 24 or higher for Android apps
• iOS 14.0 or higher for iOS apps
• Google Mobile Ads application ID provided by Ezoic
• Native Android and iOS Ezoic SDK access for the platforms you support

Installation 🔗

Install the React Native package version provided by Ezoic:

npm install @ezoic/react-native-sdk

Then install iOS pods if your app supports iOS:

cd ios
pod install

Platform Setup 🔗

React Native apps still need the native platform setup required by Android and iOS.

Android 🔗

Follow the Android setup requirements in the Android guide, including:

• Making sure Gradle can resolve the Ezoic Android SDK dependency
• Adding the Google Mobile Ads application ID to AndroidManifest.xml
• Adding the advertising ID permission if your app targets Android 12 or higher and uses the advertising ID

The Google Mobile Ads application ID is usually provided by Ezoic and can be found in your Ezoic dashboard.

iOS 🔗

Follow the iOS setup requirements in the iOS guide, including:

• Installing the Ezoic iOS SDK version provided for your app
• Adding the Google Mobile Ads application ID to Info.plist
• Adding NSUserTrackingUsageDescription if your app uses App Tracking Transparency
• Adding any required SKAdNetwork identifiers

The Google Mobile Ads application ID is usually provided by Ezoic and can be found in your Ezoic dashboard.

Initialize the SDK 🔗

Initialize Ezoic before rendering ads.

import { EzoicAds } from '@ezoic/react-native-sdk';
import { useEffect } from 'react';

export function App() {
    useEffect(() => {
        EzoicAds.initialize({
            domain: 'example.com',
            apiKey: 'your-api-key',
            siteId: 'your-site-id',
            debugEnabled: false,
            testMode: false
        });
    }, []);

    return null;
}

domain is used by the Android SDK. apiKey and siteId are used by the iOS SDK. Use the values provided for your app in Ezoic.

Add a Banner Ad 🔗

Render EzoicBannerView where the banner should appear.

import { EzoicBannerView } from '@ezoic/react-native-sdk';
import { SafeAreaView } from 'react-native';

export function ArticleScreen() {
    return (
        <SafeAreaView>
            <EzoicBannerView
                adUnitIdentifier="12345"
                size="300x250"
                style={{ width: 300, height: 250 }}
                onLoad={() => console.log('Ezoic banner loaded')}
                onError={(error) => console.warn('Ezoic banner failed', error)}
            />
        </SafeAreaView>
    );
}

Replace 12345 with your Ezoic ad unit identifier. The native SDKs fetch the Google Ad Manager ad unit, Prebid configuration, targeting values, supported sizes, and refresh interval from Ezoic servers.

Banner Events 🔗

EzoicBannerView supports these event props:

• onLoad
• onError
• onImpression
• onClick
• onOpen
• onClose

Privacy and Consent 🔗

The native SDKs can automatically read platform consent signals when they are set by a consent management platform. You can also set consent manually from React Native:

await EzoicAds.setGDPRConsent(true, 'TCF_CONSENT_STRING');
await EzoicAds.setGPPConsent('GPP_STRING', '7');
await EzoicAds.setSubjectToCOPPA(false);

For platform-specific consent behavior, see the Android privacy section and iOS privacy section.

Pageview Tracking 🔗

The native SDKs handle their platform-specific automatic pageview tracking. If your React Native app uses JavaScript navigation, you can also track a pageview manually when the active route changes:

await EzoicAds.trackPageview();

Troubleshooting 🔗

SDK Not Initializing 🔗

1. Confirm Android has a valid domain and iOS has valid apiKey and siteId values.
2. Confirm the native Android/iOS Ezoic SDK dependencies are installed for the platform you are building.
3. Enable debugEnabled: true and review platform logs.

Ads Not Loading 🔗

1. Initialize Ezoic before rendering EzoicBannerView.
2. Confirm the Ezoic ad unit identifier is configured in Ezoic.
3. Confirm the Google Mobile Ads application ID is present in AndroidManifest.xml or Info.plist.
4. Check the platform-specific setup in the Android guide or iOS guide.