Unity 배너 통합

필수 조건

• 레벨플레이 SDK를 애플리케이션 올바르게 연동했는지 확인합니다. 통합은 여기 설명되어 있습니다.
• 레벨플레이 초기화 API 사용하여 SDK를 초기화해야 합니다.
• 레벨플레이 대시보드에서 AdUnitID를 찾습니다. 자세히 알아보기 여기.

배너 광고 오브젝트 생성, 크기 및 위치 설정

// Create the banner object and set the ad unit id LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(bannerAdUnitId);

LevelPlayBannerAd

Config

// Use optional Config parameterLevelPlayBannerAd(string adUnitId, Config config = null)

Config

adUnitId

Config

var configBuilder = new LevelPlayBannerAd.Config.Builder();configBuilder.SetSize(LevelPlayAdSize.LARGE);configBuilder.SetPosition(LevelPlayBannerPosition.TopCenter);configBuilder.SetDisplayOnLoad(true);configBuilder.SetRespectSafeArea(true); // Only relevant for AndroidconfigBuilder.SetPlacementName("bannerPlacement");configBuilder.SetBidFloor(1.0); // Minimum bid price in USDvar bannerConfig = configBuilder.Build();bannerAd = new LevelPlayBannerAd(bannerAdUnitId, bannerConfig);

배너 크기

• 레벨플레이 SDK 8.8.0 이상의 경우 다음을 사용하여 배너 로드하기 전에 반환될 적응적 배너 너비와 높이를 결정할 수 있습니다.

LevelPlayAdSize adSize = LevelPlayAdSize.CreateAdaptiveAdSize();int width = adSize.Width;int height = adSize.Height;

• For LevelPlay SDK below 8.8.0:

LevelPlayAdSize adSize = LevelPlayAdSize.CreateAdaptiveAdSize();

LevelPlayAdSize adSize = LevelPlayAdSize.BANNER;

배너 위치

• TopLeft
• TopCenter
• TopRight
• CenterLeft
• 센터
• CenterRight
• BottomLeft
• BottomCenter
• BottomRight

LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(adUnitId, LevelPlayAdSize.BANNER, LevelPlayBannerPosition.TopLeft);

LevelPlayBannerPosition

LevelPlayBannerPosition position = new LevelPlayBannerPosition(new Vector2(x, y));LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(adUnitId, adSize, position, placementName, displayOnLoad, respectSafeArea);

Placements

LoadAd

// Set the placement nameLevelPlayBannerAd bannerAd = new LevelPlayBannerAd("bannerAdUnitId", LevelPlayAdSize.BANNER, placementName:"placementName");

배너 이벤트 구현

LevelPlayBannerAd

• 배너 광고를 로드하기 전에 리스너를 설정하는 것이 좋습니다.
• 각 배너 광고에는 자체 리스너 구현이 있어야 합니다.
• 콜백은 메인 스레드 실행됩니다.

// Register to the events bannerAd.OnAdLoaded += BannerOnAdLoadedEvent;bannerAd.OnAdLoadFailed += BannerOnAdLoadFailedEvent;bannerAd.OnAdDisplayed += BannerOnAdDisplayedEvent;bannerAd.OnAdDisplayFailed += BannerOnAdDisplayFailedEvent;bannerAd.OnAdClicked += BannerOnAdClickedEvent;bannerAd.OnAdCollapsed += BannerOnAdCollapsedEvent;bannerAd.OnAdLeftApplication += BannerOnAdLeftApplicationEvent;bannerAd.OnAdExpanded += BannerOnAdExpandedEvent;// Implement the eventsvoid BannerOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdLoadFailedEvent(LevelPlayAdError ironSourceError) {}void BannerOnAdClickedEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}void BannerOnAdCollapsedEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdLeftApplicationEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdExpandedEvent(LevelPlayAdInfo adInfo) {}

레벨플레이 광고 정보

LevelPlayAdInfo

배너 광고 로드

LoadAd

bannerAd.LoadAd();

배너 새로고침 일시 정지 및 재개

// Pause refreshbannerAd.PauseAutoRefresh();// Resume refreshbannerAd.ResumeAutoRefresh();

배너 숨기기 및 표시

// Show ad bannerAd.ShowAd(); // Hide ad bannerAd.HideAd();

디스플레이 컷아웃(Android만 해당)

LevelPlayBannerAd

respectSafeArea

Config

var configBuilder = new LevelPlayBannerAd.Config.Builder();configBuilder.SetRespectSafeArea(true); // Only relevant for Androidvar bannerConfig = configBuilder.Build();bannerAd = new LevelPlayBannerAd(bannerAdUnitId, bannerConfig);

배너 광고 삭제

DestroyAd

LevelPlayBannerAd

bannerAd.DestroyAd();

배너 광고의 전체 구현 예시

public class BannerAdSample {  private LevelPlayBannerAd bannerAd;  void CreateBannerAd() {    // Create ad configuration - optional    var adConfig = new LevelPlayBannerAd.Config.Builder()      .SetSize(LevelPlayAdSize.BANNER)      .SetPlacementName("placementName")      .SetPosition(LevelPlayBannerPosition.BottomCenter)      .SetDisplayOnLoad(true)      .SetRespectSafeArea(true)      .Build();            // Create banner instance    bannerAd = new LevelPlayBannerAd("bannerAdUnitId", adConfig);    // Subscribe BannerAd events    bannerAd.OnAdLoaded += BannerOnAdLoadedEvent;    bannerAd.OnAdLoadFailed += BannerOnAdLoadFailedEvent;    bannerAd.OnAdDisplayed += BannerOnAdDisplayedEvent;    bannerAd.OnAdDisplayFailed += BannerOnAdDisplayFailedEvent;    bannerAd.OnAdClicked += BannerOnAdClickedEvent;    bannerAd.OnAdCollapsed += BannerOnAdCollapsedEvent;    bannerAd.OnAdLeftApplication += BannerOnAdLeftApplicationEvent;    bannerAd.OnAdExpanded += BannerOnAdExpandedEvent;  }  public void LoadBannerAd() {    //Load the banner ad     bannerAd.LoadAd();  }  public void ShowBannerAd() {    //Show the banner ad, call this method only if you turned off the auto show when you created this banner instance.    bannerAd.ShowAd();  }  public void HideBannerAd() {    //Hide banner    bannerAd.HideAd();  }  public void DestroyBannerAd() {    //Destroy banner    bannerAd.DestroyAd();  }  //Implement BannerAd Events  public void BannerOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}  public void BannerOnAdLoadFailedEvent(LevelPlayAdError ironSourceError) {}  public void BannerOnAdClickedEvent(LevelPlayAdInfo adInfo) {}  public void BannerOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}  public void BannerOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error){}  public void BannerOnAdCollapsedEvent(LevelPlayAdInfo adInfo) {}  public void BannerOnAdLeftApplicationEvent(LevelPlayAdInfo adInfo) {}  public void BannerOnAdExpandedEvent(LevelPlayAdInfo adInfo) {}}

레벨플레이 Mediation 데모 앱

• Mediation Networks 추가
• 보상형 광고
• 인터스티셜 광고