# Unity 인터스티셜 광고 광고 유닛 API 마이그레이션

> SDK를 초기화하고 광고 형식을 정의하고 광고 유닛 ID를 사용하여 인터스티셜 광고 로드하고 표시하여 레벨플레이 인터스티셜 광고 광고 유닛 API 전환.

이 가이드에서는 현재 구현에서 광고 유닛 ID를 사용하여 레벨플레이 인터스티셜 광고 API로 전환 인터스티셜 광고 로드하고 표시하는 방법을 설명합니다.

## 필수 조건##prerequisites

* 지원되는 최소 SDK는 8.6.0입니다. 최신 SDK는 [여기](/grow/levelplay/sdk/unity/package-integration.md)에서 다운로드할 수 있습니다.
* 레벨플레이 초기화 API 사용하여 SDK를 초기화해야 합니다.
* 레벨플레이 대시보드에서 AdUnitID를 찾습니다. 자세히 알아보기 [여기](/grow/levelplay/platform/get-started/ad-units.md).

## **인터스티셜 광고 오브젝트 만들기**##**create-interstitial-ad-object**

인터스티셜 광고 오브젝트의 생성은 **OnInitSuccess** 콜백을 수신한 후에 수행해야 합니다.

오브젝트 세션 전체에 걸쳐 여러 로드와 표시를 처리할 수 있는 재사용 가능한 인스턴스. 생성 후에는 동일한 광고 유닛의 광고를 로드하고 표시하는 데 사용해야 합니다.

더 고급 구현을 위해 필요한 경우 여러 개의 인터스티셜 광고 객체를 생성할 수 있습니다.

```csharp
// Create interstitial ad object
interstitialAd = new LevelPlayInterstitialAd(interstitialAdUnitId);
```

## 인터스티셜 광고 이벤트 등록##register-to-interstitial-events

광고 전송에 대해 알리기 위해 **LevelPlayInterstitialListener** 대신 코드에 **LevelPlayInterstitialAdListener를** 구현하십시오. 

* 인터스티셜 광고 광고를 로드하기 전에 리스너를 설정하는 것이 좋습니다.
* 각 인터스티셜 광고 광고에는 고유한 리스너 구현이 있어야 합니다.
* 콜백은 메인 스레드 실행됩니다.

```csharp
// Register to interstitial events
interstitialAd.OnAdLoaded += InterstitialOnAdLoadedEvent;
interstitialAd.OnAdLoadFailed += InterstitialOnAdLoadFailedEvent;
interstitialAd.OnAdDisplayed += InterstitialOnAdDisplayedEvent;
interstitialAd.OnAdDisplayFailed += InterstitialOnAdDisplayFailedEvent;
interstitialAd.OnAdClicked += InterstitialOnAdClickedEvent;
interstitialAd.OnAdClosed += InterstitialOnAdClosedEvent;
interstitialAd.OnAdInfoChanged += InterstitialOnAdInfoChangedEvent;

// Implement the events
void InterstitialOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}
void InterstitialOnAdLoadFailedEvent(LevelPlayAdError error) {}
void InterstitialOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}
void InterstitialOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}
void InterstitialOnAdClickedEvent(LevelPlayAdInfo adInfo) {}
void InterstitialOnAdClosedEvent(LevelPlayAdInfo adInfo) {}
void InterstitialOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) {}
```

|    | 레거시                          | 광고 단위(신규)                       |
| -- | ---------------------------- | ------------------------------- |
| 청자 | IronSourceInterstitialEvents | LevelPlayInterstitialAdListener |
| 콜백 | OnAdReady                    | OnAdLoaded                      |
|    | OnAdLoadFailed               | OnAdLoadFailed                  |
|    | OnAdOpened                   | OnAdDisplayed                   |
|    | OnAdClosed                   | OnAdClosed                      |
|    | OnAdShowFailed               | OnAdDisplayFailed               |
|    | OnAdClicked                  | OnAdClicked                     |
|    | OnAdShowSucceeded            | - (사용 중단 예정)                    |
|    | -                            | OnAdInfoChanged                 |

### 레벨플레이 광고 정보##levelplay-ad-info

인터스티셜 광고 리스너 콜백이 반환하는 **AdInfo** 클래스가 **LevelPlayAdInfo**로 대체되었습니다. 자세히 알아보기 [여기](/grow/levelplay/sdk/unity/levelplay-listener-adinfo-integration.md).

## 인터스티셜 광고 로드##load-interstitial-ad

인터스티셜 광고를 로드하려면 **LoadInterstitial** 대신 **LoadAd를** 사용하십시오.

```csharp
// Load interstitial ad
interstitialAd.LoadAd();
```

## 인터스티셜 광고 표시##show-interstitial-ad

**LevelPlayInterstitialAdListener** API를 사용하여 **OnAdLoaded** 콜백을 수신한 후 인터스티셜 광고를 표시합니다.

