플러그인 통합 플러그인 통합

필수 조건

• Flutter 플러그인은 Android 및 iOS용 SDK 버전 7.2.1.2부터 지원됩니다.
• Flutter 3.0.0 이상 지원

프로젝트에 레벨플레이 Mediation 플러그인 추가

Pub.dev 통합

1. Flutter CLI 커맨드 실행

   flutter pub get Unity_levelplay_Mediation

2. pubspec.yaml 파일에

   unity_levelplay_mediation

   정의를 추가하여 pubspec.yaml 파일을 업데이트합니다.

   dependencies:  flutter:    sdk: 플러터   unity_levelplay_mediation: '>=9.1.0 <9.2.0'

3. Ad Quality SDK 추가

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

pod 'IronSourceAdQualitySDK','9.3.1'

수동 연동

레벨플레이 데모 앱

iOS용 추가 설정

SKAdNetwork 지원

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>

유니버설 SKAN 보고

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

   https://postbacks-is.com/

앱 전송 보안 설정

info.plist

• NSAppTransportSecurity

  라는 사전에 추가합니다. 이 사전을 Top Level Key에 추가해야 합니다.
• 이 사전 안에

  NSAllowsArbitraryLoads

  라는 부울을 추가하고 YES로 설정합니다.
• 이로 인해 충돌이 발생할 수 있으므로 info.plist에

  NSAllowsArbitraryLoads

  외에 다른 예외가 포함되어 있지 않습니다.
• ATS에 대한 자세한 내용은 Apple 기술 자료를 참조하십시오.

Android용 추가 설정

플레이 서비스 종속성

dependencies {   implementation 'com.google.android.gms:play-services-ads-identifier:18.2.0'   implementation 'com.google.android.gms:play-services-appset:16.1.0'}

Android 12 지원

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

AndroidManifest.xml에서 레이블 교체

• 프로젝트의 AndroidManifest.xml에 ‘xmls:tools’를 추가합니다.
• 'tools:replace='android: 레이블''을 '애플리케이션' 태그에 추가합니다.

레벨플레이 SDK 초기화

레벨플레이 SDK 8.6.0 이상

1. 초기화 성공 또는 실패에 대한 콜백을 구현합니다.
2. 세션에서 초기화할 광고 형식 리스트를 정의합니다.

3. LevelPlayInitRequest.builder

   를 사용하여 init 요청을 생성합니다. 빌더는 다음 파라미터를 수신합니다.
   • appKey(필수)
   • 사용자 ID(선택 사항: 서버 간 콜백을 사용하거나 광고 품질 사용자 경로를 사용하는 경우 필수)
4. LevelPlay.init을 호출하고 컨텍스트와 init 요청을 전달합니다.

클래스 MyLevelPlayInitListener는 LevelPlayInitListener 를 구현합니다.    @override    void onInitFailed(LevelPlayInitError error) {	      // Provided when init is failed    }    @override    void onInitSuccess(LevelPlayConfiguration configuration) {	      // Provided when init is successfully executed    }}LevelPlayInitRequest initRequest = LevelPlayInitRequest.builder([APP_KEY])                .withUserId("userId") // required for server-to-server callbacks or Ad Quality user journey (optional otherwise)                .build();LevelPlay.init(initRequest, MyLevelPlayInitListener());

LevelPlay SDK before 8.6.0

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

클래스 MyLevelPlayInitListener는 LevelPlayInitListener 를 구현합니다.  @override  void onInitFailed(LevelPlayInitError error) {	// Provided when init is failed  }  @override  void onInitSuccess(LevelPlayConfiguration configuration) {	// Provided when init is successfully executed  }}// Init the SDK when implementing the Multiple Ad Units Interstitial and Banner APIs, and Rewarded using legacy APIs  List<AdFormat> legacyAdFormats = [AdFormat.REWARDED];LevelPlayInitRequest initRequest = LevelPlayInitRequest.builder([APP_KEY])                .withLegacyAdFormats(legacyAdFormats)                .withUserId("userId") // required for server-to-server callbacks or Ad Quality user journey (optional otherwise)                .build();LevelPlay.init(initRequest, MyLevelPlayInitListener());

레벨플레이 Init 리스너

• onInitSuccess

  : init가 성공적으로 완료되고 광고를 로드할 수 있을 때 트리거됩니다.

• onInitFailed

  : 설정 성공적으로 수신되지 않았으며 광고를 로드할 수 없습니다. 권장되는 베스트 프랙티스는 나중에 레벨플레이 SDK를 초기화하는 것입니다.

• init API 이전에 호출된 모든 API는 변경되지 않았으며 기능과 구문 측면에서 그대로 유지되어야 했습니다. 여기에는 특정 광고 형식과 관련된 고급 설정, 규정 설정 또는 기타 API가 포함됩니다.
• 초기화에 실패하면 SDK를 다시 초기화해 볼 수 있습니다. 성공적인 초기화 프로세스가 끝나면 광고를 로드할 수 있습니다.

연동 확인

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. 통합 테스트 제품군과의 통합 여부 확인