Skip to main content
애드유닛은 앱에서 광고를 표시할 지면과 광고 포맷을 설정한 단위입니다. DARO 2.0.1 SDK에는 업데이트된 대시보드의 Ad Unit Key를 복사해 입력하세요. 앱 설정에 쓰는 Integration Key와는 다른 값입니다. API 인자 adUnitId, unitId, key와 예제의 YOUR_AD_UNIT_ID는 이름을 그대로 사용하지만, 입력할 값은 해당 애드유닛의 Ad Unit Key입니다. 기존 애드유닛 ID를 사용한 연동도 계속 지원합니다. 리포트·콜백의 식별자를 새 연동용 키와 혼동하지 마세요.

시작하기 전에

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

요구사항

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

SDK 설치하기

DARO 2.0.1 SDK는 CocoaPods 또는 Swift Package Manager(SPM)로 설치할 수 있습니다. 2.0.0 미만의 레거시 SDK를 사용 중이라면 먼저 iOS 마이그레이션 가이드를 진행하세요.
하나의 SDK로 모든 광고 포맷을 지원합니다. Swift에서는 import Daro, Objective-C에서는 DaroObjCBridge를 사용합니다.
Podfile의 앱 타겟에 다음 의존성을 추가하세요.
Objective-C 앱은 DaroAds 대신 DaroObjCBridge를 같은 버전으로 설치하세요.같은 Podfile에 다음 훅을 추가하세요. 이미 post_install 블록이 있다면 새 블록을 만들지 말고 기존 블록 안에 네 줄을 추가하세요.
앱 타겟이 사용하는 **프로젝트 소스의 Info.plist**에 대시보드에서 발급한 Integration Key를 추가하세요.
실제 Info.plist 파일을 두고 앱 타겟의 **Build Settings > Info.plist File (INFOPLIST_FILE)**이 해당 파일을 가리키도록 설정하세요. 자동 생성된 Info.plist만 사용하는 설정은 이 훅을 지원하지 않습니다. Debug와 Release가 서로 다른 파일을 사용한다면 각각에 키를 추가하세요.
다음 명령으로 SDK를 설치하고 앱에 필요한 설정을 적용하세요.
Integration Key를 변경하면 pod install을 다시 실행하세요. 훅 실행 중 오류가 발생하면 해결한 후 앱을 빌드하세요.

앱 설정하기

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