AppLovin 実装ガイド

このガイドでは、Unity LevelPlay で AppLovin をアドネットワークとして配信するための設定方法を説明します。

ステップ 1. AppLovin アカウントを作成する

1. AppLovin のウェブサイトでアカウントを作成します。
2. アカウントが認証されると、こちらからログインできるようになります。

ステップ 2. AppLovin SDK とレポートキーを取得する

AppLovin が ironSource と接続して正しく動作するには、AppLovin アカウントから2つのデータを LevelPlay ネットワークセットアップモジュールに設定する必要があります：

• Report Key：これは AppLovin アカウントのユニークな識別子であり、Unity LevelPlay が AppLovin アカウントからパフォーマンスデータをインポートしてレポート表示およびパフォーマンス最適化に使用できるようにします。
• SDK Key：アプリの AppLovin アダプターを初期化するために ironSource Mediation SDK によって使用される AppLovin アカウントのユニークな識別子です。

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

1. Report Key

   「 Report Key 」を見つけるには、「 Account 」タブに移動し、左側のメニューから「 Keys 」を選択します。
   

2. SDK Key

   「 SDK Key 」を見つけるには、「 Report Key 」同様に「 Account 」タブに移動し、左側のメニューから「 Keys 」を選択します。
   

ステップ 3. LevelPlay ネットワークモジュールで AppLovin をアクティベートする

AppLovin のパラメータを LevelPlay アカウントに設定する

• 両方のキーを取得したら、LevelPlay にログインし、Mediation ➣ Setup 」➣ SDK Networks へ移動します。
  
• 「 Available Networks 」の表から AppLovin を選択し、AppLovin の「 Report Key 」を入力します。
  
• 広告ネットワークの設定リストから「 AppLovin 」を選択し、「 Setup 」ボタンまたは「編集」アイコンをクリックします。
  
• AppLovin の「 SDK Key 」を入力します。ステータスを「 Active 」に設定し、「 Save 」をクリックします。
  
• これで、設定ダッシュボード上で AppLovin がメディエーションに対して Active であることが確認できます。
  
• Reporting API の連携確認：Reporting API を通じて連携がチェックされ、 Verified 、 Failed 、 No Response のうち、いずれかの応答が返されます。 Verified が表示されない場合は、実装と入力した情報を再確認し、 Verified が表示されるまで Retry をクリックします。

ステップ 4. AppLovin アダプターをビルドに追加する

LevelPlay Network Manager（推奨）

SDK の実装が完了すると、LevelPlay Network Manager を使用して AppLovin アダプターをダウンロードできます。

Unity 開発プラットフォームで、Ads Mediation > Network Manager へ移動します。

すでに最新バージョンのアダプターが実装されている場合は、アクションボタンが「 Updated 」に変更され、無効になります。

Android (Manual Resolve)

変更を適用するには、必ず「 Resolve 」プロセスを使用してください。これにより、選択されたネットワークに関連するすべてのアーティファクトがダウンロードされます。詳細については、こちらの手順を参照してください。

iOS
AppLovin SDK 12.4.1 以降、アダプター バージョン 4.3.48 以降では、AppLovin XCFramework に対して「Embed & Sign」を実行する必要があります。

Post-Process スクリプトを以下の関連するフォルダに追加してください：

• SDK Version 8.0.0 以降：Assets/LevelPlay/Editor
• SDK Version 8.0.0 以前：Assets/IronSource/Editor

スクリプトはこちらでダウンロード出来ます。

ProGuard ユーザーのみ (Android)

AppLovin アダプターで ProGuard を使用している場合は、次のコードを ProGuard 設定ファイルに追加する必要があります（Android Studio: proguard-rules.pro または Eclipse: proguard-project.txt）：

-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 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 class com.applovin.sdk.AppLovinSdkSettings { private java.util.Map localSettings; }
-keep class com.applovin.mediation.adapters.** { *; }
-keep class com.applovin.mediation.adapter.**{ *; }

Android プラグイン手動実装

1. AppLovin アダプターをダウンロード：
   こちらからアダプターと AppLovin SDK (AAR) をダウンロードします。
2. AppLovin ファイルを Unity プロジェクトに追加：
   アダプターファイルを Assets/Plugins/Android. にインポートします。

AndroidManifest.xml を更新

AppLovin Android アダプターバージョン 4.3.13 (Android SDK バージョン 6.17.0) 以降、AppLovin アダプターは AAR としてリリースされています。 Jar での実装を継続する場合のみ、以下をマニフェストへ追加してください。

Manifest Permissions
次のパーミッションを <application> タグの外側に追加します：

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

Manifest Activities
マニフェストの <application> タグ内に次のアクティビティを追加します：

 <!-- 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|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"/>

iOS プラグイン手動実装

1. AppLovin アダプターと SDK ファイルをダウンロード：
   こちらからAppLovin アダプターと SDK をダウンロードします。
2. AppLovin アダプターファイルを Unity プロジェクトに追加：
   アダプターファイルを Assets/Plugins/iOS にインポートします。
3. SDK を Xcode プロジェクトに追加：
   Unity3D は XCFrameworks をサポートしていないため、SDK の XCFrameworks を Xcode プロジェクトに直接追加してください。

ステップ 5. Applovin の管理画面で動画リワードを設定する

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

1. AppLovin Admin で、「 Manage Apps 」へ移動し、設定したい特定のアプリを選択します：
   
2. 「 Rewarded Video 」セクションまで下にスクロールし、次の設定をします：
   1. Frequency Capping – Do not frequency cap Rewarded Videos
   2. Virtual Currency Details – Unity LevelPlay メディエーションアダプターが設定するため、デフォルト値のままで問題ありません。
   3. Display Pre-Video Modal – NO
   4. Display Post-Video Modal – NO
   5. Callback Options – Client-side callbacks only
      
3. 設定後、「 Save 」をクリックします。

年齢制限を設定する

ironSource のメディエーションプラットフォームを使用すると、パブリッシャーは AppLovin の年齢制限設定を AppLovin ネットワークに直接伝達できます。この機能は、ironSource SDK 6.17.1、AppLovin Android Unity アダプター 4.3.18 以降で使用可能です。

次の構文を使用して、「 AppLovin setIsAgeRestrictedUser 」にパラメーター「 True 」を設定します：

 IronSource.Agent.setMetaData("AppLovin_AgeRestrictedUser","true");

「 AppLovin setIsAgeRestrictedUse 」にパラメータ「 False 」を設定するには、次の構文を使用します：

 IronSource.Agent.setMetaData("AppLovin_AgeRestrictedUser","false");

年齢制限設定の詳細については、AppLovin ネットワークのこちらのページで確認してください。

完了！
これで、アプリで AppLovin 広告を配信する準備が完了しました。