기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

LevelPlay SDK - Unity

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

LevelPlay SDK - Unity

Unity LevelPlay
​
​
Unity SDK
  • 시작하기
    • Unity 시작하기
    • Unity 패키지 통합
      • Migrate to 9.0.0+
      • Migrate to LevelPlay Init API
      • Maven Central migration guide
      • Migrate from Unity Ads to LevelPlay
    • Unity 개발자 도구
    • Unity용 광고 품질 SDK 통합
    • 커스텀 어댑터
    • 레벨플레이 SDK 변경 기록 기록
  • 규정 및 설정
  • 광고 형식
  • Mediation 네트워크
  • 연동 테스트
  1. 게임 성장
  3. Unity 레벨플레이
  5. LevelPlay SDK
  7. Unity 개발자를 위한 레벨플레이 SDK

Unity 패키지 통합

레벨플레이 Unity 플러그인 다운로드 프로젝트에 통합하여 광고 Mediation 및 수익화 기능을 활성화하다, 사용 가능하다.
읽는 시간 5분
최근 업데이트: 6시간 전
참고
레벨플레이 Unity 패키지는 Unity 에디터 지원 및 LTS 버전 및 Android 운영 체제 버전 4.4(API 레벨 19)+을 지원합니다. iOS 버전 지원은 네트워크별로 정의됩니다. 레벨플레이 Mediation iOS 버전 13 이상, Xcode 버전 16 이상을 지원합니다.
팁
AI 지원 통합(베타): Claude Code 및 기타 AI 코딩 에이전트를 위한 레벨플레이 Unity 통합 기술은 레벨플레이 설정에 대한 단계별 지침을 제공합니다. 시작하려면 Unity 기술 저장소에서 설치하고 에이전트에서 활성화합니다. 이 기술은 현재 베타 단계에 있으며, 귀하의 피드백에 따라 형성됩니다. 설문 조사를 통해 귀하의 의견을 알려 주십시오.

1단계. Unity 프로젝트 레벨플레이 추가하기

참고
레벨플레이 Unity 패키지의 이전 버전에서 버전 9.0.0 이상으로 업그레이드하려는 경우 이 가이드를 대신 따르십시오.
다음과 같이 레벨플레이 패키지를 설치할 수 있습니다.
  • 권장: Unity Window > 패키지 관리자 이동하여 프로젝트에 Ads Mediation 패키지를 추가합니다. 검색 “Ads Mediation” 및 설치 단추를 선택합니다. 이름으로 패키지를 추가할 수도 있습니다. 
    com.unity.services.levelplay
  • 또는 Unity 플러그인 버전 9.5.0(.unitypackage)을 다운로드하여 Unity 프로젝트로 임포트합니다.
빌트인 샘플이 설치되면 레벨플레이 연동을 살펴보고 실험할 수 있습니다. 패키지 관리자의 패키지 세부 정보 뷰에서 샘플로 이동하고 레벨플레이 샘플을 임포트하고 탐색을 시작합니다.

2단계. SDK 초기화

아직 하지 않았다면 레벨플레이 플랫폼으로 이동하여 새 앱을 생성하세요. 완료되면 앱 키를 사용하여 SDK를 초기화합니다.
  1. 네임스페이스 임포트: C# 스크립트 상단에 네임스페이스를 포함합니다. 
    using Unity.Services.LevelPlay;
  2. SDK 초기화: Start() 메서드 내에서 이벤트 리스너를 등록하고 SDK를 초기화합니다.
