# 레벨플레이 Init API 마이그레이션

> SDK 버전 8.4.0부터 SDK 버전 9.0.0 이상에서 필요로 하는 새로운 광고 유닛 API를 지원하려면 레벨플레이 초기화 API로 전환.

이 가이드에서는 새로운 광고 유닛 API로 전환할 때 레벨플레이 초기화하는 방법을 설명합니다.

## 필수 조건##prerequisites

지원되는 최소 SDK는 8.4.0입니다. Unity 패키지 관리자에 최신 Ads Mediation 패키지를 설치하거나 네트워크 관리자에서 업그레이드하거나 [여기](/grow/levelplay/sdk/unity/package-integration.md)의 지침에 따라 최신 SDK를 다운로드할 수 있습니다.

## SDK 초기화##initialize-the-sdk

레벨플레이 SDK를 초기화하려면 다음 단계를 따르십시오.

1. 이전에 레거시 Ironsource API를 참조한 콜백과 광고 형식을 제거합니다.
2. 초기화 성공 또는 실패에 대한 콜백을 구현합니다.
3. 해당하는 경우 appKey와 사용자 ID를 사용하여 레벨플레이 init API 호출.
4. [배너](/grow/levelplay/sdk/unity/banner-integration.md), [인터스티셜 광고](/grow/levelplay/sdk/unity/interstitial-integration.md) 및 [보상형](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md) 광고 객체를 만듭니다.

C# 스크립트 상단에 `using Unity.Services.LevelPlay;`를 추가합니다. 그런 다음 MonoBehaviour의 `Start()` 메서드 내에서 리스너를 등록하고 SDK를 초기화합니다.

1. **C#**

   ```csharp
   void Start()
   {
       // OnInitSuccess 및 OnInitFailed 리스너 등록
       LevelPlay.OnInitSuccess += SdkInitializationCompletedEvent;
       LevelPlay.OnInitFailed += SdkInitializationFailedEvent;
       // 해당하는 경우 appKey 및 사용자 ID를 사용하여 레벨플레이 init API 호출
       LevelPlay.Init("YOUR_APPKEY", "UserId");
   }
   ```

## 레벨플레이 Init 리스너##levelplay-init-listeners

`OnInitSuccess` – 초기화가 성공적으로 완료되면 트리거됩니다. 이 표시를 수신하면 광고를 생성하고 로드할 수 있습니다.

`OnInitFailed` – 설정이 성공적으로 검색되지 않았으며 광고를 로드할 수 없습니다. 나중에 레벨플레이 SDK를 초기화하는 것이 좋습니다(인터넷 연결이 가능하거나 오류 원인이 해결된 경우).

|     | 레거시                      | 광고 단위(신규)          |
| --- | ------------------------ | ------------------ |
| 클래스 | 아이언소스(IronSource)        | 레벨플레이              |
| API | init                     | 이니트                |
| API | setUserID                | 이니트의 일부로 설정되어야 한다. |
| 콜백  | onInitializationComplete | OnInitSuccess      |
|     | -                        | OnInitFailed       |

## 레벨플레이 데모 씬 앱##levelplay-demo-scene/sample-app

Unity 데모 씬 애플리케이션 앱에 광고 유닛 API를 연동하는 방법을 보여 줍니다. Unity 패키지 관리자 [패키지 세부 정보](https://docs.unity3d.com/Manual/upm-ui-details.html) 뷰에서 Samples로 이동하여 레벨플레이 샘플을 임포트합니다.

이제 새로운 광고 유닛 API를 구현할 수 있습니다.