Skip to main content

시작하기 전에

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

요구사항

  • iOS 13.0 이상
  • Xcode 26 이상 (1.1.56 부터, CocoaPods / SPM 모두 동일)
app-ads.txt 파일 설정(링크)이 잘 되었는지 다시 한 번 확인해주세요.

SDK 설치하기

Daro SDK 는 CocoaPods 또는 Swift Package Manager (SPM) 로 설치할 수 있습니다. 아래 탭에서 원하는 방식을 선택하세요.
Reward 앱 (DaroMAds / DaroMObjCBridge) 은 현재 CocoaPods 만 지원합니다. SPM 은 Non-reward 앱 (DaroAds, DaroObjCBridgeAds) 한정으로 1.1.56 부터 지원됩니다.

Non-reward 앱

Reward 앱

터미널에서 다음 명령어를 실행하여 설치하세요:

앱 설정하기

GADApplicationIdentifier, DaroAppKey 는 DARO 대시보드에서 ( AdMob Key, App Key ) 확인할 수 있습니다.
❗ Info.plist 의 SKAdNetworkItems 들을 앱의 Info.plist 에 복사해 넣어주세요. 등록하지 않으면 광고 디맨드가 전환 성과를 보고 받지 못해 광고 효율이 낮아집니다. 광고 퍼포먼스에 큰 영향을 주기때문에 꼭! 넣어주세요.

ios-daro-key.txt 파일 추가

Xcode 프로젝트에 제공받은 ios-daro-key.txt 파일을 추가합니다. 이 파일에는 SDK 설정 및 구성 관련 정보가 포함되어 있습니다. ⚠️ SDK를 초기화하기 위해서는 ios-daro-key.txt 파일이 프로젝트에 반드시 포함되어야 합니다.
ios-daro-key.txt 파일은 DARO 대시보드에서 앱을 등록하고 앱 리스트 표의 맨 오른쪽 Key File 열에서 Download 버튼 클릭하여 다운로드 받을 수 있습니다.
Xcode > BuildPhase 예시 Xcode ios-daro-key.txt 예시

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