Getting Started

An Ad Unit defines an ad placement and format in your app. For the DARO 2.0 SDK, copy the Ad Unit Key from the updated dashboard. This is different from the app’s Integration Key. API parameters such as adUnitId, unitId, and key, and example placeholders such as YOUR_AD_UNIT_ID, keep their names but take that Ad Unit’s Ad Unit Key. Existing integrations using Ad Unit IDs remain supported. Do not confuse reporting or callback identifiers with the key for a new integration.

Before You Begin

Important: SDK initialization is requiredBanner and native ads must be rendered only after SDK initialization completes. Rendering an ad component before initialization may cause an initialization error.Other formats such as interstitial and rewarded video ads must also be loaded after initialization.

Requirements

Android minSdkVersion: 23
iOS 15.1 or later

If your Android app’s minSdkVersion is below 26, configure core library desugaring in the app module (android/app/build.gradle or build.gradle.kts). See Android Getting Started for the setup.Without it, a class loading error can occur while reading the advertising ID on devices below API 26.The Expo config plugin does not apply this setting, so Expo projects must configure it too.

[email protected] uses Android so.daro:daro-sdk 2.0.0 and iOS DaroAds 2.0.0The wrapper and native SDK versions are managed independently.

Please double-check that your app-ads.txt file is configured correctly.

Supported Ad Formats

Banner/MREC
Native
Interstitial
Rewarded
Light Popup

Installing the Package

npm i [email protected]

Configuring an Expo Project

The unified SDK ships an Expo config plugin. Provide your Integration Key in the app config and the plugin applies the Android and iOS native setup during prebuild.

DARO native modules are not available in Expo Go. Use a development build or a prebuilt app.

Add the plugin to your Expo config

Keep your existing Expo config and add the DARO entry to expo.plugins. Each platform takes a single Integration Key.

app.json

{
  "expo": {
    "plugins": [
      [
        "react-native-daro",
        {
          "ios": {
            "daroIntegrationKey": "YOUR_INTEGRATION_KEY"
          },
          "android": {
            "daroIntegrationKey": "YOUR_INTEGRATION_KEY"
          }
        }
      ]
    ]
  }
}

On iOS you can override the App Tracking Transparency prompt with attUsageDescription. A default message is used when it is omitted.

Run prebuild or EAS Build

npx expo prebuild

If your project uses a dynamic Expo config, manage the app identifier through your existing Expo/EAS configuration.

Remove the 1.x key files and previous Expo key settings, then use daroIntegrationKey for each platform. For an existing app, follow the migration guide in order.

After configuring the Expo plugin, continue to Initializing the SDK.

Configuring a React Native CLI Project

If your project does not use the Expo config plugin, apply the build tools and Integration Key setup from Android Getting Started and iOS Getting Started. On Android, add the so.daro plugin and the so.daro:daro-sdk dependency to the app module. Match the Android SDK version specified on this page for the React Native package. Also add these React Native settings to android/gradle.properties, merging the entries with any existing ignore list.

android.useAndroidX=true
android.enableJetifier=true
android.jetifier.ignorelist=react-android,hermes-android

Use Kotlin Gradle plugin 2.2.20 or later. On iOS, use the package’s CocoaPods dependency. Follow iOS Getting Started to configure DaroIntegrationKey, SKAdNetworkItems, the tracking permission message, and the post_install hook, then run pod install from ios/. Keep the existing React Native post_install settings and add the hook to the same block.

Initializing the SDK

Complete your app’s consent flow before initialization and pass the user’s choice and your app’s applicability decision. The privacy values below must come from your app; the example does not assume opt-in. GDPR accepts optIn, optOut, notApplicable, or unknown; CCPA accepts optIn, optOut, or notApplicable; COPPA accepts child or notChild. Set COPPA before initialization. Include any previously supplied consent string when updating its status. Use the code below to initialize the SDK. Supply privacy as a stable object after the consent flow completes; creating a new object on each render would repeat this initialization effect.

import { useEffect, useState } from "react";
import { View } from "react-native";
import { AdBannerView, AdFormat, initialize, setGdpr, setCcpa, setCoppa } from "react-native-daro";
import type { DaroGdprStatus, DaroCcpaStatus, DaroCoppaStatus } from "react-native-daro";

type Privacy = {
  gdpr: DaroGdprStatus;
  ccpa: DaroCcpaStatus;
  coppa: DaroCoppaStatus;
  gdprConsentString?: string;
  ccpaConsentString?: string;
};

const BANNER_AD_UNIT_ID = "YOUR_BANNER_AD_UNIT_ID";

function App({ privacy }: { privacy: Privacy }) {
  const [isInitialized, setIsInitialized] = useState(false);

  useEffect(() => {
    async function startAds() {
      await setGdpr(privacy.gdpr, privacy.gdprConsentString);
      await setCcpa(privacy.ccpa, privacy.ccpaConsentString);
      await setCoppa(privacy.coppa);
      await initialize();
    }
    startAds()
      .then(() => setIsInitialized(true))
      .catch(console.error);
  }, [privacy]);

  // Render ad components only after initialization completes
  return (
    <View>
      {isInitialized && (
        <AdBannerView
          adFormat={AdFormat.BANNER}
          adUnitId={BANNER_AD_UNIT_ID}
        />
      )}
    </View>
  );
}

Best Practices

Managing SDK Initialization

Recommendations for managing the SDK efficiently and avoiding errors.

Call initialize() at app startup
- Initialize the SDK at your app entry point (App.js or index.js)
Track initialization state
- Keep the initialization result in state so you can control when ads render
Guard every banner and native ad component with conditional rendering
- Make sure ad components never render before initialization completes

Next Steps

Once integration and initialization are complete, continue to the guide for the ad format you want to use.

DARO 2.0 SDK Migration

SDK Integration

How to Use DARO

FAQ

Legacy SDK

Getting Started

Before You Begin

Requirements

Supported Ad Formats

Installing the Package

Configuring an Expo Project

Configuring a React Native CLI Project

Initializing the SDK

Best Practices

Managing SDK Initialization

Next Steps

​Before You Begin

​Requirements

​Supported Ad Formats

​Installing the Package

​Configuring an Expo Project

​Configuring a React Native CLI Project

​Initializing the SDK

​Best Practices

​Managing SDK Initialization

​Next Steps

Before You Begin

Requirements

Supported Ad Formats

Installing the Package

Configuring an Expo Project

Configuring a React Native CLI Project

Initializing the SDK

Best Practices

Managing SDK Initialization

Next Steps