# Google 입찰 통합

> 자동 설정 툴 또는 매뉴얼 설정 사용하여 Unity 레벨플레이 Mediation Google을 입찰자 네트워크로 설정합니다.

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

이 가이드는 Unity 레벨플레이 Mediation Google을 입찰자 네트워크로 설정하는 방법을 단계별로 설명합니다.

Google 입찰자의 경우 아래의 1단계를 완료하면 자동 설정 툴을 사용할 수 있습니다. 자동 설정 툴은 앱과 입찰자 배치를 생성하고 AdMob에서 플레이스먼트 세부 정보를 가져오므로 레벨플레이 AdMob 플랫폼 간에 전환할 필요가 없습니다. 또는 전체 설정을 수동으로 완료할 수도 있습니다.

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

## 필수 조건##prerequisites

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

레벨플레이 SDK 버전 7.2.7 이상부터 Google 입찰이 지원됩니다.

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

> **Note:**
>
> 1단계를 완료한 후 3단계로 건너뛰고 자동 입찰자 설정 툴을 사용하여 Unity 레벨플레이 Google 입찰을 시작하고 실행할 수 있습니다. 매뉴얼 설정을 계속하려면 2단계를 계속하십시오.

## 2단계. AdMob에서 애플리케이션 및 광고 유닛 생성

이제 앱을 AdMob 계정에 추가해야 합니다.

### 앱 추가

* AdMob 계정에 로그인합니다. 대시보드에서 **앱**을 선택한 다음 **앱 추가**를 선택합니다.
* 앱을 검색하거나 앱을 수동으로 추가하거나 기존 앱을 선택하여 수익화를 수행할 수 있는 모달이 나타납니다. Ironsource 계정과 유사하게 플랫폼별로 고유한 AdMob 애플리케이션(iOS + Android)이 필요합니다.
* 인터스티셜 광고, 보상형 광고 또는 배너를 광고 유닛 형식으로 선택하고 관련 세부 정보를 입력합니다.
* **인터스티셜 광고**
  * **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
  * **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.
* **보상형 광고**
  * **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
  * **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.
*  **배너**
  * **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
  * **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.

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

레벨플레이 Meta Audience Network 설정을 얻는 방법에는 두 가지가 있습니다.

* **자동 설정** - Google 계정으로 로그인하여 새로운 애플리케이션과 입찰 플레이스먼트를 자동으로 생성하고 Google AdMob 플랫폼에서 필요한 모든 구성 설정을 가져옵니다.
* **매뉴얼** - 레벨플레이와 Google AdMob 플랫폼 간에 이동하여 필요한 정보를 검색하고 입력하십시오.

### 자동 설정

* 레벨플레이 계정에 로그인하고 **레벨플레이 측 바** > **설정** > **네트워크**로 이동합니다.
* 사용 가능한 광고 네트워크 목록에서 **Google AdMob**을 선택합니다.
* **Google 로그인**을 선택하고 승인된 Google 계정으로 로그인합니다.
* 이미 로그인한 경우 재설정 로그인을 선택합니다\*\*(새 로그인 필요)\*\*
* 로그인 후 Google 자동 설정 입찰자 토글
* 이제 **인스턴스 페이지**로 이동하여 인터스티셜 광고, 보상형 광고 또는 배너 광고를 게재할 앱을 선택합니다. 
* AdMob 플랫폼에서 새 앱과 입찰 플레이스먼트를 자동으로 생성하고 광고 유닛 ID를 임포트하려면 **Add Bidder를 선택**합니다. 앱에 이미 연결된 앱 ID가 있는 경우 광고 유닛 ID 파라미터 값이 없는 플레이스먼트가 1개 이상 있는 경우 자동 설정 툴을 사용할 수 있습니다. 이 경우 새 입찰 플레이스먼트가 생성됩니다.
* **저장**을 선택하여 모든 구성을 승인하고 승인합니다. 저장하지 않고 모듈을 닫으면 데이터를 레벨플레이 플랫폼으로 임포트하지 않고 AdMob 플랫폼에서 에셋이 생성됩니다.

Google 입찰자 인스턴스의 상태는 광고 형식별로 Ironsource Ads 입찰자의 상태와 동일합니다. 예를 들어 보상형 광고 광고에 Ironsource 광고 입찰자를 사용하지 않는 경우 Google 네트워크에서 자동으로 활성화되지 않습니다.

### 매뉴얼 설정

1. 레벨플레이 계정에 로그인하고 **레벨플레이 측 바** > **설정** > **네트워크**로 이동합니다.
2. 사용 가능한 광고 네트워크 목록에서 **Google AdMob**을 선택합니다.
3. AdMob이 레벨플레이 SDK를 연동할 활성화하다, 사용 가능하다 있도록 레벨플레이 네트워크 설정 모듈에 다음 데이터를 입력합니다.

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

이 AdMob 파라미터를 레벨플레이 연동하려면 다음 지침을 참고하십시오.

