Unity 배너 통합
SDK를 초기화하고, 초기화 후에 배너 광고 오브젝트를 생성하고, 적절한 광고 크기와 포지션을 설정하여 Unity 배너 광고를 통합할 수 있습니다.
읽는 시간 5분최근 업데이트: 6시간 전
배너는 정적 광고 또는 애니메이션 광고 중 하나일 수 있는 직사각형 시스템 기반 광고로, 라이브 앱 콘텐츠 주위에 지정된 영역 게재됩니다.
참고
이 기술 자료는 SDK 8.4.0 이상(베타 버전 API)에 해당합니다.
필수 조건
- 레벨플레이 SDK를 애플리케이션 올바르게 연동했는지 확인합니다. 통합은 여기 설명되어 있습니다.
- 레벨플레이 초기화 API 사용하여 SDK를 초기화해야 합니다.
- 레벨플레이 대시보드에서 AdUnitID를 찾습니다. 자세히 알아보기 여기.
배너 광고 오브젝트 생성, 크기 및 위치 설정
배너 광고 오브젝트의 생성은 OnInitSuccess 콜백을 수신한 후에 수행해야 합니다.
// Create the banner object and set the ad unit id LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(bannerAdUnitId);
참고: 생성자는 선택적 파라미터도 지원합니다.
LevelPlayBannerAdConfig// Use optional Config parameterLevelPlayBannerAd(string adUnitId, Config config = null)
특별한 설정이 필요하지 않으면 파라미터를 생략하고 만 전달할 수 있습니다. 배너 기본 속성으로 생성됩니다.
ConfigadUnitId속성 | 기본 |
|---|---|
| 크기 | Banner |
| 위치 | BottomCenter |
| displayOnLoad | true |
| respectSafeArea | false(Android만 해당) |
배너 매개 변수를 커스터마이즈하려면 다음과 같이 빌더를 사용하십시오.
Configvar 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);
배너 크기
LevelPlayAdSize | 설명 | dp 단위의 측정 항목(너비 X 높이) |
|---|---|---|
| 배너 | 표준 배너 | 320 x 50 |
| 대규모 | 대형 배너 | 320 x 90 |
| MEDIUM_RECTANGLE | 중간 직사각형(MREC) | 300 x 250 |
| 적응적 | 모바일 및 태블릿의 크기 및 방향, 방향 설정 조정하기 위해 광고를 자동으로 렌더링합니다. | 기기 너비 X 권장 높이 |
광고 크기를 생성하려면 다음 옵션 중 하나를 따르십시오.
화면 너비에 맞게 조정되는 적응적 광고 크기(권장):
이 옵션은 기기 유형에 따라 배너 또는 LEADERBOARD를 반환합니다. 적응적 기능을 지원하는 네트워크(Google, Yandex)는 최적화 로직에 따라 높이를 반환합니다.
- 레벨플레이 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();
특정 배너 크기: 이 옵션을 사용하면 특정 배너 크기를 설정할 수 있습니다. BANNER, LARGE, MEDIUM_RECTANGLE.
LevelPlayAdSize adSize = LevelPlayAdSize.BANNER;
배너 위치
화면에 배너를 표시하기 위한 기본 위치는 BottomCenter입니다. 아래는 지원되는 모든 포지션의 전체 목록입니다.
- TopLeft
- TopCenter
- TopRight
- CenterLeft
- 센터
- CenterRight
- BottomLeft
- BottomCenter
- BottomRight
LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(adUnitId, LevelPlayAdSize.BANNER, LevelPlayBannerPosition.TopLeft);
dp에 정의된 x 및 y 값이 있는 오브젝트를 생성하여 화면의 특정(x, y)좌표에 배너를 배치할 수도 있습니다.
LevelPlayBannerPositionLevelPlayBannerPosition 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");
배너 이벤트 구현
코드에서 이벤트를 듣습니다. SDK는 아래에 나열된 가능한 모든 이벤트를 알립니다.
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배너 광고 로드
배너 광고를 로드하려면 를 사용합니다.
LoadAdbannerAd.LoadAd();
배너 새로고침 일시 정지 및 재개
새로고침 값이 플랫폼에서 정의된 경우 코드에서 배너 새로고침을 일시 정지할 수 있습니다. 배너 광고의 자동 새로고침을 중지하거나, 일시 중지한 후 다시 활성화하다, 사용 가능하다.
참고
배너 다시 표시되면 배너가 일시 정지된 시점부터 새로고침까지의 시간을 완료합니다.
// Pause refreshbannerAd.PauseAutoRefresh();// Resume refreshbannerAd.ResumeAutoRefresh();
bannerAd.HideAd();
배너 숨기기 및 표시
배너 생성자 일부로 배너 배경에 로드하고 관련된 경우에만 화면에 표시할 수 있습니다. 로딩 후 광고 가시성을 제어하기 위해 다음 API를 사용할 수 있습니다.
참고
광고가 숨겨지면 자동 새로고침이 켜져 있는 한 백그라운드에서 계속 새로고침됩니다.
// Show ad bannerAd.ShowAd(); // Hide ad bannerAd.HideAd();
디스플레이 컷아웃(Android만 해당)
Android 디바이스의 디스플레이 컷아웃은 카메라, 센서, 스피커와 같은 필수 컴포넌트를 위해 예약된 지정된 영역, 일반적으로 에지 투 에지 디스플레이가 있는 스마트폰과 디바이스에서 사용됩니다. 컷아웃은 잠재적으로 게임 뷰 제한하여 화면의 배너 배치에 영향을 미칠 수 있습니다. 배너 광고와 표시된 컷아웃의 중복을 방지하려면 를 생성하고 를 true로 설정합니다.
LevelPlayBannerAdrespectSafeArea디스플레이 컷아웃을 위한 Google 솔루션에 대해 자세히 알아보세요. 여기에서
Android 컷아웃을 지원하려면 를 사용하여 배너 오브젝트를 생성하고 respectSafeArea 값을 true로 설정합니다(기본값은 false).
Configvar configBuilder = new LevelPlayBannerAd.Config.Builder();configBuilder.SetRespectSafeArea(true); // Only relevant for Androidvar bannerConfig = configBuilder.Build();bannerAd = new LevelPlayBannerAd(bannerAdUnitId, bannerConfig);
배너 광고 삭제
배너를 파괴하려면 메서드를 호출합니다.
DestroyAd삭제된 배너 더 이상 표시할 수 없습니다. 더 많은 광고를 표시하려면 새 오브젝트를 만드십시오.
LevelPlayBannerAdbannerAd.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 데모 앱
통합 데모 애플리케이션 앱에 배너 배너 유닛 API를 통합하는 방법을 보여 줍니다.
이제 모두 애플리케이션 배너를 제공하도록 설정되었습니다. 통합 테스트 제품군과의 통합 여부 확인
에디터 내에서 통합을 테스트할 수 있습니다. Unity 에디터에서 모형 광고를 미리 보려면 미리보기 모형 광고 가이드를 참조하십시오.
다음은 무엇입니까?
배너 광고 네트워크를 추가로 연동하거나 추가 광고 형식을 설정 Unity 통합 가이드를 따르십시오.