Google Mobile Ads Unity プラグインを使うと、Unity デベロッパーは Java や Objective-C コードを記述することなく Android と iOS アプリで Google モバイル広告を配信できます。「 プラグインは、広告をリクエストするための C# インターフェースを提供します。このインターフェースは、 作成する必要があります。
このガイドは、Unity アプリの収益化をお望みのパブリッシャー様を対象にしています。
前提条件
- Unity 2019.4 以降を使用します
- iOS にデプロイする場合
<ph type="x-smartling-placeholder">
- </ph>
- 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 レジストリを以下のコマンドでインストールできます。 command:
openupm add com.google.ads.mobile
.unitypackage
個のプラグイン アセットを削除します
.unitypackage
から OpenUPM に移行する場合は、古い場所からアセットを手動でアンインストールする必要があります。削除
.unitypackage
からインポートされた次のディレクトリ:
- Assets/ExternalDependencyManager
- Assets/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] を選択して、Package Manager メニューを開きます。
マネージャー スコープのプルダウンで [My Registries] を選択します。
パッケージ リストから [Google Mobile Ads for Unity] パッケージを選択します。 [インストール] をクリックします。
.unitypackage
個のプラグイン アセットを削除します
.unitypackage
から OpenUPM に移行する場合は、古い場所からアセットを手動でアンインストールする必要があります。削除
.unitypackage
からインポートされた次のディレクトリ:
- Assets/ExternalDependencyManager
- Assets/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
GitHub からインポート
- 最新の
.unitypackage
をダウンロードする GitHub からリリースされます。 - [Unity] メニュー オプションを選択して
.unitypackage
ファイルをインポートする アセット >パッケージをインポート >カスタムパッケージ] を選択し、すべてのアイテムをインポートします。
外部依存関係を含める
Google Mobile Ads Unity プラグインは、Unity Play Services Resolver ライブラリとともに配布されます。このライブラリ Android 固有の API へのアクセスを必要とするすべての Unity プラグインで使用することを想定しています。 ライブラリ(AAR、iOS CocoaPods など)これにより、Unity プラグインに 依存関係を宣言してから自動的に解決され、 作成する必要があります。
プロジェクトにすべての依存関係が含まれていることを確認する手順は次のとおりです。
Android
[Project Settings] > [Player] > [Android] > [Publishing Settings] > [Build] に移動し、以下を選択します。
- カスタム メイン Gradle テンプレート
- カスタム Gradle プロパティ テンプレート
Unity Editor で、[Assets](アセット)> [External Dependency Manager](外部依存マネージャー)> [Android Resolver](Android リゾルバ)> [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 モバイル広告 >設定 を選択します。
Android または iOS デバイスを入力してください アド マネージャー アプリ ID 指定する必要があります
SDK の初期化
広告を読み込む前に、次の方法でアプリで Google Mobile Ads SDK を初期化します。
MobileAds.Initialize()
を呼び出しています。この処理は一度だけ行う必要があります。
表示されます。
Start()
メソッド内で Initialize()
を呼び出す方法の例を次に示します。
GameObject
:
...
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 では、ユーザー エクスペリエンスを最大限に高めることができる広告フォーマットを選択できます。
バナー
バナー広告ユニットには、アプリのレイアウト内の一部分を使用する長方形の広告が表示されます。設定した時間が経過すると自動的に更新されます。そのため、アプリで同じ画面を表示していてもユーザーには定期的に新しい広告が表示されます。また、バナー広告ユニットは最も簡単に実装できる広告フォーマットでもあります。
インタースティシャル
インタースティシャル広告ユニットでは、アプリに全画面広告が表示されます。自然な位置に配置する アプリのインターフェースでの中断や遷移(レベルクリア後など) ゲームアプリで利用できます。
ネイティブ
ネイティブ広告は、広告見出しや行動を促すフレーズなどのアセットをアプリに表示する方法をカスタマイズできる広告です。広告のスタイルを自分で設定することで、自然かつコンテンツの邪魔にならないように広告を表示し、ユーザー エクスペリエンスを向上させることができます。
特典
リワード広告ユニットを使用すると、ゲームをプレイしたり、アンケートに答えたり、動画を視聴したりしたユーザーに報酬として、コイン、追加ライフ、ポイントなどのアプリ内アイテムを進呈できます。広告ユニットごとに異なる報酬を設定し、ユーザーが受け取る報酬の価値やアイテムを指定できます。