* 플레이스먼트를 사용하는 경우 아래의 플레이스먼트 섹션에 표시된 대로 **ShowAd** API에서 플레이스먼트 이름을 전달합니다.
* 광고가 사용자 성공적으로 표시되면 로딩 단계를 반복하여 다른 광고를 로드할 수 있습니다.

```csharp
// Show ad without placement
interstitialAd.ShowAd();
// Show ad with placement
interstitialAd.ShowAd(placementName: "placementName");
```

### 광고가 준비되었는지 확인##check-ad-is-ready

표시 실패를 방지하고 광고가 올바르게 표시되었는지 확인하기 위해 **ShowAd** API를 호출하기 전에 다음 API를 사용하는 것이 좋습니다.

**IsAdReady** – 광고가 성공적으로 로드되고 광고 유닛이 제한되지 않거나 거짓이 아닌 경우 true를 반환합니다.

**IsPlacementCapped** – 유효한 플레이스먼트가 제한되면 true를 반환합니다. 플레이스먼트가 유효하지 않거나 제한이 없는 경우 이 API false를 반환합니다.

```csharp
// Check that ad is ready and that the placement is not capped
if (interstitialAd.IsAdReady() && !LevelPlayInterstitialAd.IsPlacementCapped(placementName))
{
    interstitialAd.ShowAd(placementName);
}
```

### Placements##placements

레벨플레이 대시보드에서 인터스티셜 광고의 [플레이스먼트](/grow/levelplay/platform/settings/placements.md) 속도와 한도를 지원합니다. 

인터스티셜 광고를 위한 플레이스먼트가 설정된 경우 특정 플레이스먼트에 광고를 게재하려면 **ShowAd** 메서드를 호출합니다.

```objective-c
// Check that ad is ready and that the placement is not capped
if (interstitialAd.IsAdReady() && !LevelPlayInterstitialAd.IsPlacementCapped(placementName))
{ 
    interstitialAd.ShowAd(placementName); 
}
```

## 여러 광고 유닛 인터스티셜 광고 API##multiple-ad-unit-interstitial-apis

|     | 레거시                           | 광고 단위(신규)               |
| --- | ----------------------------- | ----------------------- |
| 클래스 | 아이언소스(IronSource)             | LevelPlayInterstitialAd |
| API | LoadInterstitial              | LoadAd                  |
|     | ShowInterstitial              | ShowAd                  |
|     | IsInterstitialPlacementCapped | IsPlacementCapped       |
|     | IsInterstitialReady           | IsAdReady               |

## 인터스티셜 광고의 **전체 구현 예시**##**full-implementation-example-of-interstitial-ads**

```csharp
public class InterstitialAdSample {
    private LevelPlayInterstitialAd interstitialAd;
    void CreateInterstitialAd() {
        // Create InterstitialAd instance
        interstitialAd = new LevelPlayInterstitialAd("interstitialAdUnitId");

        // Subscribe InterstitialAd events
        interstitialAd.OnAdLoaded += InterstitialOnAdLoadedEvent;
        interstitialAd.OnAdLoadFailed += InterstitialOnAdLoadFailedEvent;
        interstitialAd.OnAdDisplayed += InterstitialOnAdDisplayedEvent;
        interstitialAd.OnAdDisplayFailed += InterstitialOnAdDisplayFailedEvent;
        interstitialAd.OnAdClicked += InterstitialOnAdClickedEvent;
        interstitialAd.OnAdClosed += InterstitialOnAdClosedEvent;
        interstitialAd.OnAdInfoChanged += InterstitialOnAdInfoChangedEvent;
    }
    void LoadInterstitialAd() {
        // Load or reload InterstitialAd
        interstitialAd.LoadAd();
    }
    void ShowInterstitialAd() {
        // Show InterstitialAd, check if the ad is ready before showing
        if (interstitialAd.IsAdReady()) {
            interstitialAd.ShowAd();
        }
    }
    void DestroyInterstitialAd() {
        // Destroy InterstitialAd
        interstitialAd.DestroyAd();
    }
    // Implement InterstitialAd events
    void InterstitialOnAdLoadedEvent(LevelPlayAdInfo adInfo) { }
    void InterstitialOnAdLoadFailedEvent(LevelPlayAdError error) { }
    void InterstitialOnAdClickedEvent(LevelPlayAdInfo adInfo) { }
    void InterstitialOnAdDisplayedEvent(LevelPlayAdInfo adInfo) { }
    void InterstitialOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) { }
    void InterstitialOnAdClosedEvent(LevelPlayAdInfo adInfo) { }
    void InterstitialOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) { }
}
```

## 레벨플레이 Mediation 데모 앱##levelplay-mediation-demo-app

통합 데모 애플리케이션 앱에 인터스티셜 광고 광고 유닛 API를 통합하는 방법을 보여 줍니다.

[Unity 데모 애플리케이션 다운로드](https://github.com/ironsource-mobile/Mediation-Demo-Apps)
