# Google Ad Manager 통합

> 광고 관리자 계정을 생성하고 인벤토리를 설정 레벨플레이 계정에 연결하여 Google Ad Manager를 Unity 레벨플레이 광고 네트워크로 통합할 수 있습니다.

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

다음 지침에 따라 Google Ad Manager가 Unity 레벨플레이 Mediation 광고 네트워크로 게재되도록 설정합니다.

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

## 필수 조건##prerequisites

* 보상형 광고 광고, 인터스티셜 광고 또는 배너 광고를 애플리케이션 올바르게 연동했는지 확인합니다. 연동 지침은 다음 플랫폼별 가이드를 참고하십시오.

  **Integration guides:**

  * [보상형 광고](/grow/levelplay/sdk/ios/rewarded-ads-integration.md)
  * [인터스티셜 광고](/grow/levelplay/sdk/ios/interstitial-integration.md)
  * [Banner](/grow/levelplay/sdk/ios/banner-integration.md)

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

## 1단계. Google Ad Manager 계정 생성

1. Unity 레벨플레이의 Mediation을 통해 Google Ad Manager 광고 인벤토리에 액세스, 접근하려면 [광고 관리자 계정을 만드십시오](https://admanager.google.com/home/).
2. Google 광고 매니저로 수익을 창출하려면 Google AdSense 계정을 생성해야 합니다.
3. AdSense 계정을 광고 관리자 계정에 연결합니다.

## 2단계. Google Ad Manager에서 인벤토리 생성

1. Google AdManager 가이드는 [여기](https://support.google.com/admanager/answer/6238692?hl=en)에서 찾을 수 있습니다.
2. 순서:
   1. 최소 하나의 주문 추가
   2. AdSense를 광고주로 주문에 연결합니다.
3. 라인 항목
   1. 수익화를 원하는 각 광고 유닛에 라인 아이템을 추가합니다(Int/RV/BN/NTV BN).
   2. 동영상 라인 항목 선택
   3. 라인 항목 타입 = 광고 교환
4. 앱
   1. 애플리케이션 Admob 계정에서 자동으로 추가됩니다.
   2. 그렇지 않은 경우 새 애플리케이션 생성합니다(Inventory > 앱 > Add app).
5. 광고 단위
   1. 각 가격대에 광고 유닛 추가

## 3단계. 레벨플레이 계정에서 **Google Ad Manager** 활성화

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

1. Google Ad Manager 계정에서 다음 정보를 얻으십시오. 

| App ID    | 광고 관리자 대시보드에서 앱에 할당된 고유 ID                                                                     |
| --------- | ---------------------------------------------------------------------------------------------- |
| API 키     | 광고 관리자 계정의 고유 식별자. 이렇게 하면 Unity 레벨플레이 Mediation 광고 관리자 계정에서 성과 데이터를 임포트 리포트 및 최적화에 사용할 수 있습니다. |
| 광고 유닛 ID  | 광고 관리자 대시보드에서 앱의 광고 유닛에 할당된 고유 ID                                                              |
| Client ID | 계정과 광고 유닛 간의 관계를 지정하는 고유 식별자                                                                   |
| 클라이언트 비밀  | 클라이언트 ID와 페어링되는 비밀 키                                                                           |
| 갱신 토큰     | 클라이언트 애플리케이션 이미 수신한 새로고침 토큰.                                                                   |

2. 레벨플레이 계정에서 Google Ad Manager의 파라미터를 설정.

* 아이언소스 계정에 로그인하고 **Monetize** > **SETUP** > **SDK Networks**로 이동합니다.

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

* **사용 가능한 네트워크** 목록에서 Google Ad Manager를 선택하고 광고 관리자의 **API 키**, **클라이언트** **ID**, **클라이언트 비밀** 및 **새로고침 토큰**을 입력하거나, **Google 로그인** 옵션을 선택합니다.

![로그인 자격 증명](/api/media?file=/grow/media/images/1-1.png)

![Google 로그인](/api/media?file=/grow/media/images/2.png)

* **Save**를 선택합니다. 광고 관리자는 활성화되고 사용 가능한 **광고 네트워크** 표에 표시됩니다.
* 광고 네트워크의 설정 목록에서 광고 관리자를 선택하고 도구 **정의** 버튼을 선택합니다. **앱 ID**와 **광고 유닛** **ID를** **인터스티셜** 광고, **보상형 광고** 또는 **배너 설정**에 삽입합니다.
  ![앱 및 광고 유닛 설정](/api/media?file=/grow/media/images/4.png) - 보고 API와의 통합을 확인합니다. 이 열은 리포트 API 통해 통합을 확인하고 다음과 같은 세 가지 응답을 반환합니다. 확인함, 실패함, 응답 없음 **Verified가 표시되지 않으면** 통합과 입력한 정보를 다시 확인한 다음 **Verified가 표시될** 때까지 **재시도**를 선택합니다.

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

> **Note:**
>
> AdMob SDK 7.69.0 이상부터는 XCFramework를 사용하고 있습니다. AdMob 통합에 CocoaPods를 사용하는 경우 CocoaPods 버전 1.9.0 이상을 사용해야 합니다.
>
> V7.42.0 \*\*(어댑터 버전 4.3.3 이상)\*\*부터 AdMob의 SDK는 퍼블리셔가 [여기](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 값으로 교체합니다.

레벨플레이 SDK는 **Cocoapods** 및 **매뉴얼** 다운로드 메커니즘을 모두 지원합니다.

### CocoaPods##cocoapods

AdMob SDK를 Cocoapods와 연동하려면 podfile에 다음 줄을 입력하면 됩니다.

```ruby
pod 'IronSourceAdMobAdapter','5.6.0'
```

### 매뉴얼 다운로드##manual-download

1. AdMob 어댑터 **다운로드** 빌드에 AdMob 어댑터 및 SDK를 추가합니다. iOS용 [Mediation 네트워크를 참고하십시오](/grow/levelplay/sdk/ios/mediation-networks.md). AdMob 어댑터 AdMob SDK가 포함되어 있지 않으므로 프로젝트에 AdMob SDK도 추가해야 합니다.
2. **AdMob 프레임워크를 프로젝트에 추가합니다**. 어댑터와 SDK를 다운로드한 후 Xcode 프로젝트에 어댑터 및 SDK **프레임워크** 파일을 드롭합니다.
3. **Target** > **Bild** **Settings** > **Architectures**를 열고 Xcode 프로젝트가 **지지대 SDK** 버전 **8.0** 이상을 사용하고 armv6 아키텍처를 사용하지 않는지 확인합니다.
4. **링커 플래그:** **Target** > **Build** **Settings** > **Linking** > **Other Linker Flags**에 별도의 링커 플래그 두 개를 추가합니다. -**ObjC**

## 5단계 Info.plist 업데이트##step-5.-update-info.plist

V7.42.0 \*\*(어댑터 버전 4.3.3 이상)\*\*부터 AdMob의 SDK는 퍼블리셔가 [여기](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 iOS 어댑터 4.3.11 이상을 사용하여 활성화되어, 사용 가능한 기능입니다.

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

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"AdMob_TFCD" value:@"true"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("AdMob_TFCD", value: "true")
   ```

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

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"AdMob_TFCD" value:@"false"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("AdMob_TFCD", value: "false")
   ```

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

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

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

다음 구문을 사용하여 Yes로 **tagForUnderAgeOfConsent**를 설정합니다.

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"AdMob_TFUA" value:@"true"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("AdMob_TFUA", value: "true")
   ```

다음 구문을 사용하여 NO로 **tagForUnderAgeOfConsent**를 설정합니다.

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"AdMob_TFUA" value:@"false"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("AdMob_TFUA", value: "false")
   ```

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

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

Unity 레벨플레이 Mediation 사용하면 퍼블리셔가 AdMob 네트워크와 통신하여 모든 광고 요청에 대한 최대 광고 콘텐츠 등급을 얻을 수 있습니다. 이 기능은 레벨플레이 SDK 7.12.0 이상의 AdMob iOS 어댑터 4.3.28 이상을 사용하여 활성화되어, 사용 가능한 기능입니다.

다음 구문을 사용하여 **maxAdContentRating을 설정합니다.**

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"AdMob_MaxContentRating" value:@"MAX_AD_CONTENT_RATING_G"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("AdMob_MaxContentRating", value: "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/ios/targeting#ad_content_filtering)를 방문하십시오.

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

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

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

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"Google_Content_Mapping" value:@"https://www.example.com"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("Google_Content_Mapping", value: "https://www.example.com")
   ```

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

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"Google_Content_Mapping"
                               values:[@[@"https://www.example1.com", @"https://www.example2.com"] mutableCopy]];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("Google_Content_Mapping", values: ["https://www.example1.com", "https://www.example2.com"])
   ```

## 7단계 활성화하다, 사용 가능하다 네이티브 광고(폐쇄형 베타)##step-7.-enable-native-ads-(closed-beta)

### 리소스 번들##resources-bundle

4.3.49 미만의 Google 어댑터 버전의 경우 리소스 번들에는 다양한 배너 크기의 네이티브 배너 커스텀 뷰가 포함되어 있습니다. 다음 단계에 따라 프로젝트에 리소스 번들을 추가합니다.

1. 프로젝트 타겟 선택 
2. 빌드 단계 탭으로 이동
3. Copy Bundle 리소스를 열고 **+** 아이콘을 선택합니다.
4. ISAdMobResources.bundle을 선택하고 **추가**를 선택합니다.

> **Note:**
>
> AdMob Native Validator 기능은 기본적으로 테스트 광고에 대해 활성화되어, 사용 가능한 기능입니다. 기능을 비활성화하려면 AdMob [웹사이트](https://developers.google.com/admob/ios/native/validator)를 방문하십시오.

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

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

## 다음 단계##next-steps

추가 Mediation 광고 네트워크를 활용하려면 [어댑터를](/grow/levelplay/sdk/ios/mediation-networks.md) 통합하고 통합 가이드를 따르십시오.