# AppLovin インテグレーション

> LevelPlay Android インテグレーション向け AppLovin SDK の変更を追跡します。アダプタのバージョン、サポートされている SDK のバージョン、AppLovinSdkInitializationConfiguration API などのキー更新の詳細を確認できます。

> **Important:**
>
> 以下のドキュメントでは、Unity が開発、所有、または運用するものではない製品またはサービス ("サードパーティ製品") を取り上げます。
> その情報は、古かったり、不完全であったりする可能性がありますが、利便性のために提供しています。
> サードパーティ製品を使用する際は、その製品の規約に従うものとします。
> Unity はそれらの製品に関して一切保証を行わず、その使用によって生じた損害や損失 (サードパーティプロバイダーのコンテンツ、広告、製品、資料に関する問題を含む) について責任を負いません。

このガイドでは、Unity LevelPlay で AppLovin を広告ネットワークとして稼働させる方法についてステップバイステップで説明します。

> **Note:**
>
> このメディエーションネットワークのアダプタ変更ログを表示するには、[Android 向けメディエーションネットワーク](/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)
  * [バナー](/grow/levelplay/sdk/android/banner-integration.md)

* Applovin SDK 12.4.3 以降を使用している場合は、アダプターバージョン 4.3.43 以降で Android マニフェストから applovin.sdk. キーを削除するようにしてください。

## ステップ 1. AppLovin アカウントの作成

