iOS 프로젝트에서 AdMob 시작하기

이 빠른 시작 가이드는 AdMob을 사용하여 Firebase로 개발된 앱으로 수익을 창출하려는 게시자와 개발자를 대상으로 합니다. 앱에 Firebase를 포함할 계획이 없다면 독립형 AdMob 가이드를 참조하세요. % elif is_cpp %} 앱에 Firebase를 포함할 계획이 없다면 독립형 AdMob 가이드를 참조하세요.

아직 AdMob, Firebase, Google 애널리틱스를 함께 사용해 보지 않았다면 이렇게 사용할 때의 이점을 알아보세요.

시작하기 전에

Firebase 프로젝트와 Firebase 앱이 아직 없다면 Firebase 시작 가이드의 iOS 프로젝트에 Firebase 추가를 따릅니다.
Firebase 프로젝트에서 Google 애널리틱스가 사용 설정되어 있는지 확인합니다.
- 새 Firebase 프로젝트를 만드는 경우 프로젝트 생성 워크플로 중에 Google 애널리틱스를 사용 설정합니다.
- 기존 Firebase 프로젝트가 있지만 Google 애널리틱스를 사용 설정하지 않은 경우 > 프로젝트 설정의 통합 탭에서 Google 애널리틱스를 사용 설정할 수 있습니다.
참고: 앱에 Google 애널리틱스용 Firebase SDK를 추가하는 것은 선택사항이지만 적극 권장됩니다. Google 애널리틱스용 Firebase SDK를 추가할 때의 이점을 자세히 알아보세요.

1단계: AdMob 계정에서 앱 설정

앱을 AdMob 앱으로 등록합니다.
1. AdMob 계정에 로그인하거나 가입합니다.
2. AdMob에 앱을 등록합니다. 이 단계에서는 고유한 AdMob 앱 ID로 AdMob 앱을 만들며 이 ID는 이 가이드의 뒷부분에서 필요합니다.
앱에 모바일 광고 SDK를 추가하라는 메시지가 표시됩니다. 이 가이드의 뒷부분에서 이 작업에 대한 자세한 안내를 확인하세요.
AdMob 앱을 Firebase 앱에 연결합니다.

이 단계는 선택사항이지만 적극 권장됩니다. 사용자 측정항목을 사용 설정하고 AdMob 앱을 Firebase에 연결할 때의 이점을 자세히 알아보세요.

AdMob 계정의 앱 대시보드에서 다음 두 단계를 완료합니다.
1. AdMob이 AdMob 계정에서 선별된 분석 데이터를 처리하고 표시할 수 있도록 사용자 측정항목을 사용 설정합니다. 이 설정은 AdMob 앱을 Firebase에 연결하는 데도 필요합니다.
2. 기존 Firebase 프로젝트 및 Firebase 앱에 AdMob 앱을 연결합니다.
  
  Firebase 앱에 입력한 것과 동일한 번들 ID를 입력해야 합니다. Firebase 앱의 번들 ID는 > 프로젝트 설정의 내 앱 카드에서 확인할 수 있습니다.

2단계: `Info.plist` 파일에 AdMob 앱 ID 추가

앱의 Info.plist 파일에서 AdMob 앱 ID의 문자열 값이 포함된 GADApplicationIdentifier 키를 추가합니다.

라는 메시지가 나타나면서 앱이 비정상 종료됩니다.

프로그래매틱 방식으로 다음과 같이 변경할 수 있습니다.

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

또는 속성 목록 편집기에서 다음과 같이 수정할 수 있습니다.

속성 목록 편집기

3단계: 모바일 광고 SDK 추가 및 초기화

프로젝트의 Podfile에 Google 모바일 광고 SDK에 대한 종속 항목을 추가합니다.
```
pod 'Google-Mobile-Ads-SDK'
```
광고를 로드하기 전에 GADMobileAds.sharedInstance에서 startWithCompletionHandler: 메서드를 호출합니다.

이 메서드를 호출하면 SDK가 초기화되며 초기화가 완료되거나 제한 시간인 30초가 경과하면 완료 핸들러가 콜백됩니다. 이 메서드는 한 번만 호출하면 되지만 최대한 빨리, 가급적이면 Firebase를 초기화한 후 앱 실행 시 호출하는 것이 가장 좋습니다.
경고: startWithCompletionHandler:를 호출할 때 모바일 광고 SDK 또는 미디에이션 파트너 SDK에서 광고를 미리 로드할 수도 있습니다. 광고를 로드하기 전에 수행해야 할 작업이 있으면 모바일 광고 SDK를 초기화하기 전에 수행해야 합니다. 다음은 초기화 전에 필요할 수 있는 작업의 몇 가지 예시입니다.
- 유럽 경제 지역(EEA)에서 사용자 동의 얻기
- 요청별 플래그 설정(예: tagForChildDirectedTreatment 또는 tag_for_under_age_of_consent)
AdMob 문서에서 자세히 알아보세요.
다음은 AppDelegate에서 startWithCompletionHandler: 메서드를 호출하는 방법을 보여주는 예시입니다.
Swift
```
import Firebase
import GoogleMobileAds
...

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    // Use Firebase library to configure APIs.
    FirebaseApp.configure()

    // Initialize the Google Mobile Ads SDK.
    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}
```
Objective-C
```
@import Firebase;
@import GoogleMobileAds;
...

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Use Firebase library to configure APIs.
  [FIRApp configure];
  // Initialize the Google Mobile Ads SDK.
  [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
  return YES;
}

@end
```

