기술 자료

​
​

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

Android용 고급 설정

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

세그먼트 정의

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

사용자 프로퍼티 전달

레벨플레이 플랫폼에서 세그먼트를 정의하면 서버에 사용자 세부 정보를 알려야 합니다.
세그먼트를 지지대 어떤 프로퍼티를 서버에 보낼지 정의합니다. 다음 방법 중 하나를 통해 이 정보를 전송할 수 있습니다.
  1. 사용자 속한 세그먼트 익숙하다면 세그먼트 이름을 입력합니다.
mLPSegment.setSegmentName(name);
  1. 사용자 세부 정보를 보내주십시오. 레벨플레이 SDK는 API 세그먼트 사용자 속성 위해 설정할 수 있는 다양한 표준 사용자 프로퍼티를 제공합니다. 아래로 스크롤 사용자 세그먼사용자그먼트
// Create segment objectmLPSegment = new LevelPlaySegment();// Set user's levelmLPSegment.setLevel(level);// Set user creation datemLPSegment.setUserCreationDate(date);// Set user's total in-app purchasesmLPSegment.setIAPTotal(iapt);// Set user's paying statusmLPSegment.setIsPaying(isPaying);
또한 세그먼트 최대 5개의 커스텀 사용자 프로퍼티를 설정할 수 있습니다.
// Set custom parameters (up to 5)mLPSegment.setCustom(key, value);
다음으로, 세그먼트를 기반으로 광고 유닛을 게재하여 사용자 광고 경험 맞춤화하려면 세그먼트 이름 또는 사용자 프로퍼티를 사용하여 다음 함수 호출.
LevelPlay.setSegment(mLPSegment);

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

세그먼트 속성

Type

제한

설명

segmentName문자열영숫자 최대 32자레벨플레이 계정에 있는 세그먼트 특정 이름입니다.
지급부울참 또는 거짓사용자 인앱 구매에 비용을 지출한 경우 true. 사용자 인앱 구매에 비용을 지출하지 않은 경우 false.
iap_total더블1-999999.99사용자 인앱 구매에 지출한 총 금액입니다.
userCreationDate길이0보다 작을 수 없음사용자 앱을 설치한 날짜(밀리초)입니다.
커스텀 파라미터key=string, value=string레벨플레이 SDK는 최대 5개의 커스텀 파라미터 영숫자 최대 32개의 문자를 지원합니다.서버에 디스패치 추가 데이터
다음 콜백 등록하여 사용자 속한 세그먼트 이름을 수신합니다. 콜백 문자열(세그먼트 이름)이 비어 있음을 반환하면 레벨플레이 세그먼트 모듈에서 사용자 대해 상관 관계 있는 세그먼트를 찾을 수 없습니다.
SegmentListener onSegmentReceived(문자열 세그먼트){}

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

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

예제 구현 코드

LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", List.of("key1=value1", "key2=value2"));
LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", listOf("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 사용하면 특정 광고 유닛의 단가를 설정할 수 있습니다. 사용자 가격 한도를 설정하면 타게팅 효율성을 높이고 지연 줄이고 광고 성과를 최적화할 수 있습니다.
광고 오브젝트 생성할 때 단가를 할당해야 하며, 해당 오브젝트 모든 후속 로드에 적용됩니다.
참고: Min SDK 8.9.0

프로퍼티

Type

설명

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

인터스티셜 광고 예시

// Define a price floor configurationvar adConfig = new LevelPlayInterstitialAd.Config.Builder() .setBidFloor(1.23) // USD로 한도 가격을 설정합니다. .build();// Apply the configuration to an interstitial ad unitvar interstitialAd = new LevelPlayInterstitialAd("adUnitId", adConfig);
전체 인터스티셜 광고 구현은 여기에서 사용할 수 있습니다.

보상형 광고 예시

// Define a price floor configurationval adConfig = LevelPlayRewardedAd.Config.Builder() .setBidFloor(1.23) // USD로 한도 가격을 설정합니다. .build()// Apply the configuration to a rewarded ad unitval rewardedAd = LevelPlayRewardedAd("adUnitId", adConfig)
전체 보상형 광고 구현은 여기에서 사용할 수 있습니다.

배너 광고 예시

// Define a price floor configurationvar adConfig = new LevelPlayBannerAd.Config.Builder() .setBidFloor(1.23) // USD로 한도 가격을 설정합니다. .build();// Apply the configuration to a banner ad unitvar bannerAd = new LevelPlayBannerAdView(context, "adUnitId", adConfig);
전체 배너 광고 구현은 여기에서 사용할 수 있습니다.

레벨플레이 SDK 오류 코드

레벨플레이 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 오류 코드


이 페이지의 문제 보고