# Google 입찰 통합

> 레벨플레이 SDK를 사용하여 React Native 앱에 Google 입찰을 Mediation 네트워크로 통합합니다.

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

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

## 필수 조건##prerequisites

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

## AdMob 계정 생성##create-an-admob-account

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

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

## AdMob에서 애플리케이션 및 광고 유닛 생성##create-an-application-and-ad-unit-in-admob

### 앱 추가##add-your-app

1. AdMob 계정에 로그인합니다. 대시보드에서 **앱**을 선택한 다음 **앱 추가**를 선택합니다.
2. 앱을 검색하거나 앱을 수동으로 추가하거나 기존 앱을 선택하여 수익화를 수행할 수 있는 모달이 나타납니다.

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

3. 인터스티셜 광고, 보상형 비디오 또는 배너를 광고 유닛 형식으로 선택하고 관련 세부 정보를 입력합니다.

### 광고 유닛 설정 설정##configure-ad-unit-settings

**인터스티셜 광고**

* **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
* **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.

![Google AdMob 대시보드의 인터스티셜 광고 유닛 설정입니다.](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step2-interstitial.png)

**보상형 비디오**

* **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
* **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.

![Google AdMob 대시보드의 보상형 비디오 광고 유닛 설정입니다.](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step2-rewarded.png)

![Google AdMob 대시보드의 파트너 입찰 체크박스입니다.](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step2-partner-bidding.png)

**배너**

* **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
* **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.

**인터스티셜 광고**

* **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
* **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.

**보상형 비디오**

* **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
* **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.

**배너**

* **Ad unit name**: 광고 유닛의 이름을 직관적으로 지정하면 게재할 광고 유닛으로 쉽게 인식할 수 있습니다.
* **파트너 입찰**: 체크박스를 선택하면 다른 Mediation 플랫폼에서 입찰을 사용하고 있음을 나타냅니다.

## 레벨플레이 네트워크 설정 모듈에서 Google 활성화##activate-google-in-your-levelplay-network-setup-module

### 자동 설정##auto-setup

1. 레벨플레이 계정에 로그인하고 레벨플레이 옆의 내비게이션 바 > **설정** > **네트워크**로 이동합니다.
2. 사용 가능한 광고 네트워크 목록에서 Google AdMob을 선택합니다.

![Google 입찰을 위한 레벨플레이 SDK 네트워크 설정 페이지입니다.](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-levelplay-setup.png)

3. **Google 로그인**을 선택하고 승인된 Google 계정으로 로그인합니다.
4. 이미 로그인한 경우 **재설정 로그인**을 선택합니다(새 로그인 필요).

![레벨플레이 Google 입찰 설정 페이지의 로그인 with Google 버튼입니다.](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-login.png)

5. 로그인하면 **Google 자동 설정 입찰자** 토글

![레벨플레이에서 Google 입찰에 대한 자동 설정 입찰 토글.](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-auto-setup-toggle.png)

6. 이제 **인스턴스** 페이지로 이동하여 인터스티셜 광고, 보상형 광고 또는 배너 광고를 게재할 앱을 선택합니다.

![레벨플레이 Google 입찰 설정 페이지의 인스턴스 선택](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-instances-selection.png)

7. AdMob 플랫폼에서 새 앱과 입찰 플레이스먼트를 자동으로 생성하고 **광고 유닛 ID**를 임포트하려면 **Add Bidder**를 선택합니다. 앱에 이미 연결된 **앱 ID**가 있는 경우, **광고 유닛 ID** 파라미터 값이 없는 플레이스먼트가 1개 이상 있는 경우 자동 설정 툴을 사용할 수 있습니다. 이 경우 새 입찰 플레이스먼트가 생성됩니다.
8. **저장**을 선택하여 모든 구성을 승인하고 승인합니다. 저장하지 않고 모듈을 닫으면 데이터를 레벨플레이 플랫폼으로 임포트하지 않고 AdMob 플랫폼에서 에셋이 생성됩니다.

![레벨플레이 Google 입찰 설정 페이지의 Add Bidder 버튼입니다.](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-add-bidder.png)

> **Important:**
>
> Google 입찰자 인스턴스의 상태는 광고 형식별로 레벨플레이 광고 입찰자의 상태와 동일합니다. 예를 들어 보상형 광고 동영상에 레벨플레이 광고 입찰자를 사용하지 않는 경우 Google 네트워크에 대해 자동으로 활성화되지 않습니다.