4단계: 사용자 측정항목 및 분석 데이터 보기

초기화 후 모바일 광고 SDK는 자동으로 앱에서 분석 이벤트와 사용자 속성의 로깅을 시작합니다. 앱에 코드를 추가하거나 광고를 구현하지 않고도 이 데이터를 볼 수 있습니다. 이 분석 데이터는 다음 위치에서 볼 수 있습니다.

AdMob 계정의 사용자 측정항목 카드(홈 또는 앱 대시보드)에서는 평균 세션 시간, ARPU, 유지율 등의 수집된 분석 데이터에서 파생되고 선별된 사용자 측정항목을 볼 수 있습니다.
Firebase Console의 애널리틱스 대시보드에서는 집계된 통계와 주요 측정항목의 요약을 볼 수 있습니다. Google 애널리틱스용 Firebase SDK를 추가한 경우 Firebase Console에서 광고 캠페인의 전환을 표시하고 커스텀 잠재고객을 만들 수도 있습니다.

ARPU 및 ARPPU 측정항목을 더 잘 나타내기 위해 이러한 측정항목에 대한 수익 계산에 ecommerce_purchase라는 애널리틱스 커스텀 이벤트의 데이터를 포함할 수도 있습니다(방법 알아보기).

5단계: (선택사항) Google 애널리틱스 및 Firebase의 더 많은 기능 사용

더 많은 기회와 기능을 활용하여 앱 수익 창출 및 사용자 참여도를 개선하세요.

Google 애널리틱스용 Firebase SDK 추가 및 사용
- 앱에서 커스텀 이벤트 로깅을 구현합니다.
- 커스텀 광고 캠페인의 전환을 표시합니다.
- ARPU 및 ARPPU 측정항목의 수익 계산에 ecommerce_purchase 이벤트 데이터를 포함합니다.
자세한 내용은 AdMob 앱에서 Google 애널리틱스 및 Firebase 사용 가이드를 참조하세요.
앱에서 다른 Firebase 제품 사용

Google 애널리틱스용 Firebase SDK를 추가한 후 다른 Firebase 제품을 사용하여 앱의 광고를 최적화할 수 있습니다.
- 원격 구성을 사용하면 앱 업데이트를 게시하지 않고도 일일 활성 사용자 수의 제한 없이 무료로 앱의 동작과 모양을 변경할 수 있습니다.
- A/B 테스팅을 사용하면 앱 UI, 기능 또는 참여 캠페인의 변경사항을 테스트하여, 변경사항을 전반적으로 구현하기 전에 수익 및 유지율과 같은 주요 측정항목에 변경으로 인한 영향이 있는지 확인할 수 있습니다.

앱의 광고 수익 창출 최적화

소수의 일부 사용자를 대상으로 다양한 광고 형식이나 구성을 시도해 본 다음 모든 사용자를 대상으로 광고를 구현할지 데이터를 토대로 결정하세요. 자세한 내용은 다음 튜토리얼을 확인하세요.
- 새 광고 형식 채택 테스트(개요 | 구현)
- 광고 게재빈도 최적화(개요 | 구현)

6단계: 앱에 구현할 광고 형식 선택

AdMob에서 제공하는 다양한 광고 형식 중 앱의 사용자 환경에 가장 적합한 형식을 선택할 수 있습니다. AdMob 문서에서 자세한 구현 안내를 보려면 광고 형식 버튼을 클릭하세요.

기기 화면의 상단이나 하단에 표시되는 직사각형 광고입니다.

배너 광고는 사용자가 앱과 상호작용하는 동안 화면에 표시되며 일정 시간이 지나면 자동으로 새로고침될 수 있습니다. 모바일 광고를 처음 시작하는 경우 이 형식부터 이용해 보시기 바랍니다.

배너 광고 구현

전면 광고

사용자가 닫을 때까지 앱의 인터페이스를 완전히 덮는 전체 화면 광고입니다.

전면 광고는 게임의 레벨 사이나 작업 완료 직후와 같이 앱 실행의 흐름이 자연스럽게 멈추는 시점에 사용하는 것이 가장 적합합니다.

전면 광고 구현

네이티브

앱의 디자인과 분위기에 어울리게 맞춤설정할 수 있는 광고입니다.

네이티브 광고는 구성요소 기반 광고 형식입니다. 광고 레이아웃과 앱 디자인의 일관성을 높일 수 있도록 네이티브 광고가 게재되는 방식과 위치를 결정해야 합니다. 글꼴, 색상, 기타 세부 요소를 직접 선택하여 사용자 환경을 더욱 풍부하게 만드는 자연스러운 방식으로 광고를 표시할 수 있습니다.

네이티브 광고 고급형 구현

보상형

짧은 동영상을 시청하거나 플레이어블 광고 또는 설문조사와 상호작용한 사용자에게 보상을 제공하는 광고 형식입니다.

보상형(또는 '보상 기반') 광고는 부분 유료화 사용자로부터 수익을 창출하는 데 도움이 됩니다.

보상형 광고 구현

보상형 광고(새 API) 구현