Introduction

​

Installation

npm install @content-ignite/mobile-sdk-react-native

​

Android Prerequisites

​

Requirements

• Minimum SDK version of 24 or higher
• Compile SDK version of 36 or higher

​

iOS Prerequisites

​

Requirements

• Use Xcode 16.0 or higher.
• Target iOS 17.2 or higher.

​

Updating your Info.plist

1. Before installing, update the application Info.plist to add a GADApplicationIdentifier key with a string value of your Google Ad Manager app ID, of the form ca-app-pub-################~##########.

2. Next add a SKAdNetworkItems key to your Info.plist with SKAdNetworkIdentifier values for Google (cstr6suwn9.skadnetwork) and select third-party buyers who have provided these values to Google.

​

Initialisation

​

Required

• publisherId: string: A unique identifier for the publisher in the Fusion platform, provided by Content Ignite.
• googleId: string: Your Google Ad Manager app ID, of the form ca-app-pub-################~##########. Plug-and-play customers use the ID provided by Content Ignite; SaaS customers use their own Google Ad Manager account app ID — contact Content Ignite if you are unsure which applies.
• debugFeature: boolean: Enables the in-app debug menu — see Using the Debug features.

​

Optional

• testAds: boolean: Serve test creatives instead of live ads during development. Defaults to false.
• appOpenPlacementId: string: Enables App Open ads via the CIAppOpenAd API — see App Open.

import ContentIgniteSDK from '@content-ignite/mobile-sdk-react-native';

export default function App() {
  const [isSDKInitialised, setIsSDKInitialized] = useState(false);

  useEffect(() => {
    initializeSDK();
  }, []);

  const initializeSDK = async () => {
    try {
      await ContentIgniteSDK.initialise({
        publisherId: '<PUBLISHER-ID>',
        googleId: "ca-app-pub-3940256099942544~3347511713",
        appOpenPlacementId: "<APP-OPEN-PLACEMENT-ID>",
        testAds: true,
        debugFeature: true,
      }).then(() => {
        console.log('SDK initialized');
      setIsSDKInitialized(true);
      });
    } catch (error) {
      console.error('Failed to initialize SDK:', error);
      setIsSDKInitialized(false);
    }
  }
  ...

​

Select an ad format