InMobi 実装ガイド
このガイドでは、Unity LevelPlay で InMobi をアドネットワークとして配信するための設定方法を説明します。
Vungle iOS SDK v.6.8.0以降(Vungle アダプター 4.3.6 以降)は Xcode 12 以降をサポートします。 Xcode 11 以前でのビルドはサポートされていません。
ステップ 1. InMobi アカウントを作成する
ステップ 2. InMobi でアプリケーションとプレースメントを作成する
InMobi でアプリケーションを設定するには、次の手順に従ってください:
-
アプリケーションの作成
- ログインすると、「 Add inventory 」ボタンが表示されます:
AppStore または Google Play の URL を入力してください。 - アプリがまだ公開されていない場合は、「 Link manually? 」 を選択します。
この場合、アプリケーションの名前を手動で入力し、プラットフォームを選択します。 - 以下該当するオプションにチェックを入れます:
- アプリが 16 歳未満の子供を対象としている場合
- InMobi にデバイスの位置情報の使用を許可する場合 – 位置情報の許可
- 完了したら、「 Save and create placement 」をクリックします。
Note: ironSource アカウントの場合と同様に、プラットフォーム( iOS / Android )ごとに固有の InMobi アプリケーションが必要です。
- ログインすると、「 Add inventory 」ボタンが表示されます:
-
プレイスメントの作成
アプリケーションを作成したら、プレイスメントを作成する必要があります。プレイスメントは、InMobi が特定の広告タイプを配信する場所です。これは、ironSource SDK 動画リワードまたはインタースティシャルを表示するように設定したアプリ内での配置になります。
- プレイスメントを作成する広告ユニットを選択します:
- インタースティシャル
- 動画リワード
- バナー
- 広告ユニットを選択したら、「 Create placement 」ボタンをクリックします。
- 名前を設定し、プレイスメントの作成を完了します。
- プレイスメントを作成する広告ユニットを選択します:
ステップ 3. LevelPlay ネットワークモジュールで InMobi をアクティベートする
InMobi が LevelPlay と接続して正しく動作するためには、InMobi アカウントから 5 つのデータを LevelPlay 「 SDK Networks 」モジュールに入力する必要があります:
Username | これは、InMobi アカウントにログインするために使用するユーザー名で、アカウントの InMobi レポート API にアクセスするために必要です。これにより、Unity LevelPlay メディエーションが InMobi アカウントからパフォーマンスデータをインポートしてレポートと最適化に使用できるようになります。 |
Password | InMobi アカウントにログインするために使用するパスワードで、ユーザー名と共にアカウントのレポートデータにアクセスするために必要です。 |
API Key | レポートデータのリクエストを検証するためのユニークキーです。 |
Account ID | InMobi アカウントのユニーク ID です。 |
Placement ID | InMobi が広告を配信するプレイスメントです。 |
これらの情報を取得したら、LevelPlay で InMobi のパラメータを設定する必要があります。上記のパラメータを正しく追加すると、InMobi の広告在庫と Unity LevelPlay メディエーションのレポートデータを最大限に活用できるようになります。
-
Username
InMobi アカウントへのログインに使用するユーザ名
-
Password
InMobi アカウントへのログインに使用するパスワード
-
API Key
これは、レポートデータのリクエストを認証するためのユニークキーです。この情報は、管理パネルの右上隅にあるドロップダウン ➣ Account Settings ➣ API Key ➣「 Generate Key 」をクリックして取得します。
詳細については、こちらの InMobi サポートポータルページを参照してください。
-
Account ID
これは、InMobi アカウントのユニーク ID です。このパラメータを見つけるには、管理パネルの左上隅にある名前アイコンをクリックすると、「 Account ID 」がリストに表示されます:
-
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 アダプターをビルドに追加する
ironSource SDK は、CocoaPods と手動ダウンロードメカニズムの両方をサポートしています。
Cocoapods
InMobi アダプターと SDK を CocoaPods で実装するには、Podfile に次の行を入力します。
pod 'IronSourceInMobiAdapter','4.3.25.0'
手動ダウンロード
- InMobi アダプターをダウンロード:
InMobi アダプターと SDK をビルドに追加します。最新のアダプターはこちら。 - InMobi フレームワークをプロジェクトに追加:
アダプターと SDK ファイルをダウンロードした後、フレームワークファイルを Xcode プロジェクトにドロップします。例: ISInMobiAdapter.xcframework - 必要なFrameworkを追加:
Targets ➣ Build Phases ➣ Link Binary With Libraries へ移動し、「 + 」をクリックして以下のframeworkを追加します:libsqlite3.tbd libxml2.2.tbd
- Linker Flags:
次のリンカーフラグを Target ➣ Build Settings ➣ Linking ➣ Other Linker Flags に追加します:
-ObjC - App Transport Security (ATS) 設定
以下を info.plist へ追加します:<key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict>
ステップ 5. InMobi の追加設定
ユーザーレベルの年齢制限のあるユーザー
Unity LevelPlay メディエーションを使用すると、パブリッシャーは InMobi の「 IsAgeRestricted 」を InMobi ネットワークに直接設定できます。この機能は、ironSource SDK 7.2.1 以降、InMobi iOS アダプター 4.3.14 以降使用可能です。
InMobi の「 setIsAgeRestricted 」フラグにパラメータ「 True 」を設定するには、次の構文を使用します:
[IronSource setMetaDataWithKey:@"InMobi_AgeRestricted" value:@"YES"];
InMobi の「 setIsAgeRestricted 」フラグにパラメータ「 False 」を設定するには、次の構文を使用します:
[IronSource setMetaDataWithKey:@"InMobi_AgeRestricted" value:@"NO"];
- Integration Helper を使用して広告ネットワークの実装を確認できます。 ironSource SDK は、SDK とネットワークアダプターを正しく実装するためのツールを提供しています。
- この関数のブール値を使用して、実装されたメディエーションアドネットワークのデバッグログを管理します。
[IronSource setAdaptersDebug:YES];
「 YES 」に設定するとデバッグログが有効になり、デバッグ機能を許可しているすべてのメディエーションアドネットワークのトラブルシューティングに役立ちます。広告を実装したアプリを公開する前に、必ずこのコードを削除してください。この機能は、SDK バージョン 6.5.2 以降でサポートされています。
完了!
これで、Unity LevelPlay Mediation で InMobi 広告を配信する準備ができました。!
Unity LevelPlay でさらに他のアドネットワークを活用するには、アダプターを実装し、ガイドに従って設定してください。