iOS 앱에 Adrop SDK 설치하기

PreviousAndroid 퀘스트 광고 NextiOS 배너 광고

Last updated 4 days ago

iOS 앱에 Adrop SDK 설치하기

Adrop iOS SDK

Adrop iOS SDK - Example

사전 준비사항

다음을 설치해주세요.

Xcode 14.1 혹은 그 이상의 버전

Adrop은 최소한 다음의 환경에서 동작합니다.

iOS 13 혹은 그 이상의 버전
Swift 5.0 혹은 그 이상의 버전

Adrop SDK 를 설치하기 전에, 앱에 연결할 플랫폼에 앱등록이 선행되어져야 해요.

1. Adrop 설정 파일 추가하기

2. 앱에 Adrop SDK 추가하기

2-1. CocoaPods

CocoaPods을 활용해 Adrop dependency를 설치하고 관리하세요. 아래는 CocoaPods을 활용해 Adrop을 설치하는 방법입니다.

기존의 Podfile이 없다면, 신규 Podfile을 만들어주세요. 프로젝트 디렉토리의 루트에서 아래 코드를 실행해주세요.

pod init

Podfile에 대해 Adrop pod을 앱에 추가해주세요.

pod 'adrop-ads'

Pod을 설치하고 .xcworkspace 파일을 열어 Xcode의 프로젝트를 확인하세요.

pod install --repo-update

open your-project.xcworkspace

2-2. SPM

Xcode 에서 프로젝트를 엽니다.
프로젝트 네비게이터에서 프로젝트 파일을 선택합니다.
타겟을 선택합니다.
“General” 탭 내 “Frameworks, Libraries, and Embeded Content” 에서 “+” 버튼을 클릭하여 새 패키지를 추가합니다.'
“Add Package Dependency” 를 선택합니다.

3. Adrop 초기화(initialize)하기

마지막으로, 초기화 코드를 앱에 추가해주세요. 아래 깃헙에서 예제 코드를 확인하실 수 있습니다.

Adrop모듈을 UIApplicationDelegate에 Import해주세요.

import AdropAds
// ...:

@import AdropAds;
// ...

App delegate의 application(_:didFinishLaunchingWithOptions:) 메소드에서 Adrop 공유된 인스턴스를 초기화합니다.
앱의 사용 언어에 맞게 Adrop instance를 초기화해주세요.

// production 배포 시, 'true'를 사용하세요.
// 특정 국가에서 이 SDK를 사용하고 있다면, 
// ISO 3166 alpha-2 국가 코드 array를 전달하세요.
// 타겟 링크가 열리는 브라우저 설정이 필요하다면, useInAppBrowser 값을 바꿔주세요.
Adrop.initialize(production: false, targetCountries: [], useInAppBrowser: false)

// production 배포 시, 'YES'를 사용하세요.
// 특정 국가에서 이 SDK를 사용하고 있다면, 
// ISO 3166 alpha-2 국가 코드 array를 전달하세요.
[Adrop initializeWithProduction:NO targetCountries:@[]];

Swift UI를 사용하는 경우, application delegate를 생성하고 이를 UIApplicationDelegateAdaptor 또는 NSApplicationDelegateAdaptor를 통해 앱 구조체(struct)에 연결할 수 있습니다.

@main
struct YourApp: App {
  // Adrop 설정을 위해 app delegate을 등록하세요.
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Next Steps

1. 광고 유닛 등록하기

이제 광고 유닛을 등록하면 사용자에게 광고주의 직광고를 노출할 수 있어요.

2. 광고 유닛 노출하기

이미 등록된 광고 유닛이 있다면 광고를 노출해 보세요.

광고 형식

아이콘

설명

서비스 화면 내에 특정 크기의 사각형 이미지로 표시되는 광고

사용자가 주요 화면을 전환할 때, 자연스럽게 전체 화면으로 표시되는 광고

사용자에게 광고에 참여할 수 있는 기회를 제공하고 그 대가로 앱 내에서 보상을 지급하는 광고

노출되는 지면의 콘텐츠와 최대한 비슷한 방식으로 표시되는 광고

사용자가 앱을 켤 때, 앱 홈 화면 위에서 팝업 형태로 표시할 수 있는 광고

사용자가 앱을 사용 중, 앱 화면이 나타나기 전후 전체 화면으로 표시되는 광고

(선택사항) Troubleshooting

# Add this line to your Podfile
use_frameworks!

# ...
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|

        #...
        # Add this line to your Podfile
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
        end
    end
end

PreviousAndroid 퀘스트 광고 NextiOS 배너 광고

Last updated 4 days ago