기술 자료

​
​

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
  • 시작하기
  • 규정 및 설정
    • 규정 고급 설정
    • React의 고급 설정
    • iOS 개인정보 보호 설정 및 설정
    • Apple 앱 개인정보 보호 설문지
    • React Native의 노출 수준 매출 통합
    • AdInfo 통합이 포함된 레벨플레이 리스너
  • 광고 형식
  • Mediation 네트워크
  • 연동 테스트
  1. 게임 성장
  2. Unity 레벨플레이
  3. LevelPlay SDK
  4. React Native 개발자를 위한 레벨플레이 SDK

React의 고급 설정

사용자 세그먼트, 커스텀텀 파라미터, 단가 등 React에 대한 고급 설정을 설정 광고 게재와 수익화 최적화합니다.
읽는 시간 7분
최근 업데이트: 8시간 전

세그먼트 정의

이제 특정 잠재 고객에게 맞게 광고를 게재하는 방법을 쉽게 커스터마이즈할 수 있습니다. 사용자 속한 세그먼트 따라 광고를 게재할 수 있도록 SDK에 사용자 세부 정보를 서버에 알려야 합니다.
레벨플레이 다음 세 가지 메서드를 지원하여 사용자 세그먼트 설명하기 위해 서버로 데이터를 전달합니다.
  • 기기 프로퍼티: 레벨플레이 SDK는 위치, 기기 모델, 기기 제조사, 앱 버전, OS 등 사용자의 기기에 관련된 특정 표준 파라미터를 자동으로 수집합니다. 이 데이터를 전달할 필요는 없습니다.
  • 사용자 프로퍼티: 생성 날짜와 같은 포괄적인 사용자 데이터(지원되는 세그먼트 프로퍼티의 전체 목록과 설명은 아래 참조)는 API를 통해 전달되어야 합니다. 지침에 따라 SDK가 레벨플레이 플랫폼에서 정의한 세그먼트에 따라 다양한 사용자를 분류할 수 있도록 사용자 세부 정보를 전송합니다.
  • 커스텀 세그먼트: 사용자 세부 정보를 서버로 전달하지 않고 커스텀 세그먼트를 만들고 해당 사용자 세그먼트에 맞춤형 광고 설정을 지정할 수 있습니다.
참고
레벨플레이 SDK 7.2.0 이상을 사용하는 경우 LevelPlaySegment API 사용하여 세션 중에 세분화를 변경할 수 있습니다. 이는 다음 로드된 광고에 영향을 미치며 각 광고 유닛을 로드하기 전에 호출되어 워터폴에 동적으로 영향을 미칠 수 있습니다. 레벨플레이 세분화에 대해 자세히 알아볼 수 있습니다. 여기.

사용자 프로퍼티 전달

