# Google Ad Manager 통합

> Google Ad Manager 계정을 설정 어댑터.어댑터

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

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

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

## 필수 조건##prerequisites

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

  **Integration guides:**

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

## 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

V17.0.0부터 \*\*(어댑터 버전 4.3.1 이상)\*\*에는 퍼블리셔가 앱의 Android 매니페스트에 AdMob 앱 ID를 `<application/>`태그의 자식으로 추가해야 합니다.

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

"ADMOB\_APP\_ID"를 3단계에서 가져온 APP ID 값으로 대체합니다.

1. allprojects->repositories 차단 안에 다음 줄이 있는지 확인합니다.

   ```groovy
   allprojects {
       repositories {
          flatDir {
              dirs 'libs'
          }
          google()
       }
   }
   ```

2. 종속성 차단 다음 종속성을 추가합니다.

   ```groovy
   dependencies {
       구현 파일트리(dire: 'libs', include: ['*.jar'])
   }
   ```

레벨플레이 SDK는 Gradle 종속성과 매뉴얼 다운로드 메커니즘을 모두 지원합니다.

Admob 어댑터 Gradle 연동하는 방법은 다음과 같습니다.

1. 앱 모듈의 Gradle다음 Maven URL이 있는지 확인합니다. 모든 어댑터에는 한 번만 표시되어야 합니다.

   ```groovy
   repositories {
       google()
       mavenCentral()
   }
   ```

2. 어댑터의 Maven 이름을 앱 모듈의 빌드.gradle 스크립트에 추가합니다.

   ```groovy
   dependencies {
      implementation 'com.unity3d.ads-mediation:admob-adapter:5.11.0'
      implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
   }
   ```

매뉴얼 다운로드 통해 Admob 어댑터 연동하는 방법은 다음과 같습니다.

1. **Admob 어댑터 다운로드:** 빌드 Admob 어댑터 추가합니다. [여기](/grow/levelplay/sdk/android/mediation-networks.md)에서 최신 Admob 어댑터를 찾을 수 있습니다. **중요!** Admob 어댑터 Admob SDK가 포함되어 있지 않습니다. Admob SDK를 추가로 직접 추가해야 **합니다**.

2. **Admob 어댑터를 프로젝트에 추가합니다.** 어댑터를 다운로드한 후에는 Android 프로젝트의 **libs** 폴더에 Admob 어댑터 상자를 놓습니다.

   ![Android 프로젝트의 libs 폴더에 어댑터 JAR 파일을 놓습니다.](/api/media?file=/grow/media/images/Supersonic-Mediation-Drop-Libs.png)

3. Gradle 빌드 파일의 **종속성 섹션** 아래에 다음을 추가해야 합니다.
   ```groovy
   dependencies {
      implementation 'com.unity3d.ads-mediation:admob-adapter:5.11.0'
      implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
   }
   ```

## 5단계 AndroidManifest.xml 업데이트##step-5.-update-androidmanifest.xml

레벨플레이 Android SDK 버전 6.17.0(AdMob Android 어댑터 버전 4.3.10 이상)부터 AdMob 어댑터는 AAR로 릴리스됩니다. Jar 연동을 유지하려는 경우 매니페스트 추가합니다.

**매니페스트 사용 권한:**

```xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
```

**매니페스트 활동:** **manifestAdditions**의 `<application>` 태그 안에 다음 활동을 추가합니다.

```xml
<activity android:name="com.google.android.gms.ads.AdActivity"
android:configChanges="keyboard|keyboardHidden|방향, 방향 설정 |screenLayout|uiMode|screenSize|smallestScreenSize" android:theme="@android:style/Theme.Translucent" />
```

V17.0.0부터 \*\*(어댑터 버전 4.3.1 이상)\*\*에는 퍼블리셔가 앱의 Android 매니페스트에 AdMob 앱 ID를 `<application></application>` 태그의 자식으로 추가해야 합니다.

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

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

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

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

다음 구문을 사용하여 AdMob **setTagForChildDirectedTreatment를** 파라미터 TAG\_FOR\_CHILD\_DIRECTED\_TREATMENT\_TRUE로 설정합니다.

```java
LevelPlay.setMetaData("AdMob\_TFCD","true");
```

다음 구문을 사용하여 AdMob **setTagForChildDirectedTreatment를** 파라미터 TAG\_FOR\_CHILD\_DIRECTED\_TREATMENT\_FALSE로 설정합니다.

```java
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 Android 어댑터 4.3.9 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.

다음 구문을 사용하여 TAG\_FOR\_UNDER\_AGE\_OF\_CONSENT\_TRUE로 **setTagForUnderAgeOfConsent를** 설정합니다.

```java
LevelPlay.setMetaData("AdMob_TFUA","true");
```

다음 구문을 사용하여 TAG\_FOR\_UNDER\_AGE\_OF\_CONSENT\_FALSE로 **setTagForUnderAgeOfConsent를** 설정합니다.

```java
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을 설정하려면 다음 구문 사용합니다.

```java
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/android/targeting#ad_content_filtering)를 방문하십시오.

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

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

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

```java
LevelPlay.setMetaData("Google_Content_Mapping ","https://www.example.com");
```

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

```java
LevelPlay.setMetaData("Google_Content_Mapping",["https://www.example.com","https://www.example2.com"]);
```

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

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

## 다음 단계##next-steps

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