InMobi 実装ガイド

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

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

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

ステップ 2. InMobi でアプリケーションとプレースメントを作成する

InMobi でアプリケーションを設定するには、次の手順に従ってください：

1. アプリケーションの作成

   1. ログインすると、「 Add inventory 」ボタンが表示されます：
      
      AppStore または Google Play の URL を入力してください。
   2. アプリがまだ公開されていない場合は、「 Link manually? 」 を選択します。
      この場合、アプリケーションの名前を手動で入力し、プラットフォームを選択します。
   3. 以下該当するオプションにチェックを入れます：
      1. アプリが 16 歳未満の子供を対象としている場合
      2. InMobi にデバイスの位置情報の使用を許可する場合 – 位置情報の許可
         
   4. 完了したら、「 Save and create placement 」をクリックします。
      
      Note: ironSource アカウントの場合と同様に、プラットフォーム（ iOS / Android ）ごとに固有の InMobi アプリケーションが必要です。

2. プレイスメントの作成

   アプリケーションを作成したら、プレイスメントを作成する必要があります。プレイスメントは、InMobi が特定の広告タイプを配信する場所です。これは、ironSource SDK 動画リワードまたはインタースティシャルを表示するように設定したアプリ内での配置になります。

   1. プレイスメントを作成する広告ユニットを選択します：
      1. インタースティシャル
      2. 動画リワード
      3. バナー
   2. 広告ユニットを選択したら、「 Create placement 」ボタンをクリックします。
   3. 名前を設定し、プレイスメントの作成を完了します。

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

InMobi が LevelPlay と接続して正しく動作するためには、InMobi アカウントから 5 つのデータを LevelPlay 「 SDK Networks 」モジュールに入力する必要があります：

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

1. Username

   InMobi アカウントへのログインに使用するユーザ名

2. Password

   InMobi アカウントへのログインに使用するパスワード

3. API Key

   これは、レポートデータのリクエストを認証するためのユニークキーです。この情報は、管理パネルの右上隅にあるドロップダウン ➣ Account Settings ➣ API Key ➣「 Generate Key 」をクリックして取得します。
   

詳細については、こちらの InMobi サポートポータルページを参照してください。

1. Account ID

   これは、InMobi アカウントのユニーク ID です。このパラメータを見つけるには、管理パネルの左上隅にある名前アイコンをクリックすると、「 Account ID 」がリストに表示されます：

   

2. Placement ID

   アプリケーションの「 Placement ID 」を取得するには、左側のナビゲーション メニューから Inventory > inventory list を選択 ➣ アプリを選択 ➣ 広告ユニットを選択 ➣ プレースメントの名前を選択し、「 Placement ID 」をコピーします：
   

InMobi のパラメータを LevelPlay 上で設定する

上記のパラメータを取得したら、LevelPlay にログインします。

• Mediation ➣ Setup ➣ SDK Networks へ移動します。
• 「 Available Networks 」の表から InMobi を選択します。

• InMobi の Username、Password、API Key、Account ID を入力します。
  
• Unity LevelPlay メディエーションで InMobi を配信するアプリを選択します。
  
• 広告ネットワークの設定リストから「 InMobi 」を選択し、「 Setup 」ボタンまたは「編集」アイコンをクリックします。「 Rewarded Video 」、「 Interstitial 」 または「 Banner 」の設定で、Placement ID を入力して「 Save 」をクリックし、ステータスを「 Active 」に設定します。
  
• 設定ダッシュボードに、InMobi がアクティブであることが表示されます。
• Reporting API の連携確認：Reporting API を通じて連携がチェックされ、「 Verified 」、「 Failed 」、「 No Response 」のうち、いずれかの応答が返されます。「 Verified 」が表示されない場合は、実装と入力した情報を再確認し、「 Verified 」が表示されるまで「 Retry 」をクリックします。

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

Unity Network Manager（推奨）

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

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

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

Android (Manual Resolve)

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

Proguard ユーザーのみ (Android)

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

-keepattributes SourceFile,LineNumberTable
-keep class com.inmobi.** { *; }
-dontwarn com.inmobi.**
-keep public class com.google.android.gms.**
-dontwarn com.google.android.gms.**
-dontwarn com.squareup.picasso.**
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient{
     public *;
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info{
     public *;
}
# skip the Picasso library classes
-keep class com.squareup.picasso.** {*;}
-dontwarn com.squareup.picasso.**
-dontwarn com.squareup.okhttp.**
# skip Moat classes
-keep class com.moat.** {*;}
-dontwarn com.moat.**
# skip AVID classes
-keep class com.integralads.avid.library.* {*;}

Android プラグイン手動実装

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

   implementation 'com.ironsource.adapters:inmobiadapter:4.3.27' 
   implementation 'com.inmobi.monetization:inmobi-ads-kotlin:10.7.8' 
   

4. InMobi Manifest を追加する – JAR 実装の場合のみ
   InMobi アダプターは AAR としてリリースされています。 JAR での実装を使用する場合のみ、InMobi の Android ドキュメントに従ってマニフェストを追加してください。

iOS

InMobi SDK 10.7.2以降、アダプターバージョン4.3.28以降の実装
InMobi XCFrameworkは 「Embed & Sign 」 が必要です。

Unityプロジェクトの Assets/LevelPlay/Editor に Post-Process スクリプトを追加します。
スクリプトはこちらからダウンロードできます。

iOS プラグイン手動実装

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

ステップ 5. InMobi の追加設定

ユーザーレベルの年齢制限のあるユーザー

Unity LevelPlay メディエーションを使用すると、パブリッシャーは InMobi の「 IsAgeRestricted 」を InMobi ネットワークに直接設定できます。この機能は、ironSource SDK 7.2.1 以降、InMobi Android/iOS アダプター 4.3.14 以降使用可能です。

InMobi の「 setIsAgeRestricted 」フラグにパラメータ「 True 」を設定するには、次の構文を使用します：

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

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

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

完了！
これで、Unity LevelPlay Mediation で InMobi 広告を配信する準備ができました。!