개요
Adrop iOS SDK를 사용하여 다양한 광고 포맷을 앱에 표시할 수 있습니다.지원 광고 포맷
| 포맷 | 설명 |
|---|---|
| 배너 | 화면의 일부 영역에 표시되는 직사각형 광고 |
| 네이티브 | 앱 UI에 맞게 커스터마이징 가능한 광고 |
| 전면 | 화면 전체를 덮는 전면 광고 |
| 보상형 | 시청 완료 시 보상을 제공하는 동영상 광고 |
| 팝업 | 특정 시점에 팝업으로 표시되는 광고 |
| 스플래시 | 앱 시작 시 로고와 함께 표시되는 광고 |
요구 사항
- iOS 13.0 이상
- Xcode 14.1 이상
- Swift 5.0 이상
사전 준비
1. adrop_service.json 파일 추가
1
파일 다운로드
애드컨트롤 콘솔 > Admin > App 에서
adrop_service.json 파일을 다운로드합니다.2
프로젝트에 추가
다운로드한 파일을 Xcode 프로젝트 루트에 추가합니다.
3
타겟 확인
파일 추가 시 모든 타겟이 선택되어 있는지 확인합니다.
2. 유닛 ID 확인
콘솔의 Ad Unit 탭에서 광고 지면에 해당하는 유닛 ID를 확인합니다.설치
Swift Package Manager (권장)
- Xcode에서 File > Add Package Dependencies… 선택
- 패키지 URL 입력:
- Add Package 클릭
CocoaPods
- Podfile이 없으면 생성:
- Podfile에 추가:
Podfile
- 설치:
.xcworkspace파일로 프로젝트 열기
초기화
AppDelegate의 application(_:didFinishLaunchingWithOptions:)에서 SDK를 초기화합니다.
초기화 파라미터
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
production | Bool | false | 프로덕션 모드 여부. 배포 시 true로 설정 |
targetCountries | [String] | [] | 타겟 국가 코드 목록 (ISO 3166 alpha-2) |
useInAppBrowser | Bool | false | 인앱 브라우저 사용 여부 |
사용자 설정
UID 설정
타겟팅 광고를 위해 사용자 식별자를 설정합니다.타겟팅 광고가 정상 동작하려면 광고 지면 진입 전에 UID를 설정하세요.
테마 설정
다크 모드를 지원하는 광고를 위해 테마를 설정합니다.initialize() 호출 후 설정해야 합니다.
auto 모드는 시스템 다크 모드 설정을 자동으로 감지합니다. 테마가 변경되면 스플래시 광고 캐시가 자동으로 초기화됩니다.딥링크 처리
외부 링크를 통해 앱이 실행된 경우 딥링크를 처리합니다.테스트 유닛 ID
개발 중에는 테스트 유닛 ID를 사용하세요. 프로덕션 배포 전 실제 유닛 ID로 교체해야 합니다.배너 광고
| 포맷 | 테스트 유닛 ID |
|---|---|
| 배너 (320x50) | PUBLIC_TEST_UNIT_ID_320_50 |
| 배너 (320x100) | PUBLIC_TEST_UNIT_ID_320_100 |
| 캐러셀 배너 | PUBLIC_TEST_UNIT_ID_CAROUSEL |
| 배너 비디오 (16:9) | PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_16_9 |
| 배너 비디오 (9:16) | PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_9_16 |
네이티브 광고
| 포맷 | 테스트 유닛 ID |
|---|---|
| 네이티브 (이미지) | PUBLIC_TEST_UNIT_ID_NATIVE |
| 네이티브 비디오 (16:9) | PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_16_9 |
| 네이티브 비디오 (9:16) | PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_9_16 |
전면/보상형 광고
| 포맷 | 테스트 유닛 ID |
|---|---|
| 전면 | PUBLIC_TEST_UNIT_ID_INTERSTITIAL |
| 보상형 | PUBLIC_TEST_UNIT_ID_REWARDED |
팝업 광고
| 포맷 | 테스트 유닛 ID |
|---|---|
| 팝업 (하단) | PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM |
| 팝업 (중앙) | PUBLIC_TEST_UNIT_ID_POPUP_CENTER |
| 팝업 비디오 하단 (16:9) | PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM_VIDEO_16_9 |
| 팝업 비디오 하단 (9:16) | PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM_VIDEO_9_16 |
| 팝업 비디오 중앙 (16:9) | PUBLIC_TEST_UNIT_ID_POPUP_CENTER_VIDEO_16_9 |
| 팝업 비디오 중앙 (9:16) | PUBLIC_TEST_UNIT_ID_POPUP_CENTER_VIDEO_9_16 |
스플래시 광고
| 포맷 | 테스트 유닛 ID |
|---|---|
| 스플래시 | PUBLIC_TEST_UNIT_ID_SPLASH |
에러 코드
광고 로드 실패 시 반환되는 주요 에러 코드입니다.| 에러 코드 | 설명 |
|---|---|
ERROR_CODE_AD_NO_FILL | 노출 가능한 광고 없음 |
ERROR_CODE_NETWORK | 네트워크 연결 실패 |
ERROR_CODE_INVALID_UNIT | 잘못된 유닛 ID |
ERROR_CODE_INITIALIZE | SDK 초기화 필요 |