레벨플레이 플랫폼에서 세그먼트를 정의했으면 서버에 사용자 세부 정보를 알려야 합니다.
Unity 레벨플레이 Mediation 패키지에서 다음을 임포트.
import { LevelPlaySegment, 레벨플레이} from 'Mediation
세그먼트를 지지대 어떤 프로퍼티를 서버에 보낼지 정의합니다. 다음 방법 중 하나를 통해 이 정보를 전송할 수 있습니다.
  1. 사용자 속한 세그먼트 익숙하다면 세그먼트 이름을 다음과 같이 설정하십시오.
    const segment = { segmentName: 'YOUR_SEGMENT_NAME' };LevelPlay.setSegment(segment);
  2. 사용자 세부 정보를 보내주십시오. 레벨플레이 SDK는 API 세그먼트 사용자 속성 위해 설정할 수 있는 다양한 표준 사용자 프로퍼티를 제공합니다. 지원되는 세그먼트 속성은 아래 표를 참조하십시오.
    const 세그먼트: LevelPlaySegment = { level: levelParam, // Int isPaying: isPayingParam, userCreationDate: dateTimeParam, // Long, milliseconds iapTotal: iapTotalParam, // Double customParameters: { customKey1: 'customValue1', customKey2: 'customValue2', customKey3: 'customValue3', customKey4: 'customValue4', customKey5: 'customValue5', },};LevelPlay.setSegment(segment);

지원되는 세그먼트 프로퍼티

세그먼트 속성

Type

제한

설명

segmentName문자열- 영숫자 - 최대 32자레벨플레이 계정에 있는 세그먼트 특정 이름입니다.
지급부울예 또는 아니요- 사용자 인앱 구매에 비용을 지출한 경우 true, 사용자 인앱 구매에 비용을 지출하지 않은 경우 false
iap_total더블1-999999.99사용자 인앱 구매에 지출한 총 금액입니다.
userCreationDate길이0보다 작을 수 없음사용자 앱을 설치한 날짜(밀리초)입니다.
커스텀 파라미터key=string, value=string- 레벨플레이 최대 5개의 커스텀 파라미터 - 영숫자 - 최대 32개의 문자 지원서버에 디스패치 추가 데이터

보상형 광고 서버 간 콜백의 커스텀 파라미터

레벨플레이 보상형 광고 유닛은 서버 측 이벤트를 지원하여 성공적인 광고 완료 이벤트 후 사용자에게 제공해야 하는 보상을 알려줍니다. 자세히 알아보기 여기.
서버 파라미터 외에도 클라이언트 통해 런타임 커스텀 파라미터를 공유할 수 있습니다. 이를 구현하려면 setMetaData API를 사용하여 커스텀 파라미터를
LevelPlay_Rewarded_Server_Params
에 전달합니다. 커스텀 파라미터는 세션 동안 여러 번 업데이트하여 이전 값을 오버라이드할 수 있습니다.
커스텀 파라미터를 재설정하려면
LevelPlay_Rewarded_Server_Params
를 빈 배열로 설정합니다.

구현 규칙

LevelPlay.setMetaData('LevelPlay_Rewarded_Server_Params', ['key1=value1', 'key2=value2'])
그러면 쿼리 문자열에 커스텀 키와 값이 포함된 해당 콜백 수신됩니다.
예:
http://www.mydomain.com/rewardsCallback?appUserId=[사용자_ID]&rewards=[리워드]&eventId=[이벤트_ID]&itemName=[ITEM_NAME]& 커스텀_key1=value1& 커스텀_key2=value2
참고
Min LevelPlay SDK 8.11.0. 최대 2,048자 허용.

가격 한도 설정

Floor 설정 API 사용하면 특정 광고 유닛의 단가를 설정할 수 있습니다. 사용자 가격 한도를 설정하면 타게팅 효율성을 높이고 지연 줄이고 광고 성과를 최적화할 수 있습니다. 광고 오브젝트 생성할 때 단가를 할당해야 하며, 해당 오브젝트 모든 후속 로드에 적용됩니다.
참고: 이 기능의 최소 SDK 버전은 8.9.0입니다.

프로퍼티

Type

설명

단가double기존 인스턴스와 입찰자에 적용되는 최소 eCPM을 정의하는 USD 기준 가격입니다.

인터스티셜 광고 예시

'Mediation}를 임포트.// Create an interstitial ad and set the price floor in USDconst interstitialAd = new LevelPlayInterstitialAd('adUnitId')interstitialAd.setBidFloor(1.23)
완전한 인터스티셜 광고 구현 여기

보상형 광고 예시

'Mediation포트.// Create a rewarded ad and set the price floor in USDconst rewardedAd = new LevelPlayRewardedAd('adUnitId')rewardedAd.setBidFloor(1.23)
전체 보상형 광고 구현은 여기에서 사용할 수 있습니다.

배너 광고 예시

가격 한도(USD)를 설정하기 위한 프랍로
bidFloor
전달:
'MediationevelPlayAdSize }를 임포트.// Render a banner with a price floor of 1.23 USD<LevelPlayBannerAdView adUnitId="adUnitId" adSize={LevelPlayAdSize.BANNER} placementName={null} bidFloor={1.23}/>
전체 배너 구현은 여기에서 사용할 수 있습니다.

레벨플레이 SDK 오류 코드

레벨플레이 SDK 연동의 실패에 대한 설명을 제공하는 오류 피드백 메커니즘을 제공합니다. 무언가 잘못되었거나 연동의 한 부분이 올바르게 완료되지 않은 경우 이러한 오류가 표시됩니다.
레벨플레이 오류 오브젝트에는 오류 코드와 메시지가 있습니다. 다음은 가능한 모든 오류와 함수에 따라 해당 메시지.
플레이스먼트가 제한되어 있기 때문에
배너를 로드하는 동안의

오류 코드

광고 단위

설명

508해당 없음
  • Mediation/네트워크의 초기 실패
  • Demand Only 모드가 아닌 API 호출
  • Demand Only 모드에서 비요청 전용 API 호출
509인터스티셜 광고, 보상형 동영상Show Fail: 표시할 광고가 없습니다
510인터스티셜 광고, 보상형 비디오, 배너로드 실패: 서버 응답 실패
520인터스티셜 광고, 보상형 동영상
Show Fail: 인터넷 연결 없음. ShouldTrackNetworkState가 활성화되어 있고, 사용 가능한 Show Fail: 인터넷 연결 없음
524인터스티셜 광고, 보상형 동영상
Show Fail: %@ 플레이스먼트가 속도별로 정의된 한도에 도달했습니다. Show Fail: 플레이스먼트 %@가 한도에 도달했습니다.
526인터스티셜 광고, 보상형 동영상Show Fail: 광고 유닛이 세션당 일일 한도에 도달했습니다
604 Banner로드할 수 없습니다
605 배너예기치 않은 예외
606Banner첫 번째 로드 시 모든 네트워크에 배너 채우지 않음
1007인터스티셜 광고, 보상형 동영상경매 실패: 경매 요청에 필요한 모든 정보가 포함되지 않았습니다
1022보상형 비디오Show Fail: 다른 RV가 표시되는 동안 RV를 표시할 수 없습니다
1023보상형 비디오Show Fail: 표시할 수 있는 광고가 없을 때 호출되는 RV 표시
1035인터스티셜 광고빈 폭포
1036인터스티셜 광고Show Fail: 다른 인터스티셜 광고가 표시되는 동안 인터스티셜 광고를 표시할 수 없습니다
1037인터스티셜 광고로드 실패: 다른 인터스티셜 광고가 표시되는 동안 인터스티셜 광고를 로드할 수 없습니다
1039인터스티셜 광고호출하는 동안 인터스티셜 광고

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

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

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

  • 보고 있는 페이지
    • 세그먼트 정의

      • 사용자 프로퍼티 전달

      • 지원되는 세그먼트 프로퍼티

    • 보상형 광고 서버 간 콜백의 커스텀 파라미터

      • 구현 규칙

    • 가격 한도 설정

      • 인터스티셜 광고 예시

      • 보상형 광고 예시

      • 배너 광고 예시

    • 레벨플레이 SDK 오류 코드


이 페이지의 문제 보고