유니티 플러그인 연동

1단계. 레벨플레이 유니티 패키지를 프로젝트에 추가하기

두 가지 방법 중 하나를 통해 레벨플레이 패키지를 설치할 수 있습니다:

• [Recommended] 유니티 에디터에서 Window -> Package Manager 메뉴로 이동한 후, Ads Mediation 패키지를 프로젝트에 추가합니다. “Ads Mediation”을 검색하여 찾은 후 설치 버튼을 클릭합니다.

• • • 패키지 네임으로도 해당 패키지를 검색하실 수 있습니다: com.unity.services.levelplay

설치가 완료되면, 기본 탑재된 샘플 코드를 참고 및 활용하여 레벨플레이를 연동합니다. 패키지 매니저의 패키지 세부정보 뷰를 통해 Samples로 이동하여, 레벨플레이 샘플 코드를 불러오고 이 코드로 이것 저것 시험해 보세요!

2단계. 아이언소스 SDK 초기화 하기

플러그인 및 광고 유닛을 초기화하기

레벨플레이 플랫폼에서 아직 새 앱을 생성하지 않았다면, 해당 플랫폼으로 이동해서 바로 새 앱을 생성합니다. 해당 작업이 완료되었으면, 할당받은 앱 키를 사용해 SDK를 초기화합니다:
아래의 단계를 따라 아이언소스 SDK를 초기화합니다:

using com.unity3d.mediation;

LevelPlay.OnInitSuccess += SdkInitializationCompletedEvent;
LevelPlay.OnInitFailed += SdkInitializationFailedEvent;
LevelPlay.Init(appKey,legacyAdFormats, "UserId");

초기화 관련 중요 정보를 문제없이 수신하려면, 반드시 레벨플레이 초기화 이전에 OnInitFailed 및 OnInitSuccess 콜백을 등록해야 합니다:
OnInitSuccess – 초기화가 성공적으로 완료되었을 때 호출됩니다. 해당 이벤트 콜백을 수신한 후에 광고 객체 생성 및 광고 로드를 할 수 있습니다.
OnInitFailed – 서버로부터 초기화 응답으로 전달되는 SDK 및 앱 설정 취득에 실패하여 광고 로드가 불가능합니다. 초기화에 실패했다면, 이후 인터넷 연결 상태가 양호하고 초기화 실패 이유가 해결된 상태에서 다시 초기화를 시도하시는 것이 좋습니다.

3단계. 레벨플레이 네트워크 매니저

레벨플레이 네트워크 매니저 창은 레벨플레이에 관련된 모든 것을 한 번에 처리할 수 있는 창입니다. 유니티 에디터의 최상단 네비게이션 바에서, Ads Mediation 메뉴에서 선택해 진입할 수 있습니다. 여기에서 사용 가능한 기능은 아래와 같습니다:

• 레벨플레이 SDK 업데이트합니다.
• 사용할 광고 네트워크 관련 소프트웨어 (광고 네트워크 SDK 및 해당 SDK용 어댑터)를 설치 및 업데이트합니다. 설치가 끝나면 각 광고 네트워크 별로 구성 설정이 필요합니다. 자세한 사항은 여기를 참고하세요.
• iOS 용 앱을 빌드하는 경우, 앱의 Info.plist에 설치된 광고 네트워크에 따라 각 네트워크의 SKAdNetwork ID가 자동으로 업데이트 됩니다.

레벨플레이 유니티 패키지 8.8.1부터, 기존에 설치되던 ironSource Ads 어댑터와 더불어 Unity Ads 어댑터는 기본으로 자동 설치됩니다. Unity Ads 계정 설정에 대한 더 자세한 정보는, Unity Ads 연동 가이드를 확인하세요.

안드로이드

안드로이드 빌드 구성에 변경 사항을 적용하고, 필요한 각 광고 네트워크 관련 소프트웨어를 다운로드하려면, resolver를 사용해야 합니다.
Assets → Mobile Dependency Manager → Android Resolver → Resolve로 이동합니다.

레벨플레이 네트워크 매니저에서 변경사항이 있을 경우에는 바로 다음에 이 작업을 수행해야 합니다.

Custom Gradle을 사용하는 경우, resolver에서 프로젝트에 각 광고 네트워크 관련 소프트웨어를 다운로드 하지 않고 대신 Gradle 파일을 통해 구성하여 컴파일 시 참조하도록 할 수 있습니다. 

