# AppLovin 통합

> 단계별 설정 지침을 통해 Unity 레벨플레이 Mediation 플랫폼에서 AppLovin을 광고 네트워크로 통합합니다.

> **Important:**
>
> 다음 기술 자료는 Unity가 개발하거나, 소유하거나, 운영하지 않는 제품 또는 서비스('타사 제품')에 관한 내용입니다.
> 이 정보는 오래되었거나 불완전할 수 있으며 편의를 위해 제공됩니다.
> 타사 제품을 사용하는 경우 해당 제품의 약관이 적용됩니다.
> Unity는 이러한 제품에 대해 어떠한 보증도 하지 않으며, 타사 제공자의 콘텐츠, 광고 또는 머티리얼과 관련된 문제를 포함하여 제품 사용으로 인한 손해나 손실에 대해서도 책임지지 않습니다.

이 가이드는 Unity 레벨플레이 AppLovin을 광고 네트워크로 게재하는 방법을 단계별로 설명합니다.

> **Note:**
>
> 이 Mediation 네트워크의 어댑터 변경 기록을 보려면 [Unity용 Mediation 네트워크](/grow/levelplay/sdk/unity/mediation-networks.md.md#integrate-network-adapters)를 참조하십시오.

## 필수 조건##prerequisites

레벨플레이의 [보상형 광고](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md), [인터스티셜 광고](/grow/levelplay/sdk/unity/interstitial-integration.md) 또는 [배너](/grow/levelplay/sdk/unity/banner-integration.md)를 애플리케이션에 올바르게 통합했는지 확인합니다.

Android Applovin SDK 12.4.3 이상의 어댑터 버전 4.3.49 이상을 사용 중인 경우 Android 매니페스트에서 applovin.sdk.key를 제거해야 합니다.

## 1단계. AppLovin 계정 생성

1. AppLovin을 사용하여 계정을 만듭니다. 당신은 [여기서](https://www.applovin.com/signup) 할 수 있습니다.
2. 계정이 확인되면 [여기](https://www.applovin.com/login) 파트너 로그인으로 로그인할 수 있습니다.

## 2단계. AppLovin SDK 검색 및 리포트 키 검색

AppLovin 계정의 두 가지 데이터는 레벨플레이 관련하여 올바르게 작동하려면 레벨플레이 네트워크 설정 모듈에 삽입해야 합니다.

* **보고서 키:** Unity 레벨플레이 AppLovin 계정에서 성능 데이터를 임포트 리포트 및 최적화에 사용할 수 있도록 지원하는 AppLovin 계정의 고유 식별자.
* **SDK Key:** AppLovin 계정의 고유 식별자. 레벨플레이 Mediation SDK에서 앱 AppLovin 어댑터 시작하는 데 사용합니다.

이 정보를 얻으면 레벨플레이 계정에서 AppLovin 파라미터를 **설정해야 합니다.** 위 정보를 올바르게 추가하면 레벨플레이 Mediation 플랫폼에서 AppLovin의 광고 인벤토리와 보고 데이터를 최대한 활용할 수 있습니다.

1. ### 리포트 키

   **보고서 키**를 찾으려면 **계정** 탭으로 이동하여 왼쪽 메뉴에서 **키**를 선택합니다.

   ![AppLovin Report 계정 설정의 주요 위치](/api/media?file=/grow/media/images/SDK-Key-2.png)

2. ### SDK 키

   **SDK** **키**를 찾으려면 **계정** 탭으로 이동하여 왼쪽 메뉴에서 **키**를 선택합니다.

   ![계정 설정의 AppleLovin SDK 키 위치](/api/media?file=/grow/media/images/SDK-Key-1.png)

## 3단계. 레벨플레이 AppLovin 활성화

* 레벨플레이 계정에 로그인하고 **레벨플레이 측 바** > **설정** > **네트워크**로 이동합니다.

* **Manage Networks** 페이지에서 사용 가능한 광고 네트워크 목록에서 AppLovin을 선택합니다. 그런 다음 광고 네트워크 설정 페이지에서 보고서 키를 입력하고 **저장**을 선택합니다.

  ![레벨플레이에 AppLovin 보고서 키 입력](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.28.49.png)

* 다음으로 왼쪽 내비게이션 바에서 **인스턴스 페이지**로 이동합니다. **인스턴스 페이지** 상단에서 Unity 레벨플레이의 Mediation with **AppLovin**을 실행할 앱을 선택합니다.

* 광고 네트워크 설정 목록에서 Applovin을 선택합니다.

  ![네트워크 목록에서 AppLovin 선택](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.34.46.png)

* App settings 페이지에서 2단계에서 가져온 SDK 키를 삽입합니다. 그런 다음 Applovin을 통해 수익화할 각 광고 형식(인터스티셜 광고 광고, 보상형 광고 광고, 배너 대한 인스턴스 생성합니다. 원하는 광고 형식을 선택하고 페이지 하단의 **인스턴스 추가**를 선택합니다. 필요한 정보를 입력한 다음 **저장**을 선택합니다.

  ![AppLovin 인스턴스 설정 추가](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.35.49.png)

앱이 AppLovin 광고 네트워크를 통해 수익화를 진행 중입니다.

## 4단계. 빌드 AppLovin 어댑터 추가하기##step-4.add-the-applovin-adapter-to-your-build

### 레벨플레이 네트워크 관리자권장)##levelplay-network-manager(recommended)

SDK 연동이 완료되면 레벨플레이 네트워크 관리자 사용하여 AppLovin 어댑터 다운로드 수 있습니다.

Unity 개발 플랫폼에서 Ads Mediation > 네트워크 관리자 이동합니다.

이미 최신 버전의 어댑터가 있는 경우, **행동** 버튼이 "업데이트"로 변경되고 비활성화됩니다.

### Android(매뉴얼 결정)##android-(manual-resolve)

변경 사항을 적용하려면 "결정" 프로세스를 사용해야 합니다. 그러면 선택에 따라 모든 관련 아티팩트가 다운로드. 자세한 내용은 [여기](/grow/levelplay/sdk/unity/package-integration.md)의 지침을 참조하십시오. 

### iOS##ios

Applovin SDK 12.4.1 이상의 어댑터 버전 4.3.48 이상부터 Applovin XCFramework는 "임베드, 포함된, 내장된 및 서명"이어야 합니다.

다음과 같이 관련 폴더 아래의 Unity 프로젝트 Post-Process 스크립트 추가합니다. 

* SDK Version 8.0.0+:  자산/레벨플레이/에디터 
* SDK 버전 8.0.0 이하: Assets/IronSource/Editor 

스크립트는 [여기](https://developers.is.com/wp-content/uploads/2016/04/EmbedApplovin.cs_.zip)에서 다운로드할 수 있습니다.

#### ProGuard 사용자 전용(Android)##for-proguard-users-only-(android)

ProGuard를 AppLovin 어댑터와 함께 사용하는 경우 다음 코드를 ProGuard 설정에 추가해야 합니다(Android Studio: proguard-rules.pro 또는 Eclipse: proguard-project.txt).

```text
-keepattributes Signature,InnerClasses,Exceptions,Annotation
-keep public class com.applovin.sdk.AppLovinSdk{ *; }
-keep public class com.applovin.sdk.AppLovin* { public protected *; }
-keep public class com.applovin.nativeAds.AppLovin* { public protected *; }
-keep public class com.applovin.adview.* { public protected *; }
- keep 공용 클래스 com.applovin.Mediation.* { 공용 보호 *; }
-keep public class com.applovin.mediation.ads.* { public protected *; }
-keep public class com.applovin.impl.*.AppLovin { public protected *; }
-keep 공용 클래스 com.applovin.impl.**.*Impl { 공용 보호 *; }
-keepclassmembers 클래스 com.applovin.sdk.AppLovinSdk설정 { private java.util.Map localSettings; }
-keep 클래스 com.applovin.mediation.adapters.** { *; }
-keep 클래스 com.applovin.mediation.adapter.**{ *; }
```

#### Android 플러그인 매뉴얼 통합##android-plugin-manual-integration

1. **AppLovin 어댑터 다운로드:** 어댑터 및 AppLovin SDK (AAR)를 [여기](/grow/levelplay/sdk/android/mediation-networks.md)에서 다운로드하십시오.
2. ****Unity 프로젝트에 AppLovin 파일을 추가합니다.**** 어댑터 파일을 **Assets/Plugins/Android로 임포트합니다.**

#### AndroidManifest.xml 업데이트##update-androidmanifest.xml

AppLovin Android 어댑터 버전 4.3.13 이상(Android SDK 버전 6.17.0)부터 AppLovin 어댑터는 AAR로 릴리스됩니다. Jar 연동을 유지하려는 경우에만 매니페스트 추가합니다.

### 매니페스트 사용 권한##manifest-permissions

`<application>` 태그 외부에 다음 권한을 추가합니다.

```text
<uses-permission android:name="android.permission.INTERNET"/>
```

### 매니페스트 활동##manifest-activities

**매니페스트의 `<application>` 태그 안에 다음 활동을 추가합니다.**

```xml
 <!-- AppLovin -->
            <activity
            android:name="com.applovin.adview.AppLovinInterstitialActivity"
            android:configChanges="orientation|screenSize|smallestScreenSize|screenLayout|uiMode"
            android:hardwareAccelerated="true"
            android:screenOrientation="behind"/>
            <activity
            android:name="com.applovin.adview.AppLovinFullscreenActivity"
            android:configChanges="keyboard|keyboardHidden|로케일 | 방향, 방향 설정 |screenSize|smallestScreenSize|uiMode"
            android:exported="false"
            android:hardwareAccelerated="true"
            android:launchMode="singleTop"
            android:screenOrientation="behind"/>
            <activity
            android:name="com.applovin.sdk.AppLovinWebViewActivity"
            android:configChanges="keyboardHidden|orientation|screenSize|uiMode"/>
```

#### iOS 플러그인 매뉴얼 통합##ios-plugin-manual-integration

1. **AppLovin 어댑터 및 SDK 파일 다운로드:**  iOS용 [Mediation 네트워크를 참고하십시오](/grow/levelplay/sdk/ios/mediation-networks.md).
2. **AppLovin 어댑터 파일을 Unity 프로젝트에 추가** 어댑터 파일을 **Assets/Plugins/iOS**로 임포트합니다.
3. **Xcode 프로젝트에 SDK를 추가합니다.** Unity3D는 XCFrameworks를 지원하지 않으므로 SDK XCFrameworks를 Xcode 프로젝트에 직접 추가합니다.

## 5단계 AppLovin의 관리자에서 보상형 광고 설정

빌드 AppLovin 어댑터 추가한 후 AppLovin 관리자에서 보상형 광고 광고 기능을 활성화하다, 사용 가능하다 합니다.

1. AppLovin 관리자에서 **앱 관리자**로 이동하여 설정할 특정 앱을 선택합니다.

   ![AppLovin 관리 앱 화면](/api/media?file=/grow/media/images/apps.png)

2. **보상형 광고** 섹션으로 스크롤하여 다음 토글을 설정합니다.
   1. **빈도, 주파수, 복잡도** 제한 - 비빈도, 주파수, 복잡도 제한 없음 보상형 광고
   2. **가상 통화 세부 정보** - Unity 레벨플레이 Mediation 어댑터가 이 값을 설정하므로 기본값을 유지할 수 있습니다.
   3. **디스플레이 사전 비디오 모달** - 아니요
   4. **디스플레이 포스트 비디오 모달** - 아니요
   5. **콜백 옵션** - 클라이언트 측 콜백만
      ![AppLovin 보상형 비디오 설정](/api/media?file=/grow/media/images/apps-1.png)

3. 완료되면 '**저장**'을 누릅니다.

## 6단계. AppLovin 추가 설정##step-6.-applovin-additional-settings

### 연령 제한 설정##set-age-restriction

> **Note:**
>
> AppLovin 연령 제한 설정은 Android 및 iOS용 AppLovin SDK 13.0.0, AppLovin Unity 어댑터 4.3.53에서 지원되지 않습니다.

레벨플레이 Mediation 플랫폼을 사용하면 퍼블리셔가 AppLovin 연령 제한 설정을 AppLovin 네트워크에 직접 전달할 수 있습니다. 이 기능은 레벨플레이 SDK 6.17.1 이상의 AppLovin Unity 어댑터 4.3.18 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.

다음 구문을 사용하여 AppLovin setIsAgeRestrictedUser를 파라미터 True로 설정합니다.

```text
LevelPlay.SetMetaData("AppLovin_AgeRestrictedUser","true");
```

다음 구문 사용하여 AppLovin setIsAgeRestrictedUse를 False 파라미터 설정합니다.

```text
LevelPlay.SetMetaData("AppLovin_AgeRestrictedUser","false");
```

AppLovin 네트워크의 연령 제한 설정에 대해 자세히 알아보려면 [AppLovin 문서](https://dash.applovin.com/docs/integration#androidPrivacySettings)를 방문하십시오.

**광고 네트워크 통합 확인**

* [통합 도우미](/grow/levelplay/sdk/unity/integration-helper.md)에서 광고 네트워크 통합을 확인하십시오. 레벨플레이 SDK는 SDK와 추가 네트워크 어댑터를 성공적으로 연동했는지 확인하는 툴을 제공합니다.
* 이 부울을 사용하여 통합 Mediation 광고 네트워크의 디버그 로그를 관리합니다.

  ```text
  LevelPlay.SetAdaptersDebug(true);
  ```

  **TRUE**로 설정하면 이 코드 라인은 디버그 로그를 활성화하고, 사용 가능하게 하는 모든 Mediation 광고 네트워크의 문제 해결을 지원합니다.  앱이 광고 유닛으로 게재되기 전에 이 코드를 제거합니다. SDK 버전 6.5.2 이상에서 지원됩니다. 

## 다음 단계##next-steps

Unity 레벨플레이 통해 추가 광고 네트워크를 활용하려면 어댑터를 연동하고 Unity 연동 가이드를 따르십시오.

**Platform adapters:**

* [Unity](/grow/levelplay/sdk/unity/mediation-networks.md)
* [Android](/grow/levelplay/sdk/android/mediation-networks.md)
* [iOS](/grow/levelplay/sdk/ios/mediation-networks.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/mediation-networks.md)
* [Flutter](/grow/levelplay/sdk/flutter/mediation-networks.md)
* [React Native](/grow/levelplay/sdk/react/mediation-networks.md)