Getting Started

Before You Begin

Prepare these items before installing DARO Unity SDK:

iOS or Android app key from the DARO dashboard
Platform-specific DARO key file
Ad unit IDs for each ad format
Android or iOS build environment

Install SDK

Use DaroPackageInstaller.unitypackage for the recommended installation path.

Download Installer Package

Download DaroPackageInstaller.unitypackage from the GitHub Release.

Import into Unity Project

In Unity Editor, select Assets > Import Package > Custom Package, then import DaroPackageInstaller.unitypackage.

Confirm Package Installation

The installer adds the OpenUPM scoped registry, EDM4U, and so.daro.unity dependency to Packages/manifest.json.The latest so.daro.unity package version is 0.4.0 and uses EDM4U [email protected].

Run Integration Manager

In Unity Editor, open Assets > Daro > Integration Manager and validate your project setup.

The installer adds the OpenUPM registry to Packages/manifest.json and starts installing [email protected].

Configure Project

In Unity Editor, open Daro > Integration Manager and enter platform settings.

Create Settings Asset

In Integration Manager, select Create Settings Asset.

Enter iOS Settings

For iOS builds, enter iOS Daro App Key, iOS Key File, AdMob App ID, and ATT prompt text.

Enter Android Settings

For Android builds, enter Android Daro App Key and Android Key File.

Enable Android Build Templates

For Android builds, open Edit > Project Settings > Player > Android > Publishing Settings > Build in Unity Editor, then enable these options.

Custom Main Gradle Template
Custom Gradle Properties Template
Custom Gradle Settings Template

Unity creates these files after the options are enabled.

Assets/Plugins/Android/mainTemplate.gradle
Assets/Plugins/Android/gradleTemplate.properties
Assets/Plugins/Android/settingsTemplate.gradle

During the Android build, DARO Unity SDK applies the required Gradle plugins, minimum SDK setting, and ProGuard rules to the exported project.

Validate Settings

In Integration Manager, check validation results for the active build target.

When building for Android with Unity 6000.3.17f1 or newer, add the following setting to Assets/Plugins/Android/gradleTemplate.properties.

android.uniquePackageNames=false

Starting with Unity 6000.3.17f1, AGP 9.0 enables duplicate Android library namespace checks by default. The Pangle 7.7 pag-sdk and pag-sdk-ad AARs use the same com.bytedance namespace, so manifest merging can fail during processDebugMainManifest. This issue is separate from EDM4U dependency resolution failures.

App keys and key files are not passed to InitializeAsync(). Unity injects them into iOS Info.plist and Android AndroidManifest.xml or gradle.properties at build time.

Initialize SDK

Call DaroSdk.InitializeAsync() when your app starts.

using Daro;
using UnityEngine;

public sealed class GameBootstrap : MonoBehaviour
{
    private async void Start()
    {
        DaroSdk.HasGdprConsent = true;
        DaroSdk.SetUserId("user-12345");

        await DaroSdk.InitializeAsync();
        Debug.Log("Daro SDK ready");
    }
}

You can set privacy options and user ID before SDK initialization.

Use Ad Instances

Use fullscreen ad instances in this order:

Complete await DaroSdk.InitializeAsync().
Create the ad instance.
Register event handlers.
Call Load().
After load completes, check IsReady() and call Show().
Call Dispose() when the screen closes.

Banner ads are displayed automatically when Load() succeeds. Use Show() only to display a banner again after calling Hide().

SDK callbacks are delivered on Unity’s main thread. Constructors and public SDK methods such as Load(), Show(), Hide(), and Dispose() must also be called from the Unity main thread.

Call Dispose() explicitly when an ad instance is no longer needed. SDK 0.4.0 provides finalizer-based cleanup as a fallback, but cleanup timing is not guaranteed.

using Daro;
using UnityEngine;

public sealed class InterstitialAdHost : MonoBehaviour
{
    private const string AdUnitId = "your-ad-unit-id";
    private DaroInterstitialAd ad;

    private void OnEnable()
    {
        ad = new DaroInterstitialAd(AdUnitId);
        ad.OnAdLoaded += info => Debug.Log($"Loaded: {info.AdUnitId}");
        ad.OnAdFailedToLoad += error => Debug.LogWarning(error.Message);
        ad.Load();
    }

    public void Show()
    {
        if (ad != null && ad.IsReady())
        {
            ad.Show();
        }
    }

    private void OnDisable()
    {
        ad?.Dispose();
        ad = null;
    }
}

SDK Integration

How to Use DARO

FAQ

Getting Started

Before You Begin

Install SDK

Configure Project

Initialize SDK

Use Ad Instances

​Before You Begin

​Install SDK

​Configure Project

​Initialize SDK

​Use Ad Instances

Before You Begin

Install SDK

Configure Project

Initialize SDK

Use Ad Instances