기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

LevelPlay SDK - iOS

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

LevelPlay SDK - iOS

Unity LevelPlay
​
​
iOS SDK
  • 시작하기
    • iOS 시작하기
    • iOS SDK 연동
      • Migrate to LevelPlay Init API
    • Swift와 레벨플레이 SDK 연동
    • 광고 품질 SDK 통합
    • 커스텀 어댑터
    • LevelPlay SDK Changelog
    • Ad Quality SDK 변경 기록
  • 규정 및 설정
  • 광고 형식
  • Mediation 네트워크
  • 연동 테스트
  1. 게임 성장
  3. Unity 레벨플레이
  5. LevelPlay SDK
  7. iOS 개발자를 위한 레벨플레이 SDK

iOS SDK 연동

CocoaPods 또는 매뉴얼 메서드를 사용하여 레벨플레이 SDK를 iOS 앱에 통합하고 앱 키로 초기화합니다.
읽는 시간 8분
최근 업데이트: 8시간 전
레벨플레이 SDK는 CocoaPods, Swift 패키지 관리자 및 매뉴얼 다운로드 메커니즘을 지원하여 SDK를 통합합니다.

필수 조건

iOS 버전 지원은 네트워크별로 정의됩니다. 레벨플레이 광고와 레벨플레이 Mediation iOS 버전 12 이상, Xcode 버전 15.4 이상을 지원합니다.
iOS 14와 호환되기 위해 레벨플레이 SKAdNetwork 어트리뷰션을 지원하는 SDK 7 이상을 릴리스했습니다.

프로젝트에 SDK 추가

CocoaPods

CocoaPods 는 Objective-C 및 Swift 의 종속성 관리자로서 SDK 통합 프로세스를 자동화하고 단순화합니다. 자세한 내용은 CocoaPods의 시작하기 및 CocaPods 사용 설명서를 참조하십시오.
레벨플레이 SDK를 CocoaPods와 연동하려면 Podfile에 다음 줄을 입력합니다.
pod 'IronSourceSDK','9.5.0.0'
프로젝트에서 Swift를 사용하지 않는 경우 Project > Build Settings > Linking > Runpath Search Paths로 이동하여 다음 코드를 추가합니다.
// needs to be first on the list /usr/lib/swift
참고
버전 8.9.0부터 Ad 품질 레벨플레이 SDK에 통합되며, 레벨플레이 구현되면 자동으로 초기화됩니다. 자세한 내용은 광고 품질 개요를 참조하십시오.

Swift 패키지 관리자

참고
Swift 패키지 관리자를 사용하려면 지원되는 최소 레벨플레이 SDK 버전 9.3.0과 해당 어댑터 버전이 최소 어댑터 및 네트워크 SDK 버전 섹션에 정의되어 있어야 합니다.
프로젝트에 패키지 종속성을 추가하려면 다음 단계를 완료하십시오.
  1. Xcode에서 파일 > 패키지 종속성 추가로 이동합니다.
  2. 표시되는 프롬프트 다음 패키지 URL을 검색합니다. 
    https://github.com/ironsource-mobile/LevelPlay-Swift-Package
  3. 종속성 규칙에서 브랜치를 선택합니다.
  4. 텍스트 필드에 
    main
    를 입력합니다.

Mediation 네트워크 어댑터 패키지 추가

각 Mediation 네트워크에는 자체 어댑터 Swift 패키지가 있으며, IronSource Mobile GitHub 조직에서 호스팅됩니다. 어댑터 저장소는 명명 형식 
LevelPlay-<Network>-Adapter-Swift-Package
를 사용합니다. 예를 들어 Unity Ads 어댑터는 
LevelPlay-UnityAds-Adapter-Swift-Package
저장소에 있고 AdMob 어댑터는 
LevelPlay-AdMob-Adapter-Swift-Package
저장소에 있습니다.
프로젝트에 Mediation 네트워크 어댑터 패키지를 추가하려면 다음 단계를 완료합니다.
  1. IronSource Mobile GitHub 조직에서 추가하려는 네트워크의 어댑터 저장소를 찾습니다.
  2. 저장소 URL을 복사합니다.
  3. Xcode에서 파일 > 패키지 종속성 추가로 이동합니다.
  4. 표시되는 프롬프트 어댑터 저장소 URL을 입력합니다.
  5. 종속성 규칙에서 정확한 버전을 선택합니다.
  6. 프로젝트에서 레벨플레이 SDK 버전과 호환되는 태그가 지정된 어댑터 버전을 입력합니다.
호환 가능한 버전을 선택하려면 최소 어댑터 및 네트워크 SDK 버전 섹션과 해당 어댑터 변경 기록을 참조하십시오. 추가하려는 각 Mediation 네트워크에 대해 이 단계를 반복합니다.

