네이티브 플러그인 통합 반응

필수 조건

• React 네이티브 플러그인 Android의 네이티브 SDK 버전 7.2.4.1, iOS의 네이티브 버전 7.2.4에서 지원됩니다.
• 이 플러그인 JavaScript TypeScript를 모두 지원합니다. 유형 선언은 npm 패키지에 포함됩니다.
• React Native 0.66 이상을 지원합니다.
• iOS 버전 지원은 네트워크별로 정의됩니다. 레벨플레이 광고와 레벨플레이 Mediation iOS 버전 12 이상, XCode 버전 15.4 이상을 지원합니다.
• Android 운영 체제 버전 5.0(API 레벨 21) 이상

1단계. 프로젝트에 Unity 레벨플레이 React Mediation 플러그인 추가

NPM 통합

1. npm CLI 커맨드 실행

   npm 설치 Unity 레벨플레이 Mediation

2. package.json 파일 업데이트: package.json 파일에 Unity 레벨플레이 Mediation 정의를 추가합니다.

   "dependencies": {    "unity-levelplay-mediation": "9.1.0"}

3. 광고 품질 SDK 추가
   참고

   React 네이티브 플러그인 버전 3.1.1부터 Ad 품질 레벨플레이 SDK에 통합되며, 레벨플레이 구현될 때 자동으로 초기화됩니다. 아래에서 설명하는 단계는 레벨플레이 빌드 구현되지 않거나 3.1.1 이전 버전의 React 네이티브 플러그인 사용하는 경우에 적용됩니다.
   Android:

   dependencies {    implementation 'com.unity3d.ads-mediation:adquality-sdk:9.3.1'}

   iOS:

   pod 'IronSourceAdQualitySDK','9.3.1'

1. React 네이티브 플러그인 버전 다운로드
2. package.json 파일에 Unity 레벨플레이 Mediation 정의를 추가합니다.

"dependencies": {  "unity-levelplay-mediation": 경로/로컬/디렉토리}

Unity 레벨플레이 데모 앱

2단계. iOS용 추가 설정

SKAdNetwork 지원

1. Xcode의 프로젝트 내비게이터에서 Info.plist 를 선택합니다.
2. 프로퍼티 목록 에디터에서 키 옆의 추가(+) 버튼을 선택하고 **반환(Return)**을 누릅니다.
3. 키 이름을 입력 SKAdNetworkItems
4. Type 열의 팝업 메뉴에서 배열을 선택합니다.
5. 딕셔너리 항목을 생성하고 그 아래에 단일 스팅 항목을 생성한다.  
6. 키 이름 SKAdNetworkIdentifier를 입력하고 키 값을 입력합니다.

   su67r6k2v3.skadnetwork

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

유니버설 SKAN 보고

1. Xcode의 프로젝트 내비게이터에서 Info.plist를 선택합니다.
2. 프로퍼티 리스트 에디터 키 옆의 Add 버튼(+)을 선택하고 Return을 누릅니다.
3. 키 이름을 입력합니다NSAdvertisingAttributionReportEndpoint
4. Type 열의 팝업 메뉴에서 String을 선택합니다.
5. URL 입력:

   https://postbacks-is.com

앱 전송 보안 설정

• 'NSAppTransportSecurity'라는 사전에 추가합니다. 'Top Level Key'에 이 사전을 추가해야 합니다.
•  이 사전 안에 'NSAllowsArbitraryLoads'라는 부울을 추가하고 YES로 설정합니다.
• info.plist에는 충돌을 일으킬 수 있으므로 'NSAllowsArbitraryLoads' 외에 다른 예외가 없습니다.
• ATS에 대한 자세한 내용은 여기를 참조하십시오.

3단계. Android용 추가 설정

플레이 서비스 종속성

