유니티 플러그인의 인터스티셜(전면) 광고 연동

1단계. 인터스티셜(전면) 광고 이벤트들을 구현하기

아이언소스 유니티 플러그인은 광고 준비 상태 전달을 위해 여러가지 이벤트를 송출합니다.

아래의 코드를 추가하여 이벤트들을 등록해 주세요:

//Add AdInfo Interstitial Events
IronSourceInterstitialEvents.onAdReadyEvent += InterstitialOnAdReadyEvent;
IronSourceInterstitialEvents.onAdLoadFailedEvent += InterstitialOnAdLoadFailed;
IronSourceInterstitialEvents.onAdOpenedEvent += InterstitialOnAdOpenedEvent;
IronSourceInterstitialEvents.onAdClickedEvent += InterstitialOnAdClickedEvent;
IronSourceInterstitialEvents.onAdShowSucceededEvent += InterstitialOnAdShowSucceededEvent;
IronSourceInterstitialEvents.onAdShowFailedEvent += InterstitialOnAdShowFailedEvent;
IronSourceInterstitialEvents.onAdClosedEvent += InterstitialOnAdClosedEvent;

해당 플러그인은 아래의 가능한 모든 이벤트 발생 정보를 리스너에 전달합니다:

/************* Interstitial AdInfo Delegates *************/
// Invoked when the interstitial ad was loaded succesfully.
void InterstitialOnAdReadyEvent(IronSourceAdInfo adInfo) {
}
// Invoked when the initialization process has failed.
void InterstitialOnAdLoadFailed(IronSourceError ironSourceError) {
}
// Invoked when the Interstitial Ad Unit has opened. This is the impression indication. 
void InterstitialOnAdOpenedEvent(IronSourceAdInfo adInfo) {
}
// Invoked when end user clicked on the interstitial ad
void InterstitialOnAdClickedEvent(IronSourceAdInfo adInfo) {
}
// Invoked when the ad failed to show.
void InterstitialOnAdShowFailedEvent(IronSourceError ironSourceError, IronSourceAdInfo adInfo) {
}
// Invoked when the interstitial ad closed and the user went back to the application screen.
void InterstitialOnAdClosedEvent(IronSourceAdInfo adInfo) {
}
// Invoked before the interstitial ad was opened, and before the InterstitialOnAdOpenedEvent is reported.
// This callback is not supported by all networks, and we recommend using it only if  
// it's supported by all networks you included in your build. 
void InterstitialOnAdShowSucceededEvent(IronSourceAdInfo adInfo) {
}

2단계. 인터스티셜 광고 로드하기

인터스티셜 광고의 경우 로딩 과정에 시간이 걸릴 수 있기 때문에 어느정도 시간을 두고 미리 로딩하는 것이 좋습니다. 인터스티셜 광고를 요청하려면 아래의 메서드를 호출해 주세요:

IronSource.Agent.loadInterstitial();

3단계. 광고 준비 상태 확인하기

2단계에서 loadInterstitial을 호출한 다음, InterstitialOnAdReadyEvent 메서드를 포함한 리스너를 통해 광고가 로딩되고 사용자에게 표시할 준비가 되었음이 이벤트로 전달됩니다.

public void InterstitialAdReadyEvent(){}

또는, 아래의 함수를 직접 호출해서 광고 준비 상태를 확인할 수도 있습니다:

IronSource.Agent.isInterstitialReady()

4단계. 인터스티셜 광고 내보내기

onInterstitialOnAdReadyEvent 콜백을 수신하고 나면, 인터스티셜 광고를 사용자에게 표시할 준비가 완료된 것입니다. 사용자에게 최상의 광고 경험을 제공하기 위해서는 광고가 표시되는 동안 오디오를 비롯한 모든 게임 동작을 일시 정지해 주세요.

다음의 메서드를 호출하여 사용자에게 인터스티셜 광고를 송출하세요:

IronSource.Agent.showInterstitial();

레벨플레이 광고 플레이스먼트(게재 위치)로 인터스티셜 광고 경험을 커스터마이징 및 최적화 할 수 있습니다. 이 도구를 사용해 인터스티셜 광고를 앱 내의 각기 다른 곳(예: 앱 구동 시, 단계 사이 화면 등)에서 표시할 수 있습니다. 다음 단계의 함수를 사용해서 어느 플레이스먼트에서 광고를 표시할 지 지정할 수 있습니다. 광고 플레이스먼트(게재 위치) 문서에서 더 자세한 사항을 확인하세요.

void showInterstitial(string placementName);

아이언소스의 광고 플레이스먼트기능에서는 특정 플레이스먼트의 광고의 횟수 제한 및 빈도 제한 설정도 할 수 있습니다. 광고의 횟수 및 빈도 제한은 지정된 시간 동안에 게재 가능한 광고의 숫자를 제한하여 사용자의 앱 사용 경험을 향상시킵니다. 횟수 및 빈도 제한에 대한 더 자세한 사항은 여기를 참고하세요.

사용자에게 인터스티셜 광고를 제공하기 전에 아래와 같이 광고가 게재될 플레이스먼트가 횟수 제한이 있는지 확인해 보시기를 권장 드립니다:

IronSource.Agent.isInterstitialPlacementCapped(placementName)

최초 연동시의 팁
만약 앱에 처음으로 아이언소스 SDK를 연동하는 경우라면, 이 앱은 아이언소스 대시보드에서 ‘테스트 모드’로 기본 설정되어 있을 것입니다. 앱이 테스트 모드일 때에는 아이언소스 SDK는 SDK 처리과정을 좀 더 자세히 볼 수 있도록 더 많은 로그를 콘솔에 송출합니다. 광고 인벤토리 테스트를 위해서는, 테스트 기기를 설정해 주세요. 광고 인벤토리를 라이브 (상용) 모드로 변경하기 전까지는 테스트 캠페인에서 광고를 받고 이 광고들은 수익을 발생시키지 않습니다. 상용 광고 인벤토리의 광고를 앱에 게재할 준비가 되었다면 반드시 Ad Units 페이지에서 Go Live!를 선택해 주세요.

완료했습니다!
이제 아이언소스 인터스티셜 광고를 레벨플레이 미디에이션 플랫폼을 통해 제공할 수 있습니다!