마이그레이션 가이드

​

1. 대시보드 업데이트

• DARO 대시보드에서 전환할 앱을 확인하고 업데이트를 완료하세요.
• 해당 앱의 Integration Key와 Ad Unit Key를 확인하세요.

​

2. 기존 키 파일과 설정 제거

• 프로젝트에서 ios-daro-key.txt와 해당 파일의 타겟 연결, Copy Bundle Resources 항목을 제거하세요.
• 파일을 읽거나 복사하던 기존 빌드 스크립트도 제거하세요.
• 기존 DARO 연동을 위해 직접 입력한 앱 키 설정과 이전 키 주입 단계를 제거하세요.
• 새로운 Integration Key 설정 도구가 필요한 설정을 다시 적용하므로 이전 값을 수동으로 덮어쓰지 마세요.

​

3. DARO 연동 도구 설정

• 시작하기에서 사용하는 설치 방식을 선택하세요.
• CocoaPods: Podfile의 의존성을 변경하고 Integration Key용 post_install 훅을 추가하세요. 기존 훅이 있으면 같은 블록 안에 추가하세요.
• SPM: 패키지를 업데이트하고 같은 버전의 SDK ZIP에서 Scripts/daro 도구를 준비하세요.
• CocoaPods는 2.0.0 미만에서 사용하던 pod을 Podfile에서 제거한 뒤 DARO 2.0.1 SDK를 추가하세요.
• Swift 앱은 DaroAds, Objective-C 앱은 DaroObjCBridge이며, DaroM 계열을 사용하던 앱도 같은 pod으로 이동합니다.
• 버전은 시작하기에 안내된 값을 사용하세요.

# 제거 — 사용하던 줄만 해당합니다
pod 'DaroAds', '1.x.x'
pod 'DaroObjCBridge', '1.x.x'
pod 'DaroMAds', '1.x.x'
pod 'DaroMObjCBridge', '1.x.x'

​

4. Integration Key 및 앱 설정

• 앱 타겟이 사용하는 소스 Info.plist에 대시보드에서 발급한 키를 넣으세요.

<key>DaroIntegrationKey</key>
<string>YOUR_INTEGRATION_KEY</string>

• CocoaPods는 pod install --repo-update를 실행하세요.
• SPM은 다운로드한 도구로 소스 파일에 설정을 적용하세요.

./Scripts/daro platform-key --plist "/path/to/YourApp/Info.plist" --inject

• Debug와 Release가 서로 다른 Info.plist를 사용한다면 각 파일에 설정을 적용하세요.
• 자세한 절차는 시작하기를 따르세요.

​

SKAdNetworkItems 갱신

• DARO 2.0.1 SDK는 지원하는 광고 디맨드 구성이 2.0.0 미만과 다릅니다.
• 앱 Info.plist의 기존 SKAdNetworkItems 배열을 시작하기의 앱 설정하기에 있는 목록으로 교체하세요.
• 목록에 없는 디맨드는 SKAdNetwork 어트리뷰션을 받지 못합니다.
• 다른 SDK가 추가한 항목은 그대로 두고, 같은 SKAdNetworkIdentifier가 중복되면 하나만 남기세요.

​

5. app-ads.txt 업데이트

• app-ads.txt 설정 가이드에 따라 대시보드에서 제공하는 최신 내용을 게시하세요.
• 대시보드에 등록한 웹사이트에서 파일에 접근할 수 있는지 확인하세요.

​

6. SDK 의존성과 코드 변경

​

모듈과 초기화

• 2.0.0 미만의 레거시 SDK 의존성과 import를 제거하고 새 SDK만 사용하세요.
• Swift의 모듈 이름은 Daro이며 초기화 진입점은 DaroAds.shared입니다.

import Daro

DaroAds.shared.initialized { error in
    guard error == nil else {
        print("DARO initialization failed: \(String(describing: error))")
        return
    }
    // 이 콜백에서 초기화 성공을 확인한 뒤 광고를 로드하세요.
}

• Objective-C 앱은 DaroObjCBridge를 설치하고 다음 초기화 API를 사용하세요.

#import <DaroObjCBridge/DaroObjCBridge.h>
#import <DaroObjCBridge/DaroObjCBridge-Swift.h>

[[DaroObjCAds shared] initializeWithCompletion:^(NSError * _Nullable error) {
    if (error) {
        NSLog(@"DARO initialization failed: %@", error.localizedDescription);
        return;
    }
    // 초기화 성공 후 광고를 로드하세요.
}];

​

애드유닛과 콜백

• Swift 애드유닛은 DaroAdUnit(unitId:)로 생성하세요. 기존 placement 인자는 제거하세요.
• 리워드 비디오 광고의 setPlacement(_:) 및 Objective-C setPlacement: 호출은 제거하세요.
• 광고 수익 콜백 onPaidEvent는 광고 인스턴스에 등록하세요.
• 레거시 수익 플러그인(DaroRevenuePlugin.xcframework의 DaroPluginAdRevenue)과 registerPlugin(_:) 호출은 DARO 2.0.1 SDK에 없습니다. 프로젝트에서 해당 xcframework를 제거하고 수익 지표는 onPaidEvent로 받으세요.
• 개인정보 보호 설정은 개인 정보 보호 관리의 API로 적용하세요.

// 기존 (2.0.0 미만)
let unit = DaroAdUnit(unitId: "AD_UNIT_ID", placement: "PLACEMENT")
rewardedAd.setPlacement("PLACEMENT")
loader.registerPlugin(DaroPluginAdRevenue())

// DARO 2.0.1 SDK
let unit = DaroAdUnit(unitId: "AD_UNIT_ID")
rewardedAd.onPaidEvent = { revenue in
    print(revenue.valueMicros, revenue.currencyCode)
}

• 배너·네이티브는 자동 로드 시점에도 SDK 초기화가 완료되어 있어야 합니다.
• 화면을 먼저 생성해야 한다면 autoLoad: false로 생성하고 초기화 성공 후 loadAd()를 호출하세요.

​

광고 포맷별 확인

• 아래 가이드에 맞춰 앱에서 사용하는 포맷의 로드, 표시, 닫힘, 수익 콜백을 확인하세요.
• 리워드 비디오 광고는 보상 지급도 확인하세요.
• 배너 및 MREC
• 네이티브
• 인터스티셜
• 리워드 비디오 광고
• 앱 오프닝
• 라이트 팝업

​

배포 전 확인

• 업데이트한 앱에서 초기화와 사용 중인 모든 광고 포맷의 로드·표시·종료를 확인하세요.
• 리워드 비디오 광고의 보상 콜백과 서버 콜백을 사용한다면 함께 확인하세요.
• Info.plist의 Integration Key와 SKAdNetworkItems가 최신 값으로 반영되었는지 확인하세요.
• 2.0.0 미만의 레거시 SDK를 사용하는 배포 버전에는 기존 Ad Unit ID를 유지하세요.