메인 콘텐츠로 건너뛰기

​
개요

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

타겟 확인

파일 추가 시 모든 타겟이 선택되어 있는지 확인합니다.
adrop_service.json 파일이 없으면 SDK가 정상 동작하지 않습니다.

​
2. 유닛 ID 확인

콘솔의 Ad Unit 탭에서 광고 지면에 해당하는 유닛 ID를 확인합니다.

​
설치

​
Swift Package Manager (권장)

  1. Xcode에서 File > Add Package Dependencies… 선택
  2. 패키지 URL 입력:
https://github.com/OpenRhapsody/adrop-ads-pod
  1. Add Package 클릭
백필 광고를 사용하려면 추가 패키지를 등록하세요: 
https://github.com/OpenRhapsody/adrop-ads-backfill-pod

​
CocoaPods

  1. Podfile이 없으면 생성:
pod init
  1. Podfile에 추가:
Podfile
pod 'AdropAds'
pod 'AdropAdsBackfill'
  1. 설치:
pod install --repo-update
  1. .xcworkspace 파일로 프로젝트 열기

​
Info.plist 설정

백필 광고를 위해 Info.plist에 다음 설정을 추가합니다:
  • GADApplicationIdentifier: 백필 광고용 App ID
  • SKAdNetworkItems: iOS 14 이상에서 광고 전환 추적에 필요
Info.plist
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>

<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4fzdc2evr5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4pfyvq9l8r.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>2fnua5tdw4.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ydx93a7ass.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>5a6flpkh64.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>p78axxw29g.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v72qych5uu.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>ludvb6z3bs.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cp8zw746q7.skadnetwork</string>
    </dict>
</array>
전체 SKAdNetworkItems 목록과 App ID 발급은 에이드랍에 문의해주세요.

​
초기화

AppDelegate의 application(_:didFinishLaunchingWithOptions:)에서 SDK를 초기화합니다. 
import AdropAds

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        // SDK 초기화
        Adrop.initialize(production: false, useInAppBrowser: false, targetCountries: [])
        Adrop.setTheme(.auto)

        return true
    }
}

​
초기화 파라미터

파라미터타입기본값설명
productionBoolfalse프로덕션 모드 여부. 배포 시 true로 설정
targetCountries[String]?nil타겟 국가 코드 목록 (ISO 3166 alpha-2). nil이면 모든 국가
useInAppBrowserBoolfalse인앱 브라우저 사용 여부
배포 전 반드시 production: true로 설정하세요. false로 배포하면 광고가 노출되지 않습니다.

​
사용자 설정

​
UID 설정

타겟팅 광고를 위해 사용자 식별자를 설정합니다. 
Adrop.setUID("user_123")
타겟팅 광고가 정상 동작하려면 광고 지면 진입 전에 UID를 설정하세요.

​
테마 설정

다크 모드를 지원하는 광고를 위해 테마를 설정합니다. initialize() 호출 후 설정해야 합니다. 
// 라이트 모드
Adrop.setTheme(.light)

// 다크 모드
Adrop.setTheme(.dark)

// 시스템 설정 따르기 (권장)
Adrop.setTheme(.auto)
auto 모드는 시스템 다크 모드 설정을 자동으로 감지합니다. 테마가 변경되면 스플래시 광고 캐시가 자동으로 초기화됩니다.

​
WebView 지원

WKWebView를 등록하여 WebView 내에서 웹 광고를 표시할 수 있습니다. 
import WebKit
import AdropAds

Adrop.registerWebView(webView)
Adrop.sdkVersion을 사용하여 현재 SDK 버전을 확인할 수 있습니다.

​
딥링크 처리

외부 링크를 통해 앱이 실행된 경우 딥링크를 처리합니다. 
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else { return }
    Adrop.handleDeepLink(url: url)
}

​
테스트 유닛 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_INITIALIZESDK 초기화 필요
자세한 에러 코드는 레퍼런스를 참조하세요.

​
목차

배너 광고

배너 광고 구현하기

네이티브 광고

네이티브 광고 구현하기

전면 광고

전면 광고 구현하기

보상형 광고

보상형 광고 구현하기

팝업 광고

팝업 광고 구현하기

스플래시 광고

스플래시 광고 구현하기

WebView 가이드

WebView에서 웹 광고 표시

UMP 연동

GDPR/CCPA 동의 관리

타겟팅 설정

사용자 속성 및 문맥 타겟팅

레퍼런스

클래스, Delegate, 에러 코드

예제

예제 레포지토리