Skip to main content

개요

Adrop iOS SDK를 사용하여 다양한 광고 포맷을 앱에 표시할 수 있습니다.

지원 광고 포맷

요구 사항

  • 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 입력:
  1. Add Package 클릭
백필 광고를 사용하려면 추가 패키지를 등록하세요:

CocoaPods

  1. Podfile이 없으면 생성:
  1. Podfile에 추가:
Podfile
  1. 설치:
  1. .xcworkspace 파일로 프로젝트 열기

Info.plist 설정

백필 광고를 위해 Info.plist에 다음 설정을 추가합니다:
  • GADApplicationIdentifier: 백필 광고용 App ID
  • SKAdNetworkItems: iOS 14 이상에서 광고 전환 추적에 필요
Info.plist
기존 Info.plist에 이미 SKAdNetworkItems 키가 있다면 새로 추가하지 말고 배열(<array>) 항목만 병합하세요. 동일 키를 두 번 두면 iOS는 첫 번째 배열만 사용합니다.
전체 SKAdNetworkItems 목록과 App ID 발급은 에이드랍에 문의해주세요.

초기화

AppDelegateapplication(_:didFinishLaunchingWithOptions:)에서 SDK를 초기화합니다.

초기화 파라미터

배포 전 반드시 production: true로 설정하세요. false로 배포하면 광고가 노출되지 않습니다.

사용자 설정

UID 설정

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

테마 설정

다크 모드를 지원하는 광고를 위해 테마를 설정합니다. initialize() 호출 후 설정해야 합니다.
auto 모드는 시스템 다크 모드 설정을 자동으로 감지합니다. 테마가 변경되면 스플래시 광고 캐시가 자동으로 초기화됩니다.

WebView 지원

WKWebView를 등록하여 WebView 내에서 웹 광고를 표시할 수 있습니다.
Adrop.sdkVersion을 사용하여 현재 SDK 버전을 확인할 수 있습니다.

딥링크 처리

외부 링크를 통해 앱이 실행된 경우 딥링크를 처리합니다.

테스트 유닛 ID

개발 중에는 테스트 유닛 ID를 사용하세요. 프로덕션 배포 전 실제 유닛 ID로 교체해야 합니다.

배너 광고

네이티브 광고

전면/보상형 광고

팝업 광고

스플래시 광고


에러 코드

광고 로드 실패 시 반환되는 주요 에러 코드입니다. 자세한 에러 코드는 레퍼런스를 참조하세요.

목차

배너 광고

배너 광고 구현하기

네이티브 광고

네이티브 광고 구현하기

전면 광고

전면 광고 구현하기

보상형 광고

보상형 광고 구현하기

팝업 광고

팝업 광고 구현하기

스플래시 광고

스플래시 광고 구현하기

WebView 가이드

WebView에서 웹 광고 표시

UMP 연동

GDPR/CCPA 동의 관리

타겟팅 설정

사용자 속성 및 문맥 타겟팅

레퍼런스

클래스, Delegate, 에러 코드

예제

예제 레포지토리