i-mobile をメディエーションと統合する

このガイドでは、Google Mobile Ads Unity Pluginを使用してメディエーションで i-mobile の広告を読み込んで表示する方法とウォーターフォール統合について説明します。また、広告ユニットのメディエーション設定に i-mobile を追加する方法と、i-mobile SDK とアダプタを Unity アプリに統合する方法についても取り上げます。

i-mobile のダッシュボードインターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンに対して日本語表記の後に括弧で英語表記を併記しています。

サポートされている統合と広告フォーマット

i-mobile 用の AdMob メディエーションアダプタには、次の機能があります。

統合
入札
ウォーターフォール
フォーマット
バナー
インタースティシャル
特典

要件

最新の Google Mobile Ads Unity Plugin
Unity 5.6 以降
Android にデプロイする場合
- Android API レベル 23 以降
iOS にデプロイする場合
- iOS のデプロイ対象のバージョンが 13.0 以降であること
Google Mobile Ads Unity Plugin で構成された Unity プロジェクトが動作していること。詳しくは、設定するGoogle Mobile Ads Unity Pluginをご覧ください。
AdMob メディエーションを設定する。

ステップ 1: i-mobile の管理画面で設定を行う

登録またはログインして i-mobile アカウントにアクセスします。

[サイト／アプリ管理] タブをクリックし、アプリのプラットフォームのボタンをクリックして、アプリを i-mobile ダッシュボードに追加します。

Android

iOS

フォームに記入し、[新規登録] ボタンをクリックします。

Android

iOS

新しい広告枠を作成するには、[サイト／アプリ管理] Tab でアプリを選択します。

Android

iOS

[広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。

create_ad_spot

次に、広告スポット名、広告スポットサイズなどの詳細を入力してフォームに記入します。[新規登録] ボタンをクリックします。

new_ad_spot_form

新しい広告スポット が準備できました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。

ad_spot_list

パブリッシャー ID、メディア ID、およびスポット ID をメモしておきます。これらのパラメータは、後で AdMob の管理画面でメディエーション用に i-mobile を設定するときに必要になります。

Android

iOS

app-ads.txt を更新する

アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、アプリの app-ads.txt ファイルを設定します。

i-mobile 用に app-ads.txt を実装するには、よくある質問をご覧ください。

ステップ 2: AdMob の管理画面で i-mobile のデマンドを設定する

広告ユニットのメディエーション設定を構成する

Android

手順については、 Android向けガイドのステップ 2 をご覧ください。

iOS

ステップ 3: i-mobile SDK とアダプタをインポートする

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルートディレクトリから次のコマンドを実行して、Google Mobile Ads i-mobile Mediation Plugin for Unity をプロジェクトにインストールできます。

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

Unity プロジェクトエディタで、[Edit]（編集）> [Project Settings]（プロジェクト設定）> [Package Manager]（パッケージマネージャー）を選択して、 [Unity Package Manager Settings]（Unity Package Manager の設定）を開きます。

[Scoped Registries]（スコープ付きレジストリ）タブで、次の詳細情報を使用して OpenUPM をスコープ付きレジストリとして追加します。

名前: OpenUPM
URL: https://package.openupm.com
スコープ: com.google

OpenUPM の詳細

次に、[Window] > [Package Manager] に移動して [Unity Package Manager] を開き、 [My Registries] をプルダウンメニューから選択します。

Unity レジストリ

[Google Mobile Ads IMobile Mediation] パッケージを選択し、[Install]（インストール）をクリックします。

OpenUPM からインストールする

Unity パッケージ

変更履歴のダウンロードリンクから i-mobile 用の Google Mobile Ads メディエーションプラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsIMobileMediation.unitypackageを抽出します。

Unity プロジェクトエディタで、[Assets]（アセット）> [Import Package]（インポートパッケージ）> [Custom Package]（カスタムパッケージ）を選択し、ダウンロードした GoogleMobileAdsIMobileMediation.unitypackage ファイルを探します。すべてのファイルのチェックボックスがオンになっていることを確認して、[Import]（インポート）をクリックします。

Unity からインポートする

次に、[Assets]（アセット）> [External Dependency Manager]（外部依存関係マネージャー）> [Android Resolver]（Android リゾルバー）> [Force Resolve]（強制解決）を選択します。External Dependency Manager ライブラリにより、依存関係の解決が最初から実行され、宣言された依存関係が Unity アプリの Assets/Plugins/Android ディレクトリにコピーされます。

Force Resolve

ステップ 4: 追加のコードが必要

Android

i-mobile の統合には追加のコードは必要ありません。

iOS

SKAdNetwork の統合

i-mobile のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。

ステップ 5: 実装をテストする

テスト広告を有効にする

テストデバイスを AdMob に登録していることを確認します。i-mobile では、テスト用のスポット ID 、メディア ID、およびパブリッシャー ID を提供しています。こちらで確認できます。

テスト広告を確認する

i-mobile からテスト広告を受信していることを確認するには、 i-mobile（ウォーターフォール） の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

エラーコード

アダプタが i-mobile から広告を受け取れない場合は、次のクラスの ResponseInfo を使用して、広告レスポンスからエラーの詳細を確認できます。

Android

形式	クラス名
バナー	com.google.ads.mediation.imobile.IMobileAdapter
インタースティシャル	com.google.ads.mediation.imobile.IMobileAdapter
ネイティブ	com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

形式	クラス名
バナー	IMobileAdapter
インタースティシャル	IMobileAdapter
ネイティブ	GADMediationAdapterIMobile

広告の読み込みに失敗した場合に i-mobile アダプタがスローするコードとメッセージは次のとおりです。

Android

エラーコード	理由
0-99	i-mobile SDK がエラーを返しました。詳しくは、コードをご覧ください。
101	i-mobile では、広告を読み込むために `Activity` コンテキストが必要です。
102	AdMob の管理画面で構成された i-mobile サーバーパラメータが存在しないか、無効です。
103	リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。
104	i-mobile のネイティブ広告の読み込み成功コールバックから、空のネイティブ広告リストが返されました。

iOS

エラーコード	理由
0-10	i-mobile SDK がエラーを返しました。詳しくは、コードをご覧ください。
101	AdMob の管理画面で構成された i-mobile サーバーパラメータが存在しないか、無効です。
102	リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。
103	i-mobile で広告を表示できませんでした。
104	i-mobile から空のネイティブ広告配列が返されました。
105	i-mobile でネイティブ広告アセットをダウンロードできませんでした。
106	i-mobile では、同じスポット ID を使用して複数のインタースティシャル広告をリクエストすることはできません。