public void Start() {    // Register OnInitFailed and OnInitSuccess listeners    LevelPlay.OnInitSuccess += SdkInitializationCompletedEvent;    LevelPlay.OnInitFailed += SdkInitializationFailedEvent;    // SDK init    LevelPlay.Init("ThisIsYourAppKey");}
레벨플레이 초기화하기 전에 OnInitFailed 및 OnInitSuccess를 등록해야 중요. 이는 중요 인사이트를 제공하기 때문입니다.
OnInitSuccess – 레벨플레이가 성공적으로 초기화되면 트리거됩니다. 이 콜백 수신하면 앱에 광고를 표시할 수 있습니다.
OnInitFailed – 레벨플레이 초기화에 실패하여 광고가 표시되지 않을 때 트리거됩니다. 나중에 레벨플레이 초기화하는 것이 좋습니다(인터넷 연결이 가능하거나 오류 원인이 해결된 경우).

UserID 설정

레벨플레이 초기화할 때 사용자 ID를 전달 수 있습니다. 광고 품질의 사용자 여행을 사용하거나 사용자에게 보상을 제공하기 위해 서버 간 콜백을 사용하는 경우에 유용합니다.
LevelPlay.Init("ThisIsYourAppKey", "UserId");

3단계. 레벨플레이 네트워크 관리자

레벨플레이 네트워크 관리자 창은 레벨플레이 모든 요소를 한 번에 확인할 수 있는 곳입니다. Unity 상단 내비게이션 바의 Ads Mediation에서 찾을 수 있습니다. 여기에서 다음을 수행할 수 있습니다.
  • 레벨플레이 SDK를 업데이트합니다.
  • 선호하는 광고 네트워크를 설치하고 업데이트합니다. 설치가 완료되면 각 광고 네트워크를 별도로 설정 합니다. 자세히 알아보기
  • 앱의 Info.plist를 설치한 광고 네트워크에 따라 SKAdNetwork ID로 자동으로 업데이트합니다.
Unity의 레벨플레이 네트워크 관리자입니다.
레벨플레이 Unity 패키지 8.8.1부터 Unity Ads 어댑터는 기본적으로 Ironsource Ads와 함께 설치됩니다. Unity Ads 계정 설정에 대한 자세한 내용은 Unity Ads 통합 가이드를 참조하십시오.

Android

변경 사항을 적용하고 관련 광고 네트워크 아티팩트를 다운로드 Resolver를 사용해야 합니다. 시트를 할당하려면 다음 경로로 이동합니다. Assets > Mobile Dependency Manager > Android Resolver > Resolve로 이동합니다.
레벨플레이 네트워크 관리자 변경될 때마다 이를 수행해야 합니다.
Gradle 사용하는 경우 프로젝트에 네트워크 아티팩트를 다운로드하지 않아도 됩니다. 대신, 아티팩트는 컴파일 중에 Gradle 파일에 추가됩니다.
참고
Unity 패키지 8.10.0 이상을 사용하여 모바일 종속성 해결기를 임포트한 경우 이 작업은 자동으로 수행됩니다.
이 프로세스를 활성화하다, 사용 가능하다 하려면 다음 단계를 따르십시오.
  1. 시트를 할당하려면 다음 경로로 이동합니다. 편집 > 프로젝트 설정 > 플레이어 > Android > 퍼블리싱 설정
  2. 커스텀 메인 Gradle 템플릿 활성화하다, 사용 가능하다
  3. 시트를 할당하려면 다음 경로로 이동합니다. Assets > Mobile Dependency Manager > Android Resolver > Resolve로 이동합니다.
  4. 선택 “Patch mainTemplate. Gradle”
  5. 'OK'를 눌러 변경 사항을 저장합니다.

4단계. 추가 설정

iOS

SKAdNetwork 지원

참고
Unity 패키지 9.1.0 이상의 새 버전을 설치한 경우 레벨플레이 자동으로 이를 관리합니다. 버전 8.8.1-9.0.1에서는 3단계에 설명된 대로 이 기능을 네트워크 관리자 활성화된, 사용 가능한 수 있습니다. 버전 8.10.0 이하에서는 Ads Mediation > Developer Settings > 레벨플레이 Mediation Settings에서 레벨플레이 SDK SKAN ID 자동화를 활성화하다, 사용 가능하다 합니다.
SKAdNetwork ID 자동화를 비활성화한 경우, SDK 7 이상을 사용하는 동안 광고 표시를 활성화하다, 사용 가능하다 앱 프로퍼티 목록 파일(Info.plist)에 설치된 각 네트워크의 SKAdNetwork ID를 수동으로 포함해야 합니다.
<key>SKAdNetworkItems</key><array>  <dict>    <key>SKAdNetworkIdentifier</key>    <string>su67r6k2v3.skadnetwork</string>  </dict></array>

앱 전송 보안 설정

  • 'NSAppTransportSecurity' 딕셔너리에 를 추가합니다. 'Top Level Key'에 이 딕셔너리를 추가해야 합니다.
  • 이 딕셔너리 안에 'NSAllowsArbitraryLoads'라는 부울을 추가하고 YES로 설정합니다.
  • 이로 인해 충돌 발생할 수 있으므로 info.plist에 'NSAllowsArbitraryLoads' 외에 다른 예외가 포함되어 있지 않습니다.
  • ATS에 대한 자세한 내용은 여기를 참조하십시오.
중요
Apple의 개인정보 보호 요구 사항을 준수하려면 SKAdNetwork 어트리뷰션(Unity 패키지 9.1.0부터 자동으로 관리됨)과 iOS 개인정보 보호 매니페스트 구현해야 합니다. 레벨플레이는 둘 다 지원하며 자세히 알아볼 수 있습니다. 여기.
중요
앱과 관련된 개인정보 보호 방법을 구현해야 합니다. 자세히 알아보기 여기.

Android

Android 13 이상(API 레벨 33 이상)을 사용하는 앱 매니페스트 파일에 Google Play 서비스의 노멀 권한 다음과 같이 선언해야 합니다.
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
Google Advertising ID 변경에 대한 자세한 내용은 여기에서 확인하십시오.

5단계 연동 확인

레벨플레이 패키지는 통합 테스트 제품군으로 통합이 성공적으로 완료되었는지 확인하는 간편한 방법을 제공합니다. 앱의 연동을 테스트하고, 플랫폼 설정을 검증하고, 설정된 네트워크와 관련된 광고를 검토합니다.
앱에서 테스트 제품군을 활성화하다, 사용 가능하다 SDK를 초기화하기 전에 다음을 호출.
LevelPlay.SetMetaData("is_test_suite", "enable");
레벨플레이 성공적으로 초기화한 후 다음을 호출하여 테스트 제품군을 실행.
LevelPlay.LaunchTestSuite();
레벨플레이 통합 테스트 제품군의 구현 예와 자세한 내용은 이 문서를 참조하십시오.

다음 단계

이제 레벨플레이 완전히 설정되어 준비되었습니다. 광고 형식을 구현하려면 연동 가이드를 따르십시오.
  • 보상형 광고
  • 인터스티셜 광고
  • Banner
Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

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

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

  • 보고 있는 페이지

    • 1단계. Unity 프로젝트 레벨플레이 추가하기

    • 2단계. SDK 초기화

      • UserID 설정

    • 3단계. 레벨플레이 네트워크 관리자

      • Android

    • 4단계. 추가 설정

      • iOS

      • SKAdNetwork 지원

      • 앱 전송 보안 설정

      • Android

    • 5단계 연동 확인

    • 다음 단계

이 페이지의 문제 보고