메인 콘텐츠로 건너뛰기
애드유닛은 앱에서 광고를 표시할 지면과 포맷을 설정한 단위입니다. 대시보드의 Ad Unit Key를 광고 API에 입력하세요. 앱 설정에 쓰는 Integration Key와는 다른 값입니다. 기존 애드유닛 ID(UUID)도 계속 입력할 수 있습니다.

시작하기 전에

프로젝트에 DARO SDK를 통합하기 전에 필요한 사항들을 확인하세요.

요구사항

  • iOS 13.0 이상
  • Xcode 26 이상
app-ads.txt 파일 설정(링크)이 잘 되었는지 다시 한 번 확인해주세요.

SDK 설치하기

DARO 2.0.8 SDK는 Swift Package Manager(SPM) 또는 CocoaPods로 설치할 수 있습니다. 2.0.0 미만의 레거시 SDK를 사용 중이라면 먼저 iOS 마이그레이션 가이드를 진행하세요.
하나의 SDK로 모든 광고 포맷을 지원합니다. Swift에서는 import Daro, Objective-C에서는 DaroObjCBridge를 사용합니다.
2026년 12월 1일부터 신규 버전은 SPM으로만 배포됩니다Daro iOS SDK는 2026년 12월 1일부터 CocoaPods를 통한 신규 버전 배포를 종료합니다. 이후 최신 버전은 Swift Package Manager(SPM)으로 설치해 주세요.기존에 CocoaPods로 배포된 버전은 계속 설치·사용할 수 있으며, 해당 버전에 대한 지원도 유지됩니다. 기존 버전을 사용하는 앱은 즉시 전환하지 않아도 됩니다.
Xcode의 **File > Add Package Dependencies…**에서 다음 URL을 추가하고 버전을 2.0.8로 지정하세요.
앱 타겟에는 Swift용 DaroAds 또는 Objective-C용 DaroObjCBridgeAds product를 추가하세요.Package.swift에서 선언하는 경우:
SPM은 Integration Key 설정 도구를 자동 실행하지 않습니다. 동일 버전의 SDK ZIP을 다운로드하고 압축을 해제하세요. 압축에 포함된 Scripts/daro를 사용합니다.앱 타겟이 사용하는 **프로젝트 소스의 Info.plist**에 다음 값을 추가하세요. 실제 파일을 두고 **Build Settings > Info.plist File (INFOPLIST_FILE)**이 해당 파일을 가리키도록 설정하세요.
압축을 해제한 디렉터리에서 아래 명령을 실행하세요. 경로는 앱의 소스 Info.plist 경로로 바꾸세요.
명령이 성공한 뒤 앱을 빌드하세요. Debug와 Release가 서로 다른 파일을 사용한다면 각각에 실행하세요. Integration Key를 변경할 때도 다시 실행해야 합니다.
이 명령을 앱 빌드 단계에 추가하거나 빌드 산출물의 Info.plist에 실행하지 마세요. 프로젝트 소스에 설정을 적용한 뒤 빌드해야 합니다.
Swift와 Objective-C 모두 앱 타겟의 **Build Settings > Other Linker Flags (OTHER_LDFLAGS)**에 -ObjC를 추가하세요. 설정 방법을 참고하세요.

앱 설정하기

Integration Key 설정은 위 설치 방식에 따라 완료하세요. SKAdNetworkItems는 아래 내용을 앱의 Info.plist에 직접 추가해야 합니다.
❗ Info.plist 의 SKAdNetworkItems 들을 앱의 Info.plist 에 복사해 넣어주세요. 등록하지 않으면 광고 디맨드가 전환 성과를 보고 받지 못해 광고 효율이 낮아집니다. 광고 퍼포먼스에 큰 영향을 주기때문에 꼭! 넣어주세요.

Other Linker Flags 설정

-ObjC 플래그가 필요한 경우다음 중 하나라도 해당하면 앱 타겟의 Build Settings > Other Linker Flags (OTHER_LDFLAGS) 에 -ObjC 를 반드시 추가해야 합니다.
  • Objective-C 프로젝트
  • Swift Package Manager 로 DaroAds 또는 DaroObjCBridgeAds 를 사용하는 Swift 프로젝트 (광고 디맨드 어댑터 런타임 탐지를 위해 필수)
플래그가 없으면 SDK 가 정상 작동하지 않거나 일부 광고 디맨드가 로드되지 않습니다.
Xcode 프로젝트 설정에서 다음 단계를 진행하세요:
  1. Xcode에서 프로젝트 파일을 선택합니다
  2. Build Settings 탭을 선택합니다
  3. 검색창에 “Other Linker Flags”를 입력합니다
  4. Other Linker Flags 항목에 -ObjC를 추가합니다

SDK 초기화하기

중요: SDK 초기화 후 광고 로드모든 광고는 반드시 SDK 초기화가 완료된 후에 로드되어야 합니다. 초기화 전 광고를 요청하면 광고가 정상적으로 표시되지 않을 수 있습니다.
앱의 AppDelegate 파일에 다음 코드를 추가하세요.

currentWindow 크래시 방지

일부 광고 SDK에서 발생할 수 있는 currentWindow 관련 크래시일부 광고 SDK에서는 UIApplication.shared.delegate.window 접근 중 unrecognized selector sent to instance 예외가 발생할 수 있습니다. 이는 SceneDelegate나 SwiftUI 환경에서 AppDelegate에 window 프로퍼티가 정의되지 않은 경우 발생합니다.AppDelegate에 다음 변수를 추가해 문제를 방지하세요:

로그 레벨

DARO SDK는 다음과 같은 로그 레벨을 지원합니다:
  • .off: 로그 출력 없음
  • .error: 에러 로그만 출력
  • .debug: 모든 로그 출력 (개발 시 권장)

사용자 ID 설정

앱에서 사용자 식별이 필요한 경우 userId를 설정할 수 있습니다. 이 값은 광고 요청 시 함께 전송됩니다.

앱 음소거 설정

앱 오프닝, 배너, 인터스티셜 광고, 리워드 비디오 광고, 네이티브 광고 형식의 경우 setAppMuted 메서드를 사용하여 앱 볼륨이 음소거되었음을 DARO SDK에 알릴 수 있습니다.
네이티브 광고는 로드 시점의 음소거 상태를 동영상 재생에 적용합니다. 네이티브 광고를 로드하기 전에 setAppMuted를 호출하세요.
앱 음소거 사용 시 주의사항앱 음소거 설정 시 음소거 상태에서 재생이 불가한 일부 동영상 광고 소재가 요청에서 제외될 수 있어, 광고 풀이 소폭 감소하고 수익에 영향을 줄 수 있습니다.

주의사항

위치 기반 앱 업데이트 사용 시 주의사항위치 기반(Location-based) 앱 업데이트를 사용하여 앱을 백그라운드에서 실행하는 경우, 광고 지면을 가진 화면이 앱의 첫 화면이라면 앱이 활성화될 때 광고 로드 및 광고 지면을 보여주도록 별도 처리가 필요합니다.백그라운드 위치 업데이트 관련 Apple 문서: Handling Location Updates in the Background