기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

LevelPlay SDK - Android

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

LevelPlay SDK - Android

Unity LevelPlay
​
​
Android SDK
  • 시작하기
  • 규정 및 설정
  • 광고 형식
    • 보상형 광고
    • 인터스티셜 광고
    • 배너 및 MREC
      • Migrate to banner ad unit API
    • 네이티브 광고
  • Mediation 네트워크
  • 연동 테스트
  1. 게임 성장
  2. Unity 레벨플레이
  3. LevelPlay SDK
  4. Android 개발자를 위한 레벨플레이 SDK

Android용 배너 통합

SDK를 초기화하고 배너 광고 객체를 초기화 후에 생성하고 적절한 광고 크기와 포지션을 설정하여 배너 광고를 통합할 수 있습니다.
읽는 시간 6분
최근 업데이트: 8시간 전

배너는 정적 광고 또는 애니메이션 광고 중 하나일 수 있는 직사각형 시스템 기반 광고로, 라이브 앱 콘텐츠 주위에 지정된 영역 게재됩니다.
참고
이 기술 자료는 SDK 8.9.0 이상에 해당합니다.

필수 조건

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

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

배너 광고 오브젝트의 생성은 onInitSuccess 콜백을 수신한 후에 수행해야 합니다.
// 광고 설정 만들기 - 선택 사항LevelPlayAdSize adSize = LevelPlayAdSize. 배너;LevelPlayBannerAdView.Config adConfig = new LevelPlayBannerAdView.Config.Builder() .setAdSize(adSize) .setPlacementName("placementName") .build();// 배너 뷰를 만들고 광고 유닛 ID를 설정합니다.LevelPlayBannerAdView levelPlayBanner = new LevelPlayBannerAdView(context, "adUnitId", adConfig);
// 광고 설정 만들기 - 선택 사항val adSize = LevelPlayAdSize. 배너val adConfig = LevelPlayBannerAdView.Config.Builder().setAdSize(adSize).setPlacementName("placementName").build()// 배너 뷰를 만들고 광고 유닛 ID를 설정합니다.val levelPlayBanner = LevelPlayBannerAdView(context, "adUnitId", adConfig)

배너 크기

LevelPlayAdSize

설명

dp 단위의 측정 항목(너비 X 높이)

배너표준 배너320 x 50
대규모대형 배너728 x 90
MEDIUM_RECTANGLE중간 직사각형(MREC)300 x 250
적응적모바일 및 태블릿의 크기 및 방향, 방향 설정 조정하기 위해 광고를 자동으로 렌더링합니다.기기 너비 X 권장 높이
광고 크기를 생성하려면 다음 옵션 중 하나를 따르십시오.

화면 너비에 맞게 조정되는 적응적 광고 크기(권장)

이 옵션은 기기 유형에 따라 배너 또는 LEADERBOARD를 반환합니다. 적응적 기능을 지원하는 네트워크(Google, Yandex)는 최적화 로직에 따라 높이를 반환합니다.
LevelPlayAdSize adSize = LevelPlayAdSize.createAdaptiveAdSize(context);
val adSize = createAdaptiveAdSize(context)
특정 배너 크기: 이 옵션을 사용하면 배너 크기를 구체적으로 설정할 수 있습니다. BANNER, LARGE, MEDIUM_RECTANGLE.
levelPlayBanner.setAdSize(LevelPlayAdSize.MEDIUM_RECTANGLE);
levelPlayBanner.setAdSize(LevelPlayAdSize.MEDIUM_RECTANGLE)

Placements

우리는 보고만을 위한 배너에 있는 플레이스먼트를 지원합니다. 모든 재로드된 광고에 영향을 주기 위해 플레이스먼트는 loadAd 이전에 설정해야 합니다.
// 플레이스먼트 이름을 입력합니다.levelPlayBanner.setPlacementName("placementName");
// 플레이스먼트 이름을 입력합니다.levelPlayBanner.setPlacementName("placementName")

배너 리스너 설정

코드에 LevelPlayBannerAdViewListener를 구현하여 광고 전송에 대해 알 수 있습니다.
  • 배너 광고를 로드하기 전에 리스너를 설정하는 것이 좋습니다.
  • 각 배너 광고에는 자체 리스너 구현이 있어야 합니다.
  • 콜백은 메인 스레드 실행됩니다.
  • 콜백이 모든 네트워크에서 지원되지 않는 경우 선택 사항으로 표시됩니다.
