# AppLovin 통합

> 레벨플레이 Android 연동을 위한 AppLovin SDK의 변경 사항을 트래킹하고, 어댑터 버전, 지원되는 SDK 버전, AppLovinSdkInitializationConfiguration API 같은 주요 업데이트를 자세히 설명합니다.

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

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

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

## 필수 조건##prerequisites

* 보상형 광고 광고, 인터스티셜 광고 또는 배너 광고를 애플리케이션 올바르게 연동했는지 확인합니다. 연동 지침은 다음 가이드를 참고하십시오.

  **Integration guides:**

  * [보상형 광고](/grow/levelplay/sdk/android/rewarded-ads-integration.md)
  * [인터스티셜 광고](/grow/levelplay/sdk/android/interstitial-integration.md)
  * [Banner](/grow/levelplay/sdk/android/banner-integration.md)

* Applovin SDK 12.4.3 이상의 어댑터 버전 4.3.43 이상을 사용하는 경우 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

### Android##android

레벨플레이 SDK는 Gradle 종속성과 매뉴얼 다운로드 메커니즘을 모두 지원합니다.

#### Gradle##gradle

1. 앱 모듈의 Gradle다음 Maven URL이 있는지 확인합니다.

   ```java
   repositories {
   	mavenCentral()
   }
   ```

2. 어댑터 Maven 이름을 앱 모듈의 Gradle추가합니다.
   ```java
   dependencies {
      implementation 'com.unity3d.ads-mediation:applovin-adapter:5.2.0'
      implementation 'com.applovin:applovin-sdk:13.5.1'
   }
   ```

#### 매뉴얼 다운로드##manual-download

1. **AppLovin 어댑터 다운로드** 빌드에 AppLovin 어댑터 및 SDK를 추가합니다. 최신 AppLovin 파일은 [여기](/grow/levelplay/sdk/android/mediation-networks.md)에서 찾을 수 있습니다. \*\*중요!\*\*AppLovin 어댑터에는 AppLovin SDK가 포함되어 있지 않습니다. AppLovin SDK를 직접 추가 **해야 합니다**.

2. 애드랩을 다운로드한 후 **AppLovinAdapter** SDK를 Android 프로젝트의 **libs** 폴더에 드롭합니다.\*\*\*\*

   ![Android 프로젝트의 libs 폴더에 AppLovin 어댑터를 놓습니다.](/api/media?file=/grow/media/images/AppLovin-integration-with-Supersonic-Mediation-04.png)

3. \*\*dependencies 섹션 아래 Gradle 빌드 파일에 다음을 추가해야 합니다.

   ```java
   dependencies {
      implementation 'com.unity3d.ads-mediation:applovin-adapter:5.2.0'
      implementation 'com.applovin:applovin-sdk:13.5.1'
   }
   ```

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

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

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

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

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

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

```xml
<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"/>
```

#### ProGuard 사용자 전용##for-proguard-users-only

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.**{ *; }
```

## 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의 연령 제한 설정은 AppLovin Android SDK 13.0.0, AppLovin Android 어댑터 4.3.47에서 지원되지 않습니다.

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

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

```java
LevelPlay.setMetaData("AppLovin_AgeRestrictedUser", "true");
```

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

```java
LevelPlay.setMetaData("AppLovin_AgeRestrictedUser", "false");
```

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

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

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

  ```java
  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)