### 매뉴얼 설정##manual-setup

1. 레벨플레이 계정에 로그인하고 레벨플레이 옆의 내비게이션 바 > **설정** > **네트워크**로 이동합니다.
2. 사용 가능한 광고 네트워크 목록에서 Google AdMob을 선택합니다.

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

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

이 정보를 얻으면 AdMob의 파라미터를 레벨플레이 설정 합니다.

#### App ID##app-id

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

#### 광고 유닛 ID##ad-unit-id

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

#### 클라이언트 ID 및 클라이언트 비밀##client-id-and-client-secret

1. **클라이언트 ID** 및 **클라이언트 비밀**을 검색하려면 [**Google의 API 관리자**](https://console.cloud.google.com/apis)로 이동합니다.
2. 페이지 왼쪽 상단의 **API 프로젝트** 드롭다운을 선택하고 **프로젝트 생성**을 선택하거나 이 앱에 대해 이미 생성한 프로젝트를 선택합니다. 이 목적으로 새 프로젝트를 생성하는 경우 다이얼로그 상자에 **프로젝트 이름**, **계산 계정** 및 **위치**을 입력하고 **생성**을 선택합니다.
3. 왼쪽 사이드바에서 **인증정보를** 선택한 다음 **OAuth 동의 화면** 탭을 선택합니다. **제품 이름**을 입력하고 **저장**을 선택합니다.
4. 왼쪽 사이드바에서 **대시보드**를 선택하고 **활성화, 사용 가능한 API 및 서비스**로 이동합니다.
5. 다음으로, **AdMob API를 사용 가능하다**.
6. 왼쪽 사이드바에서 **자격 증명** 탭을 선택합니다. **Create Credentials** 드롭다운을 선택하고 **OAuth 클라이언트 ID를 선택**합니다.
7. **웹 애플리케이션**을 선택하고 앱 이름을 입력합니다. 아래 필드에는 최소 하나의 **승인된 리디렉트 URI**에 대한 `https://developers.google.com/oauthplayground`를 입력해야 합니다. 예제는 아래와 같습니다.
   * **JavaScript 원점 승인**: `https://YOUR_NAMESPACE`(선택 사항)
   * **승인된 리디렉트 URI**: `https://developers.google.com/oauthplayground`
8. **Create**를 선택하면 **클라이언트 ID**와 **클라이언트 비밀**이 표시됩니다.

#### 갱신 토큰##refresh-token

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** 및 **클라이언트 비밀**을 입력합니다.
3. 다음으로, **단계 1: API를 선택하고 권한을 부여한다**고, `https://www.googleapis.com/auth/admob.report`를 입력하고 **권한을 부여한다 API**를 선택한다.
4. AdMob 데이터에 대한 프로젝트 액세스, 접근 권한 부여
5. 그런 다음 **단계 1**에서 **권한 부여, 인증 코드**를 받으시면 **토큰 권한 부여, 인증 코드** 버튼을 선택할 수 있습니다. 그런 다음 **새로고침 토큰**과 **액세스, 접근 토큰**을 받게 됩니다.

이 모든 파라미터가 있으면 **레벨플레이**의 **Google AdMob** 계정 설정에 입력합니다.

1. 다음으로 **인스턴스** 페이지로 이동합니다. 페이지 상단에서 레벨플레이의 Mediation with **Google** 입찰을 실행할 앱을 선택합니다.
2. **광고 네트워크**의 설정 목록에서 **Google**을 선택하고 **정의** 아이콘을 선택합니다. 그런 다음 **인터스티셜 광고**, **보상형 비디오** 또는 **배너 설정**에서 **앱 ID** 및 **광고 유닛 ID**를 삽입합니다.

## 빌드 AdMob 어댑터 추가하기##add-the-admob-adapter-to-your-build

[Android](/grow/levelplay/sdk/android/networks/guides/google-admob/.md) 및 [iOS](/grow/levelplay/sdk/ios/networks/guides/google-admob/.md)용 네이티브 어댑터를 사용하여 통합을 계속 진행합니다.

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

레벨플레이 SDK는 Mediation 통합이 성공적으로 완료되었는지 확인하는 간편한 방법을 제공합니다. 레벨플레이와 추가 광고 네트워크의 통합을 확인하려면 이 [문서](/grow/levelplay/sdk/react/integration-helper.md)를 따르십시오.

이제 애플리케이션 내에서 AdMob Ads를 제공할 준비가 되었습니다!

## 다음 단계##next-steps

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