최소 어댑터 및 네트워크 SDK 버전

네트워크 이름

최소 어댑터 버전

최소 네트워크 SDK 버전

Unity Ads
5.8.1
4.16.5
AppLovin
5.7.1
13.6.2
BidMachine
5.7.1
3.6.1
Digital Turbine
5.8.1
8.4.6
Google AdMob
5.10.1
13.2.0
HyprMX
5.3.1
6.4.6
LY 광고 네트워크
5.4.1
3.0.1
Meta
5.3.1
6.21.1
Mintegral
5.18.1
8.1.0
MobileFuse
5.2.0
1.11.0
MyTarget
5.11.1
5.41.0
Ogury
5.5.1
5.2.1
Pangle
5.28.1
7.9.1.1
Voodoo
5.2.1
3.15.1
Vungle
5.10.1
7.7.4
Yandex
5.9.1
8.1.0

매뉴얼 다운로드

프로젝트에 레벨플레이 SDK를 수동으로 추가하려면 다음 단계를 완료하십시오.
  1. iOS SDK 버전 9.5.0 다운로드
  2. SDK의 압축을 풀고 Xcode 프로젝트에 
    IronSource.framework
    를 추가합니다.
  3. 에 있는 빌드 설정에 다음 링커 플래그 추가합니다. 타겟 > 빌드 설정 > 링크 > 기타 링커 플래그: -ObjC
  4. 임포트 라이브러리 - "z","sqlite3.0"
  5. 임포트 프레임워크 - "JavaScriptCore","WebKit","AdSupport","SystemConfiguration"

레벨플레이 Mediation 데모 앱

통합 데모 애플리케이션 앱에 레벨플레이 Mediation 통합하는 방법을 보여 줍니다.
iOS 데모 애플리케이션 다운로드

프로퍼티 목록 파일 업데이트

SKAdNetwork 지원

SDK 7 이상을 사용하는 경우 아이언소스 네트워크 광고 표시를 활성화하다, 사용 가능하다 앱 프로퍼티 리스트 파일(Info.plist)에 아이언소스 광고 네트워크 ID를 포함해야 합니다. 
  1. Xcode 프로젝트 내비게이터에서 Info.plist 를 선택합니다.
  2. 프로퍼티 목록 에디터에서 키 옆의 Add (+)를 선택한 다음 Return을 선택합니다.
  3. 키 이름을 입력 SKAdNetworkItems.
  4. Type 열에서 배열을 선택합니다.
  5. 딕셔너리 항목을 생성한 다음 단일 문자열 항목을 생성합니다.
  6. 키 이름 SKAdNetworkIdentifier 및 다음 키 값을 입력합니다.
    su67r6k2v3.skadnetwork
다음 코드를 사용하여 Info.plist 파일에 SKAdNetworkIdentifier를 추가할 수도 있습니다. 
<key>SKAdNetworkItems</key><array>   <dict>      <key>SKAdNetworkIdentifier</key>      <string>su67r6k2v3.skadnetwork</string>   </dict></array>
프로퍼티 목록 편집에 대한 자세한 내용은 Xcode 기술 자료를 참조하십시오.

유니버설 SKAN 보고

광고된 앱의 모든 수요 소스에서 설치 확인 포스트백을 받으려면 앱의 Info.plist 파일에 NSAdvertisingAttributionReportEndpoint 키를 추가하십시오.
  1. Xcode 프로젝트 내비게이터에서 Info.plist 를 선택합니다.
  2. 프로퍼티 목록 에디터에서 키 옆의 Add (+)를 선택한 다음 Return을 선택합니다.
  3. 키 이름 NSAdvertisingAttributionReportEndpoint을 입력합니다.
  4. Type 열에서 String을 선택합니다.
  5. 다음 URL을 입력합니다. 
    https://postbacks-is.com/
    .
유니버설 SKAN 보고에 대한 자세한 내용은 SKAdNetwork ID 수동 추가를 참조하십시오.

앱 전송 보안 설정

모든 Mediation 네트워크에서 레벨플레이 광고 전송에 대한 무중단 지원을 보장하려면 Info.plist 파일을 다음과 같이 변경하십시오.
  • 더하기 기호를 선택하여 사전 
    NSAppTransportSecurity
    를 추가합니다. 이 딕셔너리를 Top Level Key에 추가해야 합니다.
    • 이 사전 안에 
      NSAllowsArbitraryLoads
      라는 부울을 추가하고 탭을 선택하여 
      YES
      로 설정합니다.
  • Info.plist 파일에는 충돌을 일으킬 수 있으므로 
    NSAllowsArbitraryLoads
    외에 다른 예외가 포함되어 있지 않습니다.
  • 앱 전송 보안에 대한 자세한 내용은 Apple 기술 자료를 참고하십시오.

