# Google AdMob 통합

> AdMob 계정을 생성하고 앱을 추가하고 광고 영역을 설정 AdMob을 Unity 레벨플레이 광고 네트워크로 통합합니다.

> **Important:**
>
> 다음 기술 자료는 Unity가 개발하거나, 소유하거나, 운영하지 않는 제품 또는 서비스('타사 제품')에 관한 내용입니다.
> 이 정보는 오래되었거나 불완전할 수 있으며 편의를 위해 제공됩니다.
> 타사 제품을 사용하는 경우 해당 제품의 약관이 적용됩니다.
> Unity는 이러한 제품에 대해 어떠한 보증도 하지 않으며, 타사 제공자의 콘텐츠, 광고 또는 머티리얼과 관련된 문제를 포함하여 제품 사용으로 인한 손해나 손실에 대해서도 책임지지 않습니다.

> **Note:**
>
> 이 Mediation 네트워크의 어댑터 변경 기록을 보려면 [Unity용 Mediation 네트워크](/grow/levelplay/sdk/unity/mediation-networks.md.md#integrate-network-adapters)를 참조하십시오.

이 가이드는 Unity 레벨플레이 Mediation AdMob과 AdMob Native를 라이브 광고 네트워크로 설정하는 방법을 단계별로 설명합니다.

## 필수 조건

레벨플레이 SDK 애플리케이션에 [인터스티셜 광고](/grow/levelplay/sdk/unity/interstitial-integration.md.md), [보상형 광고](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md) 또는 [배너 Mediation](/grow/levelplay/sdk/unity/banner-integration.md.md)을 올바르게 통합했는지 확인합니다.

Google Ad Manager 광고는 AdMob SDK를 사용하여 게재됩니다.

AdMob SDK 7.69.0 이상부터는 XCFramework를 사용하고 있습니다. AdMob 통합에 CocoaPods를 사용하는 경우 CocoaPods 버전 1.9.0 이상을 사용해야 합니다.

AdMob은 Android 운영 체제 버전 4.1(API 레벨 16) 이상을 지원합니다. 필요한 Gradle 빌드 도구는 3.5.4입니다.

AdMob SDK는 iOS 버전 10 이상을 지원하며 iOS 버전 11 이상에서 사용자에게 광고를 게재합니다.

## 1단계. AdMob 계정 생성

1. Unity 레벨플레이 Mediation을 통해 AdMob의 배너 및 네이티브 광고 인벤토리에 액세스, 접근하려면 [AdMob 계정을 생성](https://www.google.com/admob/)해야 합니다.
2. Ironsource 플랫폼에 맞게 AdMob 계정의 시간대를 UTC로 조정하는 것이 좋습니다. 이렇게 하면 정확한 리포트가 보장됩니다. [자세히 알아보기](https://support.google.com/admob/answer/7276705?hl=en)

## 2단계. Admob에서 애플리케이션 및 광고 영역 만들기

다음으로 앱을 추가하고 AdMob 계정에서 광고 영역을 설정해야 합니다.

AdMob은 동일한 설정에서 동일한 광고 유형의 광고 영역을 3개 이상 설정 수 없습니다.\
예를 들어 Mediation 그룹에서 보상형 광고 광고가 3개를 초과할 수 없습니다.

### 앱 추가

* AdMob 계정에 로그인합니다. 대시보드에서 **앱**을 선택합니다.

* 앱을 검색하거나 앱을 수동으로 추가하거나 기존 앱을 선택하여 수익화를 수행할 수 있는 모달이 나타납니다.

  > **Note:**
  >
  > 레벨플레이 계정과 마찬가지로 플랫폼별로 고유한 AdMob 애플리케이션(iOS + Android)이 필요합니다.

* 인터스티셜 광고, 보상형 광고, 배너 또는 네이티브 고급 광고(배너에 대한 네이티브 광고)를 광고 유닛 형식으로 선택하고 관련 세부 정보를 입력합니다.

#### 인터스티셜 광고

* **광고 유형**: 텍스트, 이미지, 동영상, 리치 미디어를 인터스티셜로 지원하므로 두 개의 체크박스를 선택한 상태로 유지할 수 있습니다.
* **Ad unit name**: Unity 레벨플레이 Mediation 통해 AdMob Interstitials에 게재될 광고 유닛으로 쉽게 인식할 수 있도록 광고 유닛의 이름을 직관적으로 지정하는 것이 좋습니다.

#### 보상형 광고

* **Ad unit name**: Unity 레벨플레이 Mediation 통해 AdMob의 보상형 광고 광고를 게재할 광고 유닛으로 쉽게 인식할 수 있도록 광고 유닛의 이름을 직관적으로 지정하는 것이 좋습니다.

#### 배너

* **광고 단위 이름**: 권장되는 베스트 프랙티스는 광고 유닛의 이름을 직관적으로 지정하여 AdMob 배너를 게재할 광고 유닛으로 쉽게 인식할 수 있도록 하는 것입니다. Unity 레벨플레이 Mediation
* **eCPM 플로어 -** 국가와 폭포 전략에 따라 eCPM 값을 활성화하고 사용 가능하다.

> **Important:**
>
> 자동 새로고침: **"새로고침하지 않음" 옵션을 선택합니다.** (기억 - Mediation 플랫폼에서 새로고침 속도 제어할 수 있음)

#### 네이티브 배너

배너용 네이티브 광고를 사용하면 Google AdMob의 네이티브 광고 수요에 액세스, 접근 수 있습니다. 즉, Google의 네이티브 및 배너 수요에 모두 액세스하여 배너 성능을 향상시킬 수 있습니다.

* **Ad unit name**: 쉽게 인식할 이름을 입력합니다.
  * **고급 설정**: **이미지** 및 **비디오** 모두 선택
  * **eCPM floor**: 국가 및 워터폴 전략에 따라 eCPM 값을 활성화하다, 사용 가능하다 입력합니다.

이제 앱 ID와 광고 유닛 ID를 가져와 나중에 사용할 수 있도록 저장합니다. 그런 다음 **Done**을 선택합니다.

## 3단계. 레벨플레이 네트워크 설정 모듈에서 AdMob 활성화

레벨플레이 SDK 네트워크 설정 페이지에서 AdMob을 설정할 때 Google 계정에 로그인하면 AdMob 인터스티셜, 보상형 광고, 배너 및 네이티브 광고를 실행하는 데 필요한 파라미터가 자동으로 검색됩니다.

AdMob이 레벨플레이 SDK와 올바르게 작동하려면 몇 가지 AdMob 계정의 데이터를 Ironsource 네트워크 설정 모듈에 삽입해야 합니다.

| 데이터       | Description                          |
| --------- | ------------------------------------ |
| App ID    | Admob 대시보드에서 앱에 할당된 고유 ID입니다.        |
| 광고 유닛 ID  | Admob 대시보드에서 앱의 광고 유닛에 할당된 고유 ID입니다. |
| Client ID | 계정과 광고 유닛 간의 관계를 지정하는 고유 식별자.        |
| 클라이언트 비밀  | 클라이언트 ID와 페어링되는 비밀 키                 |
| 갱신 토큰     | 클라이언트 애플리케이션 이미 수신한 새로고침 토큰.         |

이 정보를 얻으면 레벨플레이 계정에서 AdMob의 파라미터를 설정 합니다. 위 정보를 올바르게 추가하면 Unity 레벨플레이 Mediation AdMob 광고 인벤토리와 리포트 데이터를 최대한 활용할 수 있습니다.

1. **App ID**
   앱 ID를 검색하려면 Admob 플랫폼의 왼쪽 바에 있는 **앱** 탭으로 이동하여 **앱 설정**을 선택합니다. 그러면 애플리케이션 설정과 앱 ID가 표시됩니다.

![앱 ID 위치](/api/media?file=/grow/media/images/App-ID-1.png)

2. **Ad Unit ID**
   광고 유닛 ID를 검색하려면 Admob 플랫폼의 왼쪽 바에 있는 **앱** 탭으로 이동하여 **광고 유닛**을 선택합니다. 그러면 애플리케이션 광고 유닛과 광고 유닛 ID가 표시됩니다.

![광고 유닛 ID 위치](/api/media?file=/grow/media/images/Ad-Unit-ID.png)

3. **클라이언트 ID 및 클라이언트 비밀**

   1. **클라이언트 ID 및 클라이언트 비밀**을 검색하려면 [Google의 API 관리자](https://console.cloud.google.com/apis)로 이동합니다.

   2. 페이지 왼쪽 상단의 **API 프로젝트** 드롭다운을 선택하고 **프로젝트 생성**을 선택하거나 이 앱에 대해 이미 생성한 프로젝트를 선택합니다. 이 목적으로 새 프로젝트를 생성하는 경우 다이얼로그 상자에 **프로젝트 이름**, **계산 계정** 및 **위치**을 입력하고 **생성**을 선택합니다.

   3. 왼쪽 사이드바에서 **인증정보를** 선택한 다음 **OAuth 동의 화면** 탭을 선택합니다. 이 페이지에서 **제품 이름**을 입력합니다. **Save**를 선택합니다.

   4. 왼쪽 사이드바에서 **Dashboard\*\*\*\*를 선택하고,** **활성화, 사용 가능한 API 및 서비스**로 이동합니다.

   5. 다음으로, **AdMob API를 사용 가능하다**.

   6. 왼쪽 사이드바에서 **자격 증명** 탭을 선택합니다. **Create Credentials** 드롭다운을 선택하고 **OAuth 클라이언트 ID**를 선택합니다.

   7. **웹 애플리케이션**을 선택하고 앱 이름을 입력합니다. 아래 필드에는 최소 하나의 **승인된 리디렉트 URI**에 대한 [https://developers.google.com/oauthplayground](https://developers.google.com/oauthplayground)를 입력해야 합니다. 예제는 아래와 같습니다.

      * **JavaScript 원점 승인:** `https://YOUR_NAMESPACE **(Optional)**`
      * **승인된 리디렉트 URI:** [https://developers.google.com/oauthplayground](https://developers.google.com/oauthplayground)

   8. **Create를 선택하면** **클라이언트 ID**와 **클라이언트 비밀**이 표시됩니다.

4. **Refresh 토큰**
   1. **재생 토큰**을 검색하려면 **[OAuth 2.0 Playground](https://developers.google.com/oauthplayground/#step1\&scopes=https%3A//www.googleapis.com/auth/adwords\&url=https%3A//\&content_type=application/json\&http_method=GET\&useDefaultOauthCred=checked\&oauthEndpointSelect=Google\&oauthAuthEndpointValue=https%3A//accounts.google.com/o/oauth2/auth\&oauthTokenEndpointValue=https%3A//www.googleapis.com/oauth2/v3/token\&includeCredentials=unchecked\&accessTokenType=bearer\&autoRefreshToken=unchecked\&accessType=offline\&forceAprovalPrompt=checked\&response_type=code)로 이동하십시오.**
   2. 오른쪽 상단에 있는 설정 아이콘을 선택합니다. 선택 해제 \*\* 힘 승인 프롬프트\*\* 및 **자체 OAuth 자격 증명 사용**을 선택합니다. **클라이언트 ID**와 **클라이언트 비밀**을 입력합니다.

![OAuth 설정](/api/media?file=/grow/media/images/AdMob-18.png)

3. 다음으로, **단계 1: API를 선택하고 권한을 부여한다**고, \*\*[https://www.googleapis.com/auth/admob.report](https://www.googleapis.com/auth/admob.report)\*\*를 입력하고 **권한을 부여한다 API**를 선택한다.

![권한을 부여한다 API](/api/media?file=/grow/media/images/Step-1.png)

4. 프로젝트에 AdMob 데이터 액세스, 접근 권한을 부여합니다.
5. 그런 다음 1단계에서 권한 부여, 인증 코드를 수신하면 토큰에 대한 **권한 부여, 인증 코드** 버튼을 선택할 수 있습니다. 그런 다음 **재생 토큰**과 액세스, 접근 토큰을 받게 됩니다.

![Refresh 토큰](/api/media?file=/grow/media/images/Admob-22.png)

### 레벨플레이 계정에서 AdMob 파라미터 설정

* 이 모든 파라미터를 사용하면 ironsource 계정에 로그인하여 **Monetize** > **SETUP** > **SDK Networks**로 이동합니다.

![SDK Networks](/api/media?file=/grow/media/images/Level-Play-SDK.jpg)

* **네트워크 관리** 목록에서 Admob을 선택하고 Admob **클라이언트** **ID**, **클라이언트 비밀** 및 **새로 고침 토큰**을 입력하거나 **Google 로그인** 옵션을 선택합니다.

![로그인 옵션](/api/media?file=/grow/media/images/client-id.png)

![Google 로그인](/api/media?file=/grow/media/images/log-in-with-google.png)

* **Save**를 선택합니다. 그러면 **사용 가능한 광고 네트워크** 표에서 AdMob 및 AdMob 네이티브가 활성화되어 사용 가능합니다.

![SDK 네트워크 표](/api/media?file=/grow/media/images/sdk-networks.png)

* 다음으로, Unity 레벨플레이 AdMob Mediation 실행할 앱을 선택합니다.
* Ad Networks의 설정 목록에서 Admob을 선택하고 도구 **정의** 아이콘을 선택합니다. 그런 다음 **앱 ID**와 **광고 유닛** **ID를** **인터스티셜** 광고, **보상형 광고** **비디오** 또는 **배너 설정**에 삽입합니다.

![설정](/api/media?file=/grow/media/images/define.png)

* 리포트 API 연동을 확인합니다. 이 열은 리포트 API 통해 연동을 확인하고 가능한 3가지 응답을 반환합니다. 확인함, 실패함, 응답 없음 통합과 위에 입력한 정보를 다시 확인한 다음 **검증됨**이 표시될 때까지 **재시도** 선택합니다.

## 4단계. 빌드 Admob 어댑터 추가하기##step-4.-add-the-admob-adapter-to-your-build

### Unity 통합 관리자(권장)##unity-integration-manager-(recommended)

SDK 연동이 완료되면 Unity 통합 관리자를 사용하여 AdMob 어댑터 다운로드 수 있습니다.

Unity 개발 플랫폼에서 레벨플레이 > Integration Manager로 이동합니다.

이미 최신 버전의 어댑터가 있는 경우, **행동** 버튼이 "업데이트"로 변경되고 비활성화됩니다.

### Android(매뉴얼 결정)##android-(manual-resolve)

변경 사항을 적용하려면 "결정" 프로세스를 사용해야 합니다. 그러면 선택에 따라 모든 관련 아티팩트가 다운로드. 자세한 내용은 [여기](/grow/levelplay/sdk/unity/package-integration.md)의 지침을 참조하십시오.

### AdMob 앱 ID 추가##add-admob-app-id

#### Android##android

앱의 Android 매니페스트에 AdMob 앱 ID를 `<application></application>` 태그의 자식으로 추가합니다.

```xml
<meta-data android:name="com.google.android.gms.ads.APPLICATION_ID"
           android:value="[ADMOB_APP_ID]"/>
```

3단계에서 가져온 APP ID 값으로 `[ADMOB\_APP\_ID\]`를 교체합니다.
이렇게 하지 않으면 AdMob의 SDK로 인해 크래시가 발생합니다. 자세한 내용은 [AdMob의 가이드](https://developers.google.com/admob/android/quick-start#update_your_androidmanifestxml)를 참조하십시오.

#### iOS##ios

[여기](https://developers.google.com/admob/ios/quick-start#update_your_infoplist) 설명된 대로 앱의 plist에 AdMob 앱 ID를 추가합니다.
또는 프로그래밍 방식으로 변경할 수도 있습니다.

```xml
<key>GADApplicationIdentifier</key>
<string>[APP_ID]</string>
```

“GADApplicationIdentifier” 값을 3단계에서 가져온 APP ID 값으로 교체합니다.

#### Android 플러그인 매뉴얼 통합##android-plugin-manual-integration

1. **Android용 Admob 어댑터 다운로드:**\
   AdMob 어댑터 및 AdMob SDK(AAR)를 [여기](/grow/levelplay/sdk/android/mediation-networks.md)에서 다운로드하십시오.
2. **Unity 프로젝트에 Admob 파일을 추가합니다.**\
   파일을 \*\*Assets/Plugins/Android/\*\*로 임포트합니다.
3. 앱의 Android 매니페스트에 AdMob 앱 ID를 `<application></application>` 태그의 자식으로 추가합니다.

```xml
<meta-data android:name="com.google.android.gms.ads.APPLICATION_ID"
           android:value="[ADMOB_APP_ID]"/>
```

4. 3단계에서 가져온 APP ID 값으로 `[ADMOB\_APP\_ID\]`를 교체합니다.
   이렇게 하지 않으면 AdMob의 SDK로 인해 크래시가 발생합니다. 자세한 내용은 [AdMob의 가이드](https://developers.google.com/admob/android/quick-start#update_your_androidmanifestxml)를 참조하십시오.

#### iOS 플러그인 매뉴얼 통합##ios-plugin-manual-integration

1. AdMob iOS 어댑터 다운로드:
   iOS용 [Mediation 네트워크를 참고하십시오](/grow/levelplay/sdk/ios/mediation-networks.md).
2. Unity 프로젝트 AdMob 어댑터 추가합니다.
   AdMob 어댑터 파일을 **Assets/Plugins/iOS로 임포트합니다.**
3. Xcode 프로젝트에 SDK를 추가합니다.
   Unity3D는 XCFrameworks를 지원하지 않으므로 SDK XCFrameworks를 Xcode 프로젝트에 직접 추가합니다.
4. [여기](https://developers.google.com/admob/ios/quick-start#update_your_infoplist) 설명된 대로 앱의 plist에 AdMob 앱 ID를 추가합니다.
   또는 프로그래밍 방식으로 변경할 수도 있습니다.

```xml
<key>GADApplicationIdentifier</key>
<string>[APP_ID]</string>
```

5. “GADApplicationIdentifier” 값을 3단계에서 가져온 APP ID 값으로 교체합니다.

## 5단계 Info.plist 업데이트(iOS)##step-5.-update-info.plist-(for-ios)

iOS용 AdMob SDK V7.42.0\*\*(어댑터 버전 4.3.3 + iOS / Unity)부터는\*\* 퍼블리셔가 [here](https://developers.google.com/admob/ios/quick-start#update_your_infoplist)여기에 설명된 대로 AdMob 앱 ID를 앱의 플리스트에 추가해야 합니다.
또는 프로그래밍 방식으로 변경할 수도 있습니다.

```xml
<key>GADApplicationIdentifier</key>
<string>[APP_ID]</string>
```

“GADApplicationIdentifier” 값을 3단계에서 가져온 APP ID 값으로 교체합니다.
이렇게 하지 않으면 AdMob의 SDK로 인해 크래시가 발생합니다. 자세한 내용은 [AdMob의 가이드](https://developers.google.com/admob/ios/quick-start#update_your_infoplist)를 참조하십시오.

## 6단계. 추가 단계##step-6.-additional-steps

### 자식 지향 설정 – COPPA##child-directed-setting--coppa

Unity 레벨플레이 Mediation 사용하면 퍼블리셔가 AdMob 자식 다이렉트 설정을 AdMob 네트워크에 직접 전달할 수 있습니다.
이 기능은 레벨플레이 SDK 6.14.0 이상의 AdMob Unity 어댑터 4.3.12 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.

다음 구문을 사용하여 AdMob **setTagForChildDirectedTreatment를** "True" 파라미터로 설정합니다.

```cs
LevelPlay.SetMetaData("AdMob_TFCD","true");
```

다음 구문을 사용하여 AdMob **setTagForChildDirectedTreatment를** "False" 파라미터로 설정합니다.

```cs
LevelPlay.SetMetaData("AdMob_TFCD","false");
```

자식 지정 설정에 대해 자세히 알아보기 AdMob 네트워크를 방문하십시오.
[여기](https://developers.google.com/admob/android/targeting#child-directed_setting)

### 동의 연령 미만의 사용자 – GDPR##users-under-the-age-of-consent--gdpr

Unity 레벨플레이 Mediation 사용하면 퍼블리셔가 AdMob 네트워크, 즉 TFUA(유럽 동의 연령)에서 사용자용 태그 요청과 통신할 수 있습니다.
이 기능은 레벨플레이 SDK 6.14.0 이상의 AdMob Unity 어댑터 4.3.12 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.

다음 구문을 사용하여 "True"로 **setTagForUnderAgeOfConsent를** 설정합니다.

```cs
LevelPlay.SetMetaData("AdMob_TFUA","true");
```

다음 구문을 사용하여 "False"로 **setTagForUnderAgeOfConsent를** 설정합니다.

```cs
LevelPlay.SetMetaData("AdMob_TFUA","false");
```

자식 지정 설정에 대해 자세히 알아보려면 AdMob 네트워크 아래에서 [여기](https://developers.google.com/admob/android/targeting#users_under_the_age_of_consent)를 방문하십시오.

#### 광고 콘텐츠 필터링##ad-content-filtering

Unity 레벨플레이 Mediation 사용하면 퍼블리셔가 AdMob 네트워크와 커뮤니케이션하여 모든 광고 요청에 대한 최대 광고 콘텐츠 등급을 제공할 수 있습니다.
이 기능은 레벨플레이 SDK 7.12.0 이상의 AdMob Android 어댑터 4.3.23 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.

maxAdContentRating을 설정하려면 다음 구문 사용합니다.

```cs
LevelPlay.SetMetaData("AdMob_MaxContentRating","MAX_AD_CONTENT_RATING_G");
```

이 프로퍼티 대한 가능한 값은 Google에서 정의한 디지털 콘텐츠 레이블 분류에 기반합니다.

* MAX\_AD\_CONTENT\_RATING\_G
* MAX\_AD\_CONTENT\_RATING\_PG
* MAX\_AD\_CONTENT\_RATING\_T
* MAX\_AD\_CONTENT\_RATING\_MA

Ad Content Rating Under 네트워크에 대해 자세히 알아보려면 [여기](https://developers.google.com/admob/unity/targeting#ad_content_filtering)를 방문하십시오.

#### 콘텐츠 URL 매핑 지원##content-url-mapping-support

Unity 레벨플레이는 앱용 Google 콘텐츠 매핑을 지원하며 "Google\_Content\_Mapping" 설정을 사용하여 URL을 공유할 수 있습니다. 이 기능은 레벨플레이 SDK 7.7.0 이상의 AdMob 어댑터 4.3.58 이상을 사용하여 활성화된, 사용 가능한 수 있습니다. Google의 콘텐츠 매핑에 대해 자세히 알아보기 [여기](https://support.google.com/admob/answer/11050896).

단일 콘텐츠 URL을 전달 다음 구문 사용하십시오.

```cs
LevelPlay.SetMetaData("Google_Content_Mapping","https://www.example.com");
```

여러 URL을 지원하려면 동일한 키를 사용하고 최대 4개의 URL을 공유하십시오.

```cs
LevelPlay.SetMetaData("Google_Content_Mapping",new[] {"https://www.example1.com","https://www.example2.com"});
```

## 광고 네트워크 통합 확인##verify-your-ad-network-integration

레벨플레이와 추가 광고 네트워크의 통합을 확인하려면 이 [문서](/grow/levelplay/sdk/unity/integration-helper.md)를 따르십시오.

## 다음 단계##next-steps

Unity 레벨플레이 통해 추가 광고 네트워크를 활용하려면 어댑터를 연동하고 Unity 연동 가이드를 따르십시오.

**Platform adapters:**

* [Unity](/grow/levelplay/sdk/unity/mediation-networks.md)
* [Android](/grow/levelplay/sdk/android/mediation-networks.md)
* [iOS](/grow/levelplay/sdk/ios/mediation-networks.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/mediation-networks.md)
* [Flutter](/grow/levelplay/sdk/flutter/mediation-networks.md)
* [React Native](/grow/levelplay/sdk/react/mediation-networks.md)