iOS 앱에 Adrop SDK 설치하기

OpenRhapsody/adrop-ads-example-iosGitHub

사전 준비사항

다음을 설치해주세요.

• Xcode 14.1 혹은 그 이상의 버전

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

• iOS 13 혹은 그 이상의 버전

• Swift 5.0 혹은 그 이상의 버전

이메일 또는 구글 계정을 통해 Adrop에 로그인하세요.

---

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

*생성된 플랫폼이 없다면, 플랫폼 배포 가이드를 참고하여 플랫폼을 생성해 주세요. *애드컨트롤에 앱 서비스 등록이 안되어 있다면, 앱 등록 가이드 를 확인해주세요.

1. Adrop 설정 파일 추가하기

설정 파일 준비하기 가이드를 참고해 주세요.

2. 앱에 Adrop SDK 추가하기

2-1. CocoaPods

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

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

pod init

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

pod 'adrop-ads'

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

pod install --repo-update

open your-project.xcworkspace

2-2. SPM

1. Xcode 에서 프로젝트를 엽니다.

2. 프로젝트 네비게이터에서 프로젝트 파일을 선택합니다.

3. 타겟을 선택합니다.

4. “General” 탭 내 “Frameworks, Libraries, and Embeded Content” 에서 “+” 버튼을 클릭하여 새 패키지를 추가합니다.'

5. “Add Package Dependency” 를 선택합니다.

6. 패키지의 GitHub URL을 입력하고 “Add Package” 버튼을 클릭합니다.

3. Adrop 초기화(initialize)하기

마지막으로, 초기화 코드를 앱에 추가해주세요.

OpenRhapsody/adrop-ads-example-iosGitHub

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

Swift

import AdropAds
// ...:

Objective-C

@import AdropAds;
// ...

1. App delegate의 application(_:didFinishLaunchingWithOptions:) 메소드에서 Adrop 공유된 인스턴스를 초기화합니다.

2. 앱의 사용 언어에 맞게 Adrop instance를 초기화해주세요.

Swift

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

Objective-C

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

1. 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. 광고 유닛 노출하기

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

광고 형식	아이콘	설명
iOS 배너 광고		서비스 화면 내에 특정 크기의 사각형 이미지로 표시되는 광고
iOS 전면 광고		사용자가 주요 화면을 전환할 때, 자연스럽게 전체 화면으로 표시되는 광고
iOS 보상형 광고		사용자에게 광고에 참여할 수 있는 기회를 제공하고 그 대가로 앱 내에서 보상을 지급하는 광고
iOS 네이티브 광고		노출되는 지면의 콘텐츠와 최대한 비슷한 방식으로 표시되는 광고
iOS 팝업 광고		사용자가 앱을 켤 때, 앱 홈 화면 위에서 팝업 형태로 표시할 수 있는 광고
iOS 스플래시 광고		사용자가 앱을 사용 중, 앱 화면이 나타나기 전후 전체 화면으로 표시되는 광고

---

(선택사항) 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