levelPlayBanner.setBannerListener(new LevelPlayBannerAdViewListener() {@Overridepublic void onAdLoaded(@NonNull LevelPlayAdInfo adInfo) {// 광고가 성공적으로 로드되었습니다. }@Overridepublic void onAdLoadFailed(@NonNull LevelPlayAdError error) {// 광고 로드 실패}@Overridepublic void onAdDisplayed(@NonNull LevelPlayAdInfo adInfo) {// 광고가 표시되고 화면에 표시되었습니다.}@Override공용 void onAdDisplayFailed(@NonNull LevelPlayAdInfo adInfo, @NonNull LevelPlayAdError 오류) {// 선택 사항 광고가 화면에 표시되지 못함 }@Overridepublic void onAdClicked(@NonNull LevelPlayAdInfo adInfo) {// 광고가 클릭되었습니다.}@Overridepublic void onAdExpanded(@NonNull LevelPlayAdInfo adInfo) {// 선택 사항 광고가 전체 화면으로 열립니다. }@Overridepublic void onAdCollapsed(@NonNull LevelPlayAdInfo adInfo) {// 선택 사항 광고가 원본의, 원래의 크기로 복원됨 }@Overridepublic void onAdLeftApplication(@NonNull LevelPlayAdInfo adInfo) // 선택 사항 사용자 광고를 누르고 앱 밖으로 이동 });
levelPlayBanner.setBannerListener(object: LevelPlayBannerAdViewListener {override fun onAdLoaded(adInfo: LevelPlayAdInfo) {// 광고가 성공적으로 로드되었습니다. }오버라이드 fun onAdLoadFailed(오류: LevelPlayAdError) {// 광고 로드 실패}override fun onAdDisplayed(adInfo: LevelPlayAdInfo) {// 광고가 표시되고 화면에 표시되었습니다.}override fun onAdDisplayFailed(adInfo: LevelPlayAdInfo, error: LevelPlayAdError) {// 선택 사항 광고가 화면에 표시되지 못함 }override fun onAdClicked(adInfo: LevelPlayAdInfo) {// 광고가 클릭되었습니다.}override fun onAdExpanded(adInfo: LevelPlayAdInfo) {// 선택 사항 광고가 전체 화면으로 열립니다.}override fun onAdCollapsed(adInfo: LevelPlayAdInfo) {// 선택 사항 광고가 원본의, 원래의 크기로 복원됨 }override fun onAdLeftApplication(adInfo: LevelPlayAdInfo) {// 선택 사항 사용자 광고를 누르고 앱 밖으로 이동 }})

레벨플레이 광고 정보

LevelPlayAdInfo 파라미터에는 로드된 광고에 대한 정보가 포함되어 있습니다.

배너 광고 로드

배너 광고를 로드하려면 loadAd를 사용하십시오.
// 배너 광고 로드levelPlayBanner.loadAd();
// 배너 광고 로드levelPlayBanner.loadAd()

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

새로고침 값이 플랫폼에서 정의된 경우 코드에서 배너 새로고침을 일시 정지할 수 있습니다. 배너 광고의 자동 새로고침을 중지하거나, 일시 중지한 후 다시 활성화하다, 사용 가능하다.
참고
배너 다시 표시되면 배너가 일시 정지된 시점부터 새로고침까지의 시간을 완료합니다.
  • pauseAutoRefresh - 배너 광고의 자동 새로고침을 일시 중지합니다.
  • resumeAutoRefresh - 배너 광고가 일시 중지된 후 배너 광고의 자동 새로고침을 재개합니다.
// 새로고침 일시 정지levelPlayBanner.pauseAutoRefresh();// 새로고침 재개levelPlayBanner.resumeAutoRefresh();
// 새로고침 일시 정지levelPlayBanner.pauseAutoRefresh()// 새로고침 재개levelPlayBanner.resumeAutoRefresh()

배너 광고 삭제

배너를 파괴하려면 파괴 메서드를 호출합니다.
삭제된 배너 더 이상 표시할 수 없습니다. 더 많은 광고를 표시하려면 새 LevelPlayBannerAdView 오브젝트를 만드십시오.
levelPlayBanner.destroy()
levelPlayBanner.destroy();

배너 광고의 전체 구현 예시

다음은 적응적 배너 크기를 사용하여 배너 광고를 생성하고 로드하는 예제입니다.
public void createAndLoadBanner() {// 광고 설정 만들기 - 선택 사항LevelPlayAdSize adSize = LevelPlayAdSize. 배너;LevelPlayBannerAdView.Config adConfig = new LevelPlayBannerAdView.Config.Builder() .setAdSize(adSize) .setPlacementName("placementName") .build();// Create the banner view and set the ad unit idLevelPlayBannerAdView levelPlayBanner = new LevelPlayBannerAdView(context, "adUnitId", adConfig);// Add the banner view to the containerViewGroup adContainer = findViewById(android.R.id.adContainer);adContainer.addView(levelPlayBanner);levelPlayBanner.setBannerListener(new LevelPlayBannerAdViewListener() { @Override public void onAdLoaded(@NonNull LevelPlayAdInfo adInfo) { // Ad was loaded successfully } @Override public void onAdLoadFailed(@NonNull LevelPlayAdError error) { // Ad load failed } @Override public void onAdDisplayed(@NonNull LevelPlayAdInfo adInfo) { // Ad was displayed and visible on screen } @Override public void onAdDisplayFailed(@NonNull LevelPlayAdInfo adInfo, @NonNull LevelPlayAdError error) { // Ad failed to be displayed on screen } @Override public void onAdClicked(@NonNull LevelPlayAdInfo adInfo) { // Ad was clicked } @Override public void onAdExpanded(@NonNull LevelPlayAdInfo adInfo) { // Ad is opened on full screen } @Override public void onAdCollapsed(@NonNull LevelPlayAdInfo adInfo) { // Ad is restored to its original size } @Override public void onAdLeftApplication(@NonNull LevelPlayAdInfo adInfo) { // User pressed on the ad and was navigated out of the app }});// Load the banner adlevelPlayBanner.loadAd();// To get actual banner layout size (either custom/standard size or adaptive)int height = adSize.getHeight();int width = adSize.getWidth();}
public fun createAndLoadBanner() {// 광고 설정 만들기 - 선택 사항val adSize = LevelPlayAdSize. 배너val adConfig = LevelPlayBannerAdView.Config.Builder().setAdSize(adSize).setPlacementName("placementName").build()// 배너 뷰를 만들고 광고 유닛 ID를 설정합니다.val levelPlayBanner = LevelPlayBannerAdView(context, "adUnitId", adConfig)// Add the banner view to the containerval adContainer = findViewById<ViewGroup>(R.id.adContainer)adContainer.addView(levelPlayBanner)levelPlayBanner.setBannerListener(object: LevelPlayBannerAdViewListener {override fun onAdLoaded(adInfo: LevelPlayAdInfo) { // Ad was loaded successfully }오버라이드 fun onAdLoadFailed(오류: LevelPlayAdError) { // Ad load failed}override fun onAdDisplayed(adInfo: LevelPlayAdInfo) { // Ad was displayed and visible on screen}override fun onAdDisplayFailed(adInfo: LevelPlayAdInfo, error: LevelPlayAdError) { // Ad failed to be displayed on screen}override fun onAdClicked(adInfo: LevelPlayAdInfo) { // Ad was clicked}override fun onAdExpanded(adInfo: LevelPlayAdInfo) { // Ad is opened on full screen}override fun onAdCollapsed(adInfo: LevelPlayAdInfo) { // Ad is restored to its original size}override fun onAdLeftApplication(adInfo: LevelPlayAdInfo) { // User pressed on the ad and was navigated out of the app }})// Load the banner adlevelPlayBanner.loadAd()// Get width and height for the containerval width = adSize.getWidth()val height = adSize.getHeight()}

레벨플레이 Mediation 데모 앱

통합 데모 애플리케이션 앱에 배너 배너 유닛 API를 통합하는 방법을 보여 줍니다.
Android 데모 애플리케이션 다운로드
통합 테스트 제품군과의 통합 여부 확인

다음 단계

배너 광고 네트워크를 추가로 연동하거나 추가 광고 형식을 설정 Unity 통합 가이드를 따르십시오.
  • Mediation Networks 추가
  • 보상형 광고
  • 인터스티셜 광고
  • 네이티브 광고

Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지
    • 필수 조건

    • 배너 광고 오브젝트 생성 및 크기 설정

      • 배너 크기

      • 화면 너비에 맞게 조정되는 적응적 광고 크기(권장)

      • Placements

    • 배너 리스너 설정

      • 레벨플레이 광고 정보

    • 배너 광고 로드

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

    • 배너 광고 삭제

    • 배너 광고의 전체 구현 예시

    • 레벨플레이 Mediation 데모 앱

    • 다음 단계


이 페이지의 문제 보고