# Unity Ads 연동

> 계정을 생성하고 앱을 추가하고 광고 레벨플레이 광고 네트워크세

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

이 가이드는 Unity 레벨플레이 Unity Ads 광고 네트워크로 게재하는 방법에 대한 단계별 지침을 제공합니다.

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

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

## 필수 조건##prerequisites

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

**Rewarded ads integration:**

* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md)
* \[Android]\(/grow/levelplay/sdk/android/보상형 광고 통합)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md.md)
* \[Adobe Air]\(/grow/levelplay/sdk/adobe/보상형 광고 통합)
* \[플러터]\(/grow/levelplay/sdk/flutter/보상형 광고 통합)
* \[네이티브 반응]\(/grow/levelplay/sdk/react/보상형 광고 통합)

**Interstitial integration:**

* \[Unity]\(/grow/levelplay/sdk/unity/intersticial 광고 통합)
* \[Android]\(/grow/levelplay/sdk/android/interstitial 광고 통합)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md.md)
* \[Adobe Air]\(/grow/levelplay/sdk/adobe/interstitial 광고 통합)
* \[플러터]\(/grow/levelplay/sdk/플러터/인터스티셜 광고 통합)
* \[네이티브 반응]\(/grow/levelplay/sdk/react/interstitial 광고 통합)

**Banner integration:**

* \[Unity]\(/grow/levelplay/sdk/Unity/배너 통합)
* \[Android]\(/grow/levelplay/sdk/android/ 배너 통합)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md.md)
* \[Adobe Air]\(/grow/levelplay/sdk/adobe/ 배너 통합)
* \[플러터]\(/grow/levelplay/sdk/flutter/ 배너 통합)
* \[네이티브 반응]\(/grow/levelplay/sdk/react/ 배너 통합)

- Unity Ads Android 운영체제 버전 4.4(API 레벨 19) 이상을 지원합니다.
- Unity Ads SDK 4.7.1 이상에는 최소 컴파일 SDK 버전 33 및 최소 Kotlin 버전 1.7.0 이상이 필요합니다.

## 1단계. Unity Ads 설정

Unity Ads 설정 전에 다음 단계를 완료하십시오.