1. **App ID**

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

2. **Ad Unit ID**

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

3. **Client ID  and Client Secret**

   1. **클라이언트 ID 및 클라이언트 비밀**을 가져오려면 [Google의 API 관리자](https://console.cloud.google.com/apis)로 이동합니다.
   2. 페이지 왼쪽 상단의 **API Project** 드롭다운을 선택하고 **Create a project**를 선택하거나 이 앱에 대해 이미 생성한 프로젝트를 선택합니다. 이 목적으로 새 프로젝트를 생성하는 경우 다이얼로그 상자에 **Project name**, **Billing account** 및 **Location**을 입력하고 **Create**를 선택합니다.
   3. 왼쪽 사이드바에서 **Credentials**를 선택한 다음 **OAuth consent screen** 탭을 선택합니다.그런 다음 **Product Name**을 입력하고 **Save**를 선택합니다.
   4. 왼쪽 사이드바에서 **Dashboard**를 선택하고 활성화하다, 사용 가능하다 APIs and Services\*\*로 이동합니다.
   5. 다음으로 \*\*AdMob API 활성화하다, 사용 가능하다.
   6. 왼쪽 사이드바에서 **Credentials** 탭을 선택합니다. **Create Credentials** 드롭다운을 선택하고 **OAuth 클라이언트 ID**를 선택합니다.
   7. **Web 애플리케이션**을 선택하고 앱 이름을 입력합니다. 아래 필드에는 최소 하나의 **Authorized 리디렉트 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**와 클라이언트 Secret**이 표시됩니다.

4. **Refresh Token**

   1. **Refresh 토큰**을 가져오려면 \*\*\[OAuth 2.0 Playground]\([https://developers.google.com/oauthplayground/#step1\\\&amp;scopes=https%3A//www.googleapis.com/auth/adwords\\\&amp;url=https%3A//\\\&amp;content\_type=application/json\\\&amp;http\_method=GET\\\&amp;useDefaultOauthCred=checked\\\&amp;oauthEndpointSelect=Google\\\&amp;oauthAuthEndpointValue=https%3A//accounts.google.com/o/oauth2/auth\\\&amp;oauthTokenEndpointValue=https%3A//www.googleapis.com/uth2/v3/token\_include\\\&amp;dentiethAuthEndpointValue=https%3A//accounts.com/o/oauth2/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth](https://developers.google.com/oauthplayground/#step1\\\&amp;scopes=https%3A//www.googleapis.com/auth/adwords\\\&amp;url=https%3A//\\\&amp;content_type=application/json\\\&amp;http_method=GET\\\&amp;useDefaultOauthCred=checked\\\&amp;oauthEndpointSelect=Google\\\&amp;oauthAuthEndpointValue=https%3A//accounts.google.com/o/oauth2/auth\\\&amp;oauthTokenEndpointValue=https%3A//www.googleapis.com/uth2/v3/token_include\\\&amp;dentiethAuthEndpointValue=https%3A//accounts.com/o/oauth2/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth/auth).
   2. 오른쪽 상단의 설정 아이콘을 선택합니다. 힘 approval 프롬프트 체크박스를 선택 선택 해제 **Use your own OAuth credentials**를 선택합니다. 클라이언트 ID**와 클라이언트 Secret**을 입력.
   3. 다음으로 **1단계: APIS**를 선택하고 권한을 부여합니다. \*\*[https://www.googleapis.com/auth/admob.report](https://www.googleapis.com/auth/admob.report)\*\*를 입력하고 \*\*권한을 부여합니다.\*\*를 선택합니다.
   4. AdMob 데이터에 대한 프로젝트 액세스, 접근 권한 부여
   5. 그런 다음 1단계의 권한 부여, 인증 코드를 수신하면 **Exchange 권한 부여, 인증 code for tokens** 버튼을 선택할 수 있습니다. 그런 다음 \*\*Refresh 토큰 액세스, 접근 토큰 받게 됩니다.

4) 이 모든 파라미터를 얻은 후 레벨플레이 Google AdMob 계정 설정에 입력합니다.
5) 다음으로 Instances 페이지로 이동합니다 페이지 상단에서 Unity 레벨플레이 Mediation Google 입찰을 실행할 앱을 선택합니다.
6) Ad Networks의 설정 목록에서 Google을 선택하고 도구 **정의** 아이콘을 선택합니다. 그런 다음 **앱 ID**와 **광고 유닛** **ID를** **인터스티셜** 광고, **보상형 광고** **비디오** 또는 **배너 설정**에 삽입합니다.

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

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

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

Unity 개발 플랫폼에서 **레벨플레이** > **통합 관리자**로 이동합니다.

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

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

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

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

3단계에서 가져온 APP ID 값으로 `GADApplicationIdentifier` 값을 교체합니다. 이렇게 하지 않으면 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" 파라미터로 설정합니다.

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

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

```text
 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

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

## 다음 단계##next-steps

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