Adrop에 iOS 앱 등록하기

사전 준비사항

다음을 설치해주세요.

• Xcode 14.1 혹은 그 이상의 버전

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

• iOS 13 혹은 그 이상의 버전

• Swift 5.0 혹은 그 이상의 버전

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

---

1. Adrop 프로젝트 생성

먼저 iOS 앱에 연결할 Adrop 프로젝트를 만들어주세요.

2. Adrop에 앱 등록하기

iOS를 위한 Adrop 콘솔을 사용하기 위해 '프로젝트'에 iOS 앱 등록이 먼저 필요합니다.

앱에서 실제로 사용하는 Bundle ID를 정확히 입력했는지 한 번 더 확인해주세요. Bundle ID는 대소문자를 구분하며 한번 등록된 후에 Adrop iOS 앱에 대해 변경할 수 없습니다.

1. Adrop 콘솔로 이동해주세요.

2. 프로젝트 페이지 상단 중앙에 Apple 아이콘을 클릭해서 설치를 시작해주세요.

3. Bundle ID 입력란에 Bundle ID를 입력해주세요.

   • Bundle ID는 사용자의 디바이스 및 Apple의 환경에서 앱을 고유하게 식별하는 이름입니다.

   • Xcode에서 .xcodeproj 파일을 열어서 TARGET을 선택하고 General 탭을 확인해주세요. Bundle Identifier가 보입니다. 개발하실 앱의 Bundle Identifier 문자열을 복사해서 플랫폼 추가할 때 입력해주세요.

     • 예시 : com.yourcompany.yourproject

4. 앱 닉네임을 입력해주세요.

   • 앱 닉네임 : Adrop 콘솔에서 본인에게만 표시되는 내부 편의를 위한 식별자입니다.

5. '앱 등록'을 클릭하세요.

3. Adrop 설정 파일 추가하기

1. adrop_service.json 을 다운로드해서 Adrop Apple 플랫폼 설정 파일을 받으세요.

2. 설정 파일을 Xcode 프로젝트의 루트로 이동하세요. 프롬프트가 완료되면 모든 대상에 설정 파일을 추가하도록 선택합니다.

   

4. 앱에 Adrop SDK 추가하기

CocoaPods을 활용해 Adrop dependency를 설치하고 관리하세요.

아래는 CocoaPods을 활용해 Adrop을 설치하는 방법입니다.

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

pod init

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

pod 'adrop-ads'

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

pod install --repo-update

open your-project.xcworkspace

5. Adrop 초기화(initialize)하기

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

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

Swift

import AdropAds
// ...

Objective-C

@import AdropAds;
// ...

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

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

Swift

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

Objective-C

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

3. 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()
      }
    }
  }
}

다음 단계

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

광고유닛 등록 방법을 알려드릴게요.

---

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