이 방법을 적용하려면, 아래의 단계를 따라 구성합니다: 

1. Project Settings → Player → Android → Publishing Settings로 이동합니다.
2. Custom Main Gradle Template 옵션을 활성화 합니다.
3. Assets → Mobile Dependency Manager → Android Resolver → Settings로 이동합니다.
4. “Patch mainTemplate.gradle”를 선택합니다.
5. OK 버튼을 눌러 변경사항을 저장합니다.

4단계. 추가 설정

iOS

SKAdNetwork 지원

iOS에서 레벨플레이 SDK 7 이상을 사용하고 아이언소스 네트워크 광고 표시를 활성화하려면, 반드시 앱의 프로퍼티 목록 파일 (Info.plist)에 아이언소스 광고 네트워크의 SKAdNetwork ID가 포함되어 있어야 합니다.

1. XCode의 프로젝트 탐색기에서 Info.plist 파일을 선택합니다.
2. 프로퍼티 목록 에디터에서 목록 내 아이템 옆에 있는 Add button (+)을 클릭하고 Return키를 누릅니다.
3. 키 명칭에 SKAdNetworkItems를 입력합니다.
4. Type 열에 있는 팝업 메뉴에서 Array를 선택합니다.
5. Dictionary 항목을 생성하고, 그 아래에 string 항목을 하나 생성합니다.
6. String 항목의 키 명칭을 SKAdNetworkIdentifier로 입력하고, 아래 키 값을 입력합니다:

   su67r6k2v3.skadnetwork

   아래의 코드를 사용해 Info.plist 파일에 직접 SKAdNetworkIdentifier를 입력할 수도 있습니다.

   <key>SKAdNetworkItems</key>
   <array>
      <dict>
         <key>SKAdNetworkIdentifier</key>
         <string>su67r6k2v3.skadnetwork</string>
      </dict>
   </array>

프로퍼티 항목 편집에 대한 더 자세한 정보는, Xcode 문서를 참고 부탁 드립니다.

App Transport Security 설정 settings

모든 미디에이션 네트워크상에서 아이언소스 광고 게재가 지속적으로 지원되도록 하려면, 반드시 아래와 같이 info.plist 파일을 수정해야 합니다:

• ‘NSAppTransportSecurity‘ 라는 명칭의 키를 Dictionary 타입으로 추가합니다. 반드시 ‘최상위 프로퍼티 키‘로 생성하셔야 합니다.
• 이 dictionary 키 하위에 ‘NSAllowsArbitraryLoads‘ 라는 Boolean 타입 키를 생성하고 값을 YES로 설정합니다.

• 충돌을 유발할 수 있기 때문에, 프로젝트의 Info.plist가 ‘NSAllowsArbitraryLoads‘ 이외의 예외사항을 포함하지 않도록 합니다.
• ATS에 대한 더 자세한 정보는 여기에서 보실 수 있습니다.

안드로이드

안드로이드 13 버전 이상 (API 버전 33+)을 타겟으로 빌드된 앱에서는 아래와 같이 구글 플레이 서비스 일반 권한을 Manifest 파일에 선언해야 합니다:

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

구글 광고 ID 변경사항에 대한 더 자세한 사항은 여기span style=”font-weight: 400;”를 참고하세요.

5단계. 연동을 검증하기

아이언소스 SDK에서 제공하는 레벨플레이 Test Suite을 통해 SDK와 미디에이션 연동이 성공적으로 완료되었는지 간단하게 확인할 수 있습니다. 앱 연동 상태, 플랫폼 설정 정합성 및 구성 미디에이션 광고 네트워크에서 제공된 광고 리뷰 등을 할 수 있습니다.
앱 내에서 Test Suite 기능을 활성화 하려면, SDK 초기화 설정 이전에 setMetaData API를 아래와 같이 호출합니다:

LevelPlay.SetMetaData("is_test_suite", "enable");

LevelPlay.LaunchTestSuite();

레벨플레이 연동 test suite 도구의 구현 예제 및 더 자세한 사항은 이 문서로 이동해서 확인해 주세요..

완료했습니다!
이제 아이언소스 광고 유닛 및 미디에이션 도구 사용을 시작하실 수 있습니다.