메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://guide.daro.so/llms.txt

Use this file to discover all available pages before exploring further.

​
시작하기 전에

Unity 프로젝트에 DARO Unity SDK를 설치하기 전에 다음 항목을 준비하세요.
  • DARO 대시보드에서 발급한 iOS 또는 Android 앱 키
  • 플랫폼별 DARO key file
  • 사용할 광고 포맷별 광고 단위 ID
  • Android 또는 iOS 빌드 환경

​
SDK 설치하기

권장 설치 방법은 DaroPackageInstaller.unitypackage를 사용하는 것입니다.
1

Installer 패키지 가져오기

DaroPackageInstaller.unitypackage.zip 파일을 다운로드한 뒤 압축을 해제합니다.
2

Unity 프로젝트에 import하기

Unity Editor에서 Assets > Import Package > Custom Package를 선택한 뒤 DaroPackageInstaller.unitypackage를 import합니다.
3

패키지 설치 확인하기

Installer가 Packages/manifest.json에 OpenUPM scoped registry, EDM4U, so.daro.unity 의존성을 추가합니다.so.daro.unity 최신 패키지 버전은 0.1.0이며, EDM4U [email protected]을 사용합니다.
4

Integration Manager 실행하기

Unity Editor에서 Assets > Daro > Integration Manager를 열고 프로젝트 설정을 검증합니다.
Installer는 Unity 프로젝트의 Packages/manifest.json에 OpenUPM registry를 추가하고 [email protected] 설치를 시작합니다.

​
프로젝트 설정하기

Unity Editor에서 Daro > Integration Manager를 열고 플랫폼별 설정을 입력합니다.
1

Settings Asset 생성

Integration Manager에서 Create Settings Asset을 선택합니다.
2

iOS 설정 입력

iOS 빌드를 사용하는 경우 iOS Daro App Key, iOS Key File, AdMob App ID, ATT 문구를 입력합니다.
3

Android 설정 입력

Android 빌드를 사용하는 경우 Android Daro App Key, Android Key File을 입력합니다.
4

설정 검증

Integration Manager에서 현재 빌드 타겟의 설정 검증 결과를 확인합니다.
앱 키와 key file은 InitializeAsync()의 인자로 전달하지 않습니다. Unity 빌드 시점에 iOS Info.plist와 Android AndroidManifest.xml 또는 gradle.properties로 주입됩니다.

​
SDK 초기화하기

앱 시작 시점에 DaroSdk.InitializeAsync()를 호출합니다. 
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");
    }
}
개인정보 보호 설정과 사용자 ID는 SDK 초기화 전에도 설정할 수 있습니다.

​
광고 인스턴스 사용 흐름

광고 인스턴스는 다음 순서로 사용합니다.
  1. await DaroSdk.InitializeAsync()를 완료합니다.
  2. 광고 인스턴스를 생성합니다.
  3. 이벤트 핸들러를 등록합니다.
  4. Load()를 호출합니다.
  5. 로드 완료 후 IsReady()를 확인하고 Show()를 호출합니다.
  6. 화면이 사라질 때 Dispose()를 호출합니다.
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;
    }
}