기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

레벨플레이 SDK - React Native

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

레벨플레이 SDK - React Native

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

React Native의 배너 통합

설정, 초기화 및 리스너 설정 등 레벨플레이 SDK를 사용하여 React Native 앱에 배너 광고를 구현합니다.
읽는 시간 4분
최근 업데이트: 9시간 전

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

필수 조건

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

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

배너 광고 오브젝트의 생성은 onInitSuccess 콜백을 수신한 후에 수행해야 합니다.
import { LevelPlayBannerAdView, LevelPlayAdSize, type LevelPlayBannerAdViewMethods, type LevelPlayBannerAdViewListener,} from 'Mediationconst bannerAdViewRef = useRef<LevelPlayBannerAdViewMethods>(null);const adSize = LevelPlayAdSize.BANNER; // or await LevelPlayAdSize.createAdaptiveAdSize() for adaptiveconst listener = { /* LevelPlayBannerAdViewListener */ };const loadAd = useCallback(() => { bannerAdViewRef.current?.loadAd();}, []);return ( <LevelPlayBannerAdView ref={bannerAdViewRef} adUnitId="YOUR_AD_UNIT_ID" adSize={adSize} placementName="YOUR_PLACEMENT" listener={listener} style={{ width: adSize.width, height: adSize.height }} />);

배너 크기

LevelPlayAdSize

설명

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

배너표준 배너320 x 50
대규모대형 배너320 x 90
MEDIUM_RECTANGLE중간 직사각형(MREC)300 x 250
적응적모바일 및 태블릿의 크기 및 방향, 방향 설정 조정하기 위해 광고를 자동으로 렌더링합니다.기기 너비 X 권장 높이
광고 크기를 생성하려면 다음 옵션 중 하나를 따르십시오.
화면 너비에 맞게 조정되는 적응적 광고 크기(권장): 이 옵션은 기기 유형에 따라 배너 또는 LEADERBOARD를 반환하므로 "SMART" 통합을 대체합니다. 적응적 기능을 지원하는 네트워크(Google, Yandex)는 최적화 로직에 따라 높이를 반환합니다.
let adSize = await LevelPlayAdSize.createAdaptiveAdSize();
고정 너비 광고 크기를 사용한 적응적 광고 크기: 이 옵션을 사용하면 특정 너비를 설정할 수 있습니다. 적응적 배너 기능을 지원하는 네트워크(Google, Yandex)는 제공된 너비를 기반으로 최적화 로직을 기반으로 높이를 반환합니다. 다른 모든 네트워크는 제공된 너비에 따라 폴백 크기(배너 또는 리더보드)를 반환합니다.
let adSize = await LevelPlayAdSize.createAdaptiveAdSize(400);
특정 배너 크기: 이 옵션을 사용하면 배너 크기를 구체적으로 설정할 수 있습니다. 배너, 대형, 중형.
let adSize = LevelPlayAdSize.MEDIUM_RECTANGLE;

Placements

우리는 보고만을 위한 배너에 있는 플레이스먼트를 지원합니다. 모든 재로드된 광고에 영향을 주기 위해 플레이스먼트는 loadAd 이전에 설정해야 합니다.

배너 리스너 설정

코드에 LevelPlayBannerAdViewListener를 구현하여 광고 전송에 대해 알 수 있습니다.
  • 배너 광고를 로드하기 전에 리스너를 설정하는 것이 좋습니다.
  • 각 배너 광고에는 자체 리스너 구현이 있어야 합니다.
  • 콜백은 메인 스레드 실행됩니다.
const 리스너: LevelPlayBannerAdViewListener = { onAdLoaded: (adInfo: LevelPlayAdInfo) => { // Invoked each time a banner was loaded. 새로 고침 또는 매뉴얼 로드. }, onAdLoadFailed: (error: LevelPlayAdError) => { // Invoked when the banner loading process has failed. // This callback will be sent both for manual load and refreshed banner failures. }, onAdDisplayed: (adInfo: LevelPlayAdInfo) => { // Notifies the screen is displayed. }, onAdDisplayFailed: (adInfo: LevelPlayAdInfo, error: LevelPlayAdError) => { // Notifies the screen failed to display. }, onAdClicked: (adInfo: LevelPlayAdInfo) => { // Invoked when end user clicks on the banner ad. }, onAdExpanded: (adInfo: LevelPlayAdInfo) => { // Ad is opened on full screen }, onAdCollapsed: (adInfo: LevelPlayAdInfo) => { // Ad is restored to its original size }, onAdLeftApplication: (adInfo: LevelPlayAdInfo) => { // Invoked when the user left the app. },};

배너 광고 로드

배너 광고를 로드하려면 loadAd를 사용하십시오.
// Load the banner adbannerAdViewRef.current?.loadAd();

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

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

배너 광고 삭제

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

배너 광고의 전체 구현 예시

다음은 표준 배너 크기를 사용하여 배너 광고를 생성하고 로드하는 예제입니다.
import { LevelPlayBannerAdView, LevelPlayAdSize, type LevelPlayBannerAdViewMethods, type LevelPlayBannerAdViewListener, type LevelPlayAdInfo, type LevelPlayAdError,} from 'Mediation// Start of some component ...const bannerAdViewRef = useRef<LevelPlayBannerAdViewMethods>(null);const adSize = LevelPlayAdSize.BANNERconst 리스너: LevelPlayBannerAdViewListener = { onAdLoaded: (adInfo: LevelPlayAdInfo) => { // Implement your logic here }, onAdLoadFailed: (error: LevelPlayAdError) => { // Implement your logic here }, onAdDisplayed: (adInfo: LevelPlayAdInfo) => { // Implement your logic here }, onAdDisplayFailed: (adInfo: LevelPlayAdInfo, error: LevelPlayAdError) => { // Implement your logic here }, onAdClicked: (adInfo: LevelPlayAdInfo) => { // Implement your logic here }, onAdExpanded: (adInfo: LevelPlayAdInfo) => { // Implement your logic here }, onAdCollapsed: (adInfo: LevelPlayAdInfo) => { // Implement your logic here }, onAdLeftApplication: (adInfo: LevelPlayAdInfo) => { // Implement your logic here },};return ( <LevelPlayBannerAdView ref={bannerAdViewRef} adUnitId={'YOUR_AD_UNIT_ID'} adSize={adSize} placementName={'YOUR_PLACEMENT'} listener={listener} onLayout={(_) => bannerAdViewRef.current?.loadAd()} style={width: adSize.width, height: adSize.height}} // 실제 배너 레이아웃 크기를 가져옵니다. />); // End of component ...

레벨플레이 Mediation 데모 앱

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

다음 단계

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

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

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

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

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

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

      • 배너 크기

      • Placements

    • 배너 리스너 설정

    • 배너 광고 로드

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

    • 배너 광고 삭제

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

    • 레벨플레이 Mediation 데모 앱

    • 다음 단계


이 페이지의 문제 보고