Google Mobile Ads Unity プラグインを使用すると、Unity デベロッパーは Java や Objective-C のコードを記述しなくても、Android アプリや iOS アプリに Google モバイル広告を配信できます。このプラグインには、Unity プロジェクトの C# スクリプトで使用される、広告をリクエストするための C# インターフェースが用意されています。
このガイドは、Unity アプリを収益化したいパブリッシャーを対象としています。
前提条件
- Unity 2019.4 以降を使用する
- iOS にデプロイするには
- Xcode 15.3 以降
- iOS 12.0 以降を対象としている
- CocoaPods
- Android にデプロイするには
- Android API レベル 21 以上
- ターゲット Android API レベル 31 以降
Android API レベルは、[Project Settings] > [Player] > [Android] > [Other Settings] > [Other Settings] で設定します。
Mobile Ads for Unity プラグインをインポートする
OpenUPM CLI
OpenUPM CLI がインストールされている場合は、次のコマンドを使用して OpenUPM レジストリをインストールできます。
openupm add com.google.ads.mobile
.unitypackage
個のプラグイン アセットを削除します
.unitypackage
の使用から OpenUPM の使用に移行する場合は、古い場所からアセットを手動でアンインストールする必要があります。.unitypackage
からインポートした次のディレクトリを削除します。
- Assets/ExternalDependencyManager
- アセット/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
OpenUPM
- Unity のメニュー オプション [Edit] > [Project Settings] > [Package Manager] を選択して、パッケージ管理システムの設定を開きます。
OpenUPM をスコープ レジストリとして [Package Manager] ウィンドウに追加します。
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Unity メニュー オプション [Window] > [Package Manager] を選択して、パッケージ マネージャー メニューを開きます。
マネージャー スコープのプルダウンで [レジストリ] を選択します。
パッケージ リストから [Google Mobile Ads for Unity] パッケージを選択し、[インストール] をクリックします。
.unitypackage
個のプラグイン アセットを削除します
.unitypackage
の使用から OpenUPM の使用に移行する場合は、古い場所からアセットを手動でアンインストールする必要があります。.unitypackage
からインポートした次のディレクトリを削除します。
- Assets/ExternalDependencyManager
- アセット/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
GitHub からインポート
- GitHub から最新の
.unitypackage
リリースをダウンロードします。 .unitypackage
ファイルをインポートするには、Unity メニュー オプションで [Assets] > [Import package] > [Custom Package] を選択し、すべてのアイテムをインポートします。
外部依存関係を含める
Google Mobile Ads Unity プラグインは Unity Play 開発者サービス リゾルバ ライブラリとともに配布されます。このライブラリは、AAR や iOS CocoaPods などの Android 固有のライブラリにアクセスする必要がある Unity プラグインで使用することを前提としています。Unity プラグインには依存関係を宣言する機能があり、依存関係は自動的に解決されて Unity プロジェクトにコピーされます。
以下の手順に沿って、プロジェクトにすべての依存関係が含まれるようにします。
Android
[Project Settings] > [Player] > [Android] > [Publishing Settings] > [Build] に移動し、次のように選択します。
- カスタムのメイン Gradle テンプレート
- カスタム Gradle プロパティ テンプレート
Unity エディタで [Assets] > [External Dependency Manager] > [Android Resolver] > [Resolve] を選択すると、Unity External Dependency Manager ライブラリによって、宣言された依存関係が Unity アプリの Assets/Plugins/Android
ディレクトリにコピーされます。
iOS
Unity では CocoaPods を使用して依存関係を識別し、管理します。iOS の依存関係に関する具体的な要件やトラブルシューティングの手順については、CocoaPods のドキュメントをご覧ください。
Google Mobile Ads Unity プラグインの依存関係は Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
にリストされています。
アプリ ID の Ad Manager 設定
Unity エディタで、メニューから [Assets] > [Google Mobile Ads] > [Settings] を選択します。
Android と iOS の アド マネージャー アプリ ID を各フィールドに入力します。
SDK を初期化する
広告を読み込む前に、MobileAds.Initialize()
を呼び出して、アプリで Google Mobile Ads SDK を初期化します。この処理は 1 回だけ行います(アプリの起動時に行うのが理想的です)。
GameObject
に添付されたスクリプトの Start()
メソッド内で Initialize()
を呼び出す方法の例を次に示します。
...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize(initStatus => { });
}
}
メディエーションを使用している場合は、すべてのメディエーション アダプタが初期化されるように、コールバックが発生するまで待ってから広告を読み込みます。
広告フォーマットの選択
Android または iOS プラットフォームにデプロイするときに、Unity アプリに Google Mobile Ads SDK が含まれるようになりました。これで、広告を実装できるようになりました。AdMob にはさまざまな広告フォーマットが用意されており、ユーザー エクスペリエンスに最適なものを選択できます。
バナー
バナー広告ユニットには、アプリのレイアウトの一部を占める形で長方形の広告が表示されます。一定時間の経過後に自動更新される。つまり、ユーザーはアプリの同じ画面にとどまっている場合でも、新しい広告が定期的に表示されます。これは実装が最もシンプルな広告フォーマットでもあります。
インタースティシャル
インタースティシャル広告ユニットでは、アプリに全画面広告が表示されます。ゲームアプリのレベルクリア後など、アプリのインターフェースの自然な中断や遷移時に配置します。
ネイティブ
ネイティブ広告は、広告見出しや行動を促すフレーズなどのアセットをアプリに表示する方法をカスタマイズできる広告です。広告のスタイルをご自身で設定することで、自然で目立たない広告プレゼンテーションを作成して、豊かなユーザー エクスペリエンスを向上させることができます。
特典
リワード広告ユニットを使用すると、ユーザーはゲームをプレイしたり、アンケートに回答したり、動画を視聴したりして、コイン、追加ライフ、ポイントなどのアプリ内報酬を獲得できます。広告ユニットごとに異なる報酬を設定し、ユーザーが受け取る報酬の値とアイテムを指定できます。