1. [Unity ID 만들기](/cloud/accounts/create-account.md.md)
2. [Unity에 가입합니다.](https://cloud.unity.com)

> **Note:**
>
> 1단계를 완료한 후 [4단계](/grow/levelplay/sdk/unity/mediation-network-guides.md.md)로 건너뛰고 자동 입찰자 설정 툴을 사용하여 Unity 레벨플레이에서 Unity Ads 입찰자를 시작하고 실행할 수 있습니다. 매뉴얼 설정을 계속하려면 2단계를 계속하십시오.

## 2단계. Unity Ads 프로젝트 생성

다음 단계에 따라 Unity Ads 앱을 생성합니다.

### 앱 만들기

1. [Unity 수익화 대시보드](https://cloud.unity.com/monetization)에서 **프로젝트**를 선택합니다.

2. **조직**을 선택한 다음 **프로젝트**를 선택합니다.

3. **프로젝트 생성**을 선택합니다.

   ![프로젝트 만들기 버튼](/api/media?file=/grow/media/images/Screenshot-2023-04-30-at-5.45.44.png)

4. 프로젝트 이름과 [COPPA](https://www.ftc.gov/enforcement/rules/rulemaking-regulatory-reform-proceedings/childrens-online-privacy-protection-rule) 설정을 입력합니다.

5. **프로젝트 생성**을 선택합니다.

   ![프로젝트 양식 만들기](/api/media?file=/grow/media/images/Screenshot-2023-04-30-at-5.47.25.png)

프로젝트를 수익화하려면 대시보드에서 Unity Ads 활성화하다, 사용 가능하다 합니다. 수익화 대시보드의 두 번째 내비게이션 메뉴에서 **Get started**를 선택합니다.

프로젝트에서 Unity Ads를 초기화할 때 Mediation 공급자를 선택해야 합니다. **I plan to use Mediation**을 선택합니다. 그런 다음 **Mediation 파트너 선택**에서 **Unity 레벨플레이를 선택합니다.**
![Mediation 파트너 선택](/api/media?file=/grow/media/images/Screenshot-2023-04-30-at-5.48.59.png)

### 광고 유닛 생성

광고 콘텐츠를 트리거하는 게임의 이벤트 표면을 표시하려면 [광고 유닛](/grow/levelplay/platform/get-started/ad-units.md.md)을 사용합니다.

1. 왼쪽 내비게이션 메뉴에서 **수익화 > 광고 유닛**을 선택합니다.
2. **Add Ad Unit**을 선택하여 생성 모달을 불러옵니다.
3. 광고 유닛 이름을 입력한 다음 플랫폼(iOS 또는 Android) 및 [광고 형식](/grow/levelplay/platform/get-started/ad-units.md.md)(보상형 광고, 인터스티셜 광고 또는 배너)을 선택합니다.
4. 광고 유닛을 저장하려면 **Create를 선택**합니다.

### 플레이스먼트 추가

프로젝트가 생성되면 **수익화 > 플레이스먼트**로 이동하여 두 플랫폼의 **게임 ID**를 참고하십시오.

![게임 ID 위치](/api/media?file=/grow/media/images/Screenshot-2023-04-30-at-8.42.10.png)

새 플레이스먼트를 생성하려면 **플레이스먼트 추가**를 선택합니다.

> **Note:**
>
> Unity Ads 프로젝트를 처음 생성할 때 "기본" 플레이스먼트를 자동으로 생성하지만, 각 Unity Ads Mediation 설정 대해 새로운 고유 플레이스먼트를 생성하는 것이 좋습니다.

## 3단계. 자격 증명 검색

레벨플레이 설정을 완료하려면 Unity Ads 플랫폼에서 다음 세부 정보를 검색해서 가져와야 합니다.

* API 키
* 조직 코어 ID
* Key ID
* Secret key

**설정 > API 관리**로 이동하여 **API 키**를 참고하십시오.

![API 키 위치](/api/media?file=/grow/media/images/Screenshot-2023-04-30-at-8.42.33.png)

그런 다음 조직 설정으로 이동하여 **조직 핵심 ID**를 참고하십시오.

![조직 코어 ID](/api/media?file=/grow/media/images/Screenshot-2023-04-30-at-8.43.02.png)

**키 ID와 비밀 키를** 검색하려면 **수익화**로 이동한 다음 **API 관리로 이동합니다.** **Create LevelPlay Service Account**를 선택하면 모달이 열쇠 ID와 비밀 키와 함께 나타납니다. 모달을 닫은 후 다시 가져올 수 없으므로 비밀 키를 저장해야 합니다.
![레벨플레이 서비스 계정 생성](/api/media?file=/grow/media/images/Screen-Shot-2023-06-19-at-12.03.32-2.png)

## 4단계. 레벨플레이 Unity Ads 설정 

이 모든 파라미터를 사용하면 레벨플레이 계정에 로그인합니다.

* '**Mediation**' > '**설정**' > '**SDK Networks**'로 이동합니다.

  ![SDK 네트워크 페이지](/api/media?file=/grow/media/images/Screenshot-2023-07-11-at-10.01.15-1.png)

* 사용 가능한 네트워크 목록에서 Unity Ads 선택합니다.

* 관련 필드에 Unity Ads **API 키**와 **조직 핵심 ID**를 입력합니다.

  ![Unity Ads API 키 및 조직 ID](/api/media?file=/grow/media/images/Unity-updated-1-1-1.png)

* 자동 설정 기능을 활성화 Unity Ads 자동 설정 툴을 토글. 이렇게 하면 Unity Ads 플랫폼에서 앱과 입찰자 배치를 자동으로 생성하고 레벨플레이가 Unity Ads에서 배치 세부 정보를 가져올 수 있습니다.

* 자동 설정 툴을 토글한 후 3단계에서 키 ID와 비밀 키를 입력합니다. 그런 다음 **저장**을 선택합니다.
  ![Unity Ads 자동 설정](/api/media?file=/grow/media/images/Unity-updated-2-1.png)

> **Note:**
>
> 자동 설정 툴을 토글 레벨플레이 수동으로 Unity Ads 입찰을 설정 수 있습니다.

## 5단계: 앱 레벨에서 Unity Ads 설정

### 기존 워터폴 설정 

* SDK Networks 페이지 왼쪽에 있는 목록에서 연동하려는 앱을 선택합니다.
* 광고 유닛 행에서 **설정**을 선택하고 관련 광고 유닛 설정 아래에 **게임 ID** 및 **플레이스먼트** **ID를** 입력합니다.
  ![Unity Ads 워터폴 설정](/api/media?file=/grow/media/images/F15F95A0-A7C7-40AF-A955-8C9BE6DB9621.png)
* 그러면 설정 대시보드에서 Unity Ads가 Mediation을 위한 **액티브**로 표시됩니다.

### 입찰자 설정

레벨플레이 Unity Ads 입찰자를 설정하는 방법에는 두 가지가 있습니다.

1. **자동 설정** - Unity Monetize 대시보드에서 새 앱과 플레이스먼트를 자동으로 생성하고 레벨플레이에 필요한 모든 설정을 입력합니다.
2. **매뉴얼** - 레벨플레이 및 Unity Ads 플랫폼에서 필요한 앱 세부 정보를 수동으로 입력합니다.

**자동 설정**

* Unity Ads 인터스티셜 광고 광고, 보상형 광고 광고 또는 배너 광고를 게재할 앱을 선택합니다. 그런 다음 Unity Ads 행에서 정의 아이콘을 선택합니다.

  ![Unity Ads 입찰자 설정 아이콘](/api/media?file=/grow/media/images/Screenshot-2023-07-11-at-10.20.55.png)

* Unity Ads 플랫폼에서 새 앱과 입찰 플레이스먼트를 자동으로 생성하고 게임 ID와 플레이스먼트 ID를 임포트하려면 **Add bidder를 선택**합니다. 앱에 이미 연결된 게임 ID가 있는 경우 플레이스먼트 ID 파라미터 값이 없는 플레이스먼트가 1개 이상 있는 경우 자동 설정 툴을 사용할 수 있습니다. 이 경우 새 입찰 플레이스먼트가 생성됩니다(게임 ID 삽입용).

  ![입찰자 자동 설정 추가](/api/media?file=/grow/media/images/68A72BE2-91CF-4DA0-8CD4-70FE035A8120-1-1-1.png)

**저장**을 선택하여 모든 구성을 승인하고 승인합니다. 저장하지 않고 모듈을 닫으면 레벨플레이 플랫폼으로 데이터를 임포트하지 않고 Unity Ads 플랫폼에서 에셋이 생성됩니다.

**중요:** Unity Ads 입찰자 인스턴스의 상태는 광고 유닛별로 Ironsource Ads 입찰자의 상태와 동일합니다. 예를 들어 보상형 광고 광고에 Ironsource 광고 입찰자를 사용하지 않는 경우 Unity Ads 네트워크에서 자동으로 활성화되지 않습니다. 보상형 광고 광고에 대한 Unity Ads 입찰 인스턴스 활성화 Unity Ads 행을 선택하고 광고 유닛에서 토글. 

**매뉴얼 설정**

* Unity Ads 인터스티셜 광고 광고 또는 보상형 광고 광고를 게재할 앱을 선택합니다.

* Ad Networks 설정 목록에서 Unity Ads 선택하고 정의 아이콘을 선택하고 관련 필드에 게임 ID와 플레이스먼트 ID를 삽입합니다.

* **저장**을 선택합니다.

이제 계정에서 원하는 광고 유닛에 대해 Unity Ads 활성화된 것으로 표시됩니다.

## 6단계. 빌드 Unity Ads 어댑터 추가하기##step-6.-add-the-unity-ads-adapter-to-your-build

### Unity 네트워크 관리자(권장)##unity-network-manager-(recommended)

SDK 연동이 완료되면 Unity 네트워크 관리자 사용하여 Unity Ads 어댑터 다운로드 수 있습니다.

Unity 개발 플랫폼에서 Ads Mediation > 네트워크 관리자 이동합니다.

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

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

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

#### ProGuard 사용자 전용(Android)##for-proguard-users-only-(android)

ProGuard를 Unity Ads 어댑터 함께 사용하는 경우 다음 코드를 ProGuard 설정 추가해야 합니다.

```text
# Keep filenames and line numbers for stack traces##keep-filenames-and-line-numbers-for-stack-traces
-keepattributes SourceFile,LineNumberTable
# Keep JavascriptInterface for WebView bridge##keep-javascriptinterface-for-webview-bridge
-keepattributes JavascriptInterface
# Sometimes keepattributes is not enough to keep annotations##sometimes-keepattributes-is-not-enough-to-keep-annotations
-keep class android.webkit.JavascriptInterface {
   *;
}
# Keep all classes in Unity Ads package##keep-all-classes-in-unity-ads-package
-keep class com.unity3d.ads.** {
   *;
}
# Keep all classes in Unity Services package##keep-all-classes-in-unity-services-package
-keep class com.unity3d.services.** {
   *;
}
-dontwarn com.google.ar.core**
-dontwarn com.unity3d.services.**
-dontwarn com. 아이언소스.adapters.unityads.**
```

#### iOS 업데이트 프로퍼티 목록 파일(Info.plist)##ios-update-property-list-file-(info.plist)

Unity Ads SDK 3.4.8 이상에서는 앱 프로퍼티 목록 파일(Info.plist)에 Unity Ads 광고 네트워크 ID를 포함해야 합니다. Unity Ads SKAdNetwork ID에 대한 자세한 내용은 [여기](/grow/ads/ios-sdk/ios14/configure-ad-network-ids.md)에서 확인하십시오.

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

> **Note:**
>
> Unity Ads Unity 플러그인 현재 동영상 광고만 지원합니다.

1. Unity Ads 어댑터 다운로드

   어댑터 다운로드 [여기](/grow/levelplay/sdk/android/mediation-networks.md)에서.

2. Unity Ads 파일을 Unity 프로젝트 추가합니다.

   파일을 \*\*Assets/Plugins/Android/\*\*로 임포트합니다.

> **Note:**
>
> Unity 버전 5.5의 변경 사항을 수용하려면 레벨플레이 플러그인 버전 6.7.1에서 플러그인 및 Mediation 어댑터에 대해 별도로 Android 매니페스트를 추가해야 합니다. 플러그인을 업데이트하거나 현재 6.7.1에서 실행 중인 경우 [Android 문서](/grow/levelplay/sdk/android/networks/guides/unity-ads.md)에 명시된 매니페스트 작업을 추가해야 합니다.

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

> **Note:**
>
> Unity Ads Unity 플러그인 현재 동영상 광고만 지원합니다.

1. Unity Ads iOS 어댑터 및 SDK 다운로드

   iOS용 [Mediation 네트워크를 참고하십시오](/grow/levelplay/sdk/ios/mediation-networks.md).

2. Unity Ads 파일을 Unity 프로젝트 추가합니다.

   파일의 압축을 풀면 어댑터와 SDK 파일을 **Assets/Plugins/iOS로 임포트합니다.**

Unity 플러그인 필요한 프레임워크를 Xcode 프로젝트에 자동으로 추가합니다.

## 7단계 Unity Ads 추가 설정##step-7.-unity-ads-additional-settings

### 사용자 레벨 COPPA##user-level-coppa

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

다음 구문을 사용하여 Unity Ads 사용자.nonBehavioral 플래그를 True 파라미터로 설정합니다.

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

다음 구문을 사용하여 Unity Ads 사용자.nonBehavioral 플래그를 False 파라미터로 설정합니다.

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

## 광고 네트워크 통합 평가##evaluate-your-ad-network-integration

* [통합 도우미](/grow/levelplay/sdk/unity/integration-helper.md)에서 광고 네트워크 통합을 확인하십시오. 레벨플레이 SDK는 SDK와 추가 네트워크 어댑터를 성공적으로 연동했는지 확인하는 툴을 제공합니다.
* 이 부울을 사용하여 통합 Mediation 광고 네트워크의 디버그 로그를 관리합니다.

  ```text
  LevelPlay.SetAdaptersDebug(true);
  ```

  **TRUE**로 설정하면 이 코드 라인은 디버그 로그를 활성화하고, 사용 가능하게 하는 모든 Mediation 광고 네트워크의 문제 해결을 지원합니다.  앱이 광고 유닛으로 게재되기 전에 이 코드를 제거합니다. SDK 버전 6.5.2 이상에서 지원됩니다.

이제 애플리케이션 내에서 Unity Ads 광고를 게재할 수 있습니다.

## 다음 단계##next-steps

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