dependencies {    implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'    implementation 'com.google.android.gms:play-services-basement:18.3.0'    implementation 'com.google.android.gms:play-services-appset:16.0.2'}

Android 12 지원

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

4단계. 레벨플레이 SDK 초기화

LevelPlay SDK 8.7.0+

1. 초기화 성공 또는 실패에 대한 콜백을 구현합니다.
2. LevelPlayInitRequest.Builder를 사용하여 init 요청을 생성합니다. 빌더는 다음 파라미터를 수신해야 합니다.
   • appKey(필수)
   • 사용자 ID(선택 사항: 서버 간 콜백을 사용하거나 광고 품질 사용자 경로를 사용하는 경우 필수)
3. 호출 레벨플레이.init 및 컨텍스트 및 init 요청 전달.

const initListener: LevelPlayInitListener = {    onInitFailed: (error: LevelPlayInitError) => {        // Provided when init fails    },    onInitSuccess: (configuration: LevelPlayConfiguration) => {        // Provided when init is successfully executed    }}// Init the SDK when implementing the Multiple Ad Units APIs for all ad formatsconst initRequest: LevelPlayInitRequest = LevelPlayInitRequest.builder(APP_KEY)      .withUserId("userId") // required for server-to-server callbacks or Ad Quality user journey (optional otherwise)      .build();LevelPlay.init(initRequest, initListener)

LevelPlay SDK before 8.7.0

1. 초기화 성공 또는 실패에 대한 콜백을 구현합니다.
2. Ironsourcensource API 지원이 필요한 광고 형식 리스트를 정의합니다. 여기에는 보상형 광고 포함되어야 합니다. 
3. 해당하는 경우 appKey, 광고 형식, 사용자 ID를 사용하여 레벨플레이 init API 호출.

const initListener: LevelPlayInitListener = {   onInitFailed: (error: LevelPlayInitError) => {    // Provided when init is failed   },   onInitSuccess: (configuration: LevelPlayConfiguration) => {    // Provided when init is successfully executed   }}// Init the SDK when implementing the Multiple Ad Units Interstitial and Banner APIs, and Rewarded using legacy APIs  const legacyAdFormats = [AdFormat.REWARDED];const initRequest: LevelPlayInitRequest = LevelPlayInitRequest.builder(APP_KEY)      .withLegacyAdFormats(legacyAdFormats)      .withUserId("userId") // required for server-to-server callbacks or Ad Quality user journey (optional otherwise)      .build();await LevelPlay.init(initRequest, initListener)

레벨플레이 Init 리스너

• onInitSuccess – init가 성공적으로 완료되고 광고를 로드할 수 있으면 트리거됩니다.
• onInitFailed – 설정이 성공적으로 수신되지 않았으며 광고를 로드할 수 없습니다. 나중에 레벨플레이 SDK를 초기화하는 것이 좋습니다.

5단계 연동 확인

LevelPlay.setMetaData('is_test_suite', ['enable'])

LevelPlay.launchTestSuite()

어댑터 디버그

LevelPlay.setAdaptersDebug(true);

ProGuard 사용자 전용

-keepclassmembers class com.ironsource.sdk.controller.IronSourceWebView$JSInterface {    public *;}-keepclassmembers 클래스 * implements android.os.Parcelable {    public static final android.os.Parcelable$Creator *;}-keep public class com.google.android.gms.ads.** {   public *;}-keep class com.ironsource.adapters** { *;}-keep class com.ironsource.unity.androidbridge.** { *;}-dontwarn com. 아이언소스.mediationsdk.**-dontwarn com.ironsource.adapters**-keepattributes JavascriptInterface-keepclassmembers 클래스 * {    @android.webkit.JavascriptInterface <methods>;}

다음 단계

1. 연동 가이드를 따라 광고 형식을 구현합니다.
   • 보상형 비디오
   • 인터스티셜 광고
   • Banner
   • 네이티브 광고
2. 앱에 보상형 비디오, 인터스티셜 광고 또는 배너 광고를 통합하고 Mediation 기사를 따르십시오.
3. 통합 테스트 제품군과의 통합 여부 확인