1. AppLovin でアカウントを作成します。[ここで](https://www.applovin.com/signup)行うことができます。
2. アカウントが確認されると、パートナー ログイン[はこちら](https://www.applovin.com/login)からログインできます。

## ステップ 2. AppLovin SDK とレポート キーの取得

AppLovin アカウントから 2 つのデータを LevelPlay ネットワーク設定モジュールに挿入する必要があります。これは、AppLovin を LevelPlay に接続して正しく動作させるためです。

* \*\*レポートキー:\*\*これは AppLovin アカウントの一意の識別子で、Unity LevelPlay は AppLovin アカウントからパフォーマンス データをインポートし、レポートと最適化に使用できます。
* \*\*SDK キー:\*\*これは AppLovin アカウントの一意の識別子です。これは、LevelPlay Mediation SDK がアプリケーションの AppLovin アダプターを初期化するために使用されます。

この情報を取得したら、LevelPlay アカウントで AppLovin パラメータを**設定**する必要があります上記の情報を正しく追加することで、LevelPlay の Mediation プラットフォームで AppLovin の広告インベントリとレポートデータを最大限に活用できるようになります。

1. ### レポート キー

   **レポートキー**を見つけるには、**アカウント**タブに移動し、左側のメニューから**キー**を選択します。

   ![アカウント設定の AppLovin レポート キーの場所](/api/media?file=/grow/media/images/SDK-Key-2.png)

2. ### SDK キー

   **SDK** **キー**を見つけるには、**アカウント**タブに移動し、左側のメニューから **Keys を**選択します。

   ![アカウント設定の AppLovin SDK キーの場所](/api/media?file=/grow/media/images/SDK-Key-1.png)

## ステップ 3. LevelPlay で AppLovin をアクティベートする

* LevelPlay アカウントにログインし、**LevelPlay のナビバー**> **設定**> **Networks** に移動します。

* **Manage Networks** ページの使用可能な広告ネットワークのリストから AppLovin を選択します。次に、広告ネットワーク設定ページでレポートキーを入力し、**Save (保存**) を選択します。

  ![LevelPlay での AppLovin レポートキーの入力](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.28.49.png)

* 次に、左側のナビゲーションバーから **Instances ページ**に移動します。**Instances ページ**の上部にある **AppLovin** で Unity LevelPlay の Mediation を実行するアプリケーションを選択します。

* 広告ネットワークの設定リストから Applovin を選択します。

  ![ネットワーク リストから AppLovin を選択](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.34.46.png)

* アプリケーション設定ページで、ステップ 2 で取得した SDK キーを挿入します。次に、Applovinで収益化したい広告形式(インタースティシャル広告、リワード広告、バナー)ごとにインスタンスを作成します。任意の広告形式を選択し、ページの下部にある**Add instance (インスタンス**の追加) を選択します。必要な情報を入力し、**Save (保存**) を選択します。

  ![AppLovin インスタンス設定の追加](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.35.49.png)

アプリケーションは AppLovin 広告ネットワークを通じて収益化されています。

## ステップ 4.  AppLovin Adapter をビルドに追加する##step-4.add-the-applovin-adapter-to-your-build

### Android##android

LevelPlay 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 Adapterのダウンロード** AppLovin AdapterとSDKをビルドに追加します。最新の AppLovin ファイル[はここ](/grow/levelplay/sdk/android/mediation-networks.md)にあります。**重要!**AppLovin Adapter には AppLovin SDK は含まれていません。AppLovin SDK を直接追加する**必要**があります。

2. **AppLovin Adapter をプロジェクト**に追加 アダプターをダウンロードしたら、**AppLovinAdapter** SDK を Android プロジェクトの **libs** フォルダーにドロップします。

   ![AppLovin アダプターを Android プロジェクトの libs フォルダーにドロップします。](/api/media?file=/grow/media/images/AppLovin-integration-with-Supersonic-Mediation-04.png)

3. Gradle ビルドファイルの **dependencies** セクションに以下の必ず追加してください。

   ```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|locale|orientation|screenLayout|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

AppLovin アダプタで ProGuard を使用している場合は、ProGuard 設定に以下のコードを追加する必要があります (Android Studio: proguard-rules.Pro または Eclipse: proguard-project.txt)。

```text
-keepattributes シグニチャ、InnerClasses、例外、注釈
-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 public class com.applovin.mediation.* { public protected *; }
-keep public class com.applovin.mediation.ads.* { public protected *; }
-keep public class com.applovin.impl.*.AppLovin { public protected *; }
-keep public class com.applovin.impl.**.*Impl { public protected *; }
-keepclassmembers クラス com.applovin.sdk.AppLovinSdkSettings { private java.util.マップ localSettings; }
-keep class com.applovin.mediation.adapters.** { *; }
-keep class com.applovin.mediation.adapter.**{ *; }
```

## ステップ 5.AppLovin の管理者でのリワード広告の設定

AppLovin アダプタをビルドに追加したら、AppLovin Admin でリワード広告機能を有効にする必要があります。

1. AppLovin Admin で、**Manage Apps** に移動し、設定するアプリケーションを選択します。

   ![AppLovin Manage Apps 画面](/api/media?file=/grow/media/images/apps.png)

2. **リワード広告**セクションまでスクロールし、以下のトグルを設定します。
   1. **頻度制限** - リワード広告頻度制限を設定しない
   2. **ゲーム内通貨詳細** - Unity LevelPlay メディエーションアダプタによって設定されるため、デフォルト値のままにしておくことができます。
   3. **ディスプレイ プレビデオ モーダル** - NO
   4. **ディスプレイ ポストビデオ モーダル** - NO
   5. **コールバック オプション**:クライアント側のコールバックのみ
      ![AppLovin Rewarded Video 設定](/api/media?file=/grow/media/images/apps-1.png)

3. 完了したら「**Save**」ヒット

## ステップ 6.AppLovin の追加設定##step-6.-applovin-additional-settings

### 年齢制限の設定##set-age-restriction

> **Note:**
>
> AppLovin の年齢制限設定は、AppLovin Android SDK 13.0.0、AppLovin Android Adapter 4.3.47 ではサポートされていません。

LevelPlay メディエーションプラットフォームを使用すると、パブリッシャーは AppLovin の年齢制限設定を AppLovin ネットワークに直接通知できます。この特徴は、LevelPlay SDK 6.17.0 以降、AppLovin Android Adapter 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)を使用して広告ネットワークのインテグレーションを確認します。LevelPlay SDK は、SDK と追加のネットワークアダプタを正常に統合するためのツールを提供します。
* このブーリアンを使用して統合メディエーション広告ネットワークのデバッグを管理する

  ```java
  LevelPlay.setAdaptersDebug(true);
  ```

  **true**に設定すると、このコード行でデバッグログが有効になり、すべてのメディエーション広告ネットワークに関する問題のトラブルシューティングに役立ちます。アプリケーションを広告ユニットで稼働させる前に、このコードを削除してください。 SDK バージョン 6.5.2 以降でサポートされます。

## 次のステップ##next-steps

Unity LevelPlay を通じて追加の広告ネットワークを活用するには、アダプタを統合し、インテグレーションガイドに従います。

**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 ネイティブ](/grow/levelplay/sdk/react/mediation-networks.md)