레벨플레이 SDK 초기화

필요한 파일 임포트

#import "IronSource/IronSource.h"

SDK 시작

레벨플레이 SDK를 초기화하려면 다음 단계를 완료합니다.
  1. 완료 핸들러 성공 및 실패를 정의합니다.
  2. 해당하는 경우 appKey와 사용자 ID를 사용하여 레벨플레이 init API 호출.
사용자에게 보상을 제공하기 위해 서버 간 콜백을 사용하거나 광고 품질 사용자 여정을 사용하는 경우 초기화 요청 빌더의 일부로 사용자 ID를 추가합니다.
    // 앱 키와 광고 형식을 사용하여 요청 빌더를 생성합니다. 사용 가능한 경우 사용자 ID 추가LPMInitRequestBuilder *requestBuilder = [[LPMInitRequestBuilder alloc] initWithAppKey:@"appKey"];[requestBuilder withUserId:@"UserId"];// Build the initial requestLPMInitRequest *initRequest = [requestBuilder build];// Initialize LevelPlay with the prepared request[레벨플레이 initWithRequest:initRequest 완료:^(LPMConfiguration *_Nullable config, NSError *_Nullable error){   if(error) {       // There was an error on initialization. 필요한 조치를 취하거나 재시도   } else {      // Initialization was successful. 이제 광고 오브젝트를 생성하고 광고를 로드하거나 다른 작업을 수행할 수 있습니다.            }}];
// 앱 키와 광고 형식을 사용하여 요청 빌더를 생성합니다. 사용 가능한 경우 사용자 ID 추가let requestBuilder = LPMInitRequestBuilder(appKey: "appKey")   .withUserId("UserId")// 초기 요청 빌드let initRequest = requestBuilder.build()// 준비된 요청으로 레벨플레이 초기화 LevelPlay.initWith(initRequest) {config, error inif let error = error {   // 초기화 시 오류가 발생했습니다. 필요한 조치를 취하거나 재시도} else {   // 초기화가 성공했습니다. 이제 광고 오브젝트를 생성하고 광고를 로드하거나 다른 작업을 수행할 수 있습니다.}}

초기화 결과

  • 성공: 초기화가 성공적으로 완료되면 트리거됩니다. 이 표시를 수신하면 광고를 생성하고 로드할 수 있습니다.
  • 오류: 설정 검색해서 가져오지 못했으며 광고를 로드할 수 없습니다. 권장되는 베스트 프랙티스는 나중에 인터넷 연결이 가능하거나 오류 원인이 해결되었을 때 레벨플레이 SDK를 초기화하는 것입니다.

연동 확인

앱의 통합을 테스트하고, 플랫폼 설정을 검증하고, 설정된 네트워크와 관련된 광고를 검토하려면 레벨플레이 통합 테스트 제품군을 사용하십시오. 
앱에서 테스트 제품군을 활성화하다, 사용 가능하다 init를 설정하기 전에 setMetaData API 호출.
[LevelPlay setMetaDataWithKey:@"is_test_suite" value:@"enable"];
LevelPlay.setMetaDataWithKey("is_test_suite", value: "enable")
Mediation init가 완료되면 다음 메서드를 호출하여 테스트 제품군을 실행.
[LevelPlay launchTestSuite:self];
LevelPlay.launchTestSuite(self)

다음 단계

  1. 광고 형식을 구현하려면 다음 연동 가이드를 참고하십시오.
    • 보상형 비디오
    • 인터스티셜 광고
    • Banner
    • 네이티브 광고
  2. 앱에 보상형 비디오, 인터스티셜 광고 또는 배너 광고를 통합합니다. iOS용 Mediation 네트워크를 참고하십시오.
Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

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

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

  • 보고 있는 페이지

    • 필수 조건

    • 프로젝트에 SDK 추가

      • CocoaPods

      • Swift 패키지 관리자

        • Mediation 네트워크 어댑터 패키지 추가

        • 최소 어댑터 및 네트워크 SDK 버전

      • 매뉴얼 다운로드

      • 레벨플레이 Mediation 데모 앱

    • 프로퍼티 목록 파일 업데이트

      • SKAdNetwork 지원

      • 유니버설 SKAN 보고

      • 앱 전송 보안 설정

    • 레벨플레이 SDK 초기화

      • 필요한 파일 임포트

      • SDK 시작

      • 초기화 결과

    • 연동 확인

    • 다음 단계

이 페이지의 문제 보고