このページは Cloud Translation API によって翻訳されました。

始める

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 レベル 34 以降

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
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 パッケージを選択し、[Install] を押します。

`.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 からインポート

GitHub から最新の .unitypackage リリースをダウンロードします。
Unity メニューオプションの [Assets] > [Import Package] > [Custom Package] を選択し、すべてのアイテムをインポートして、.unitypackage ファイルをインポートします。

外部依存関係を含める

Google Mobile Ads Unity プラグインは、Unity Play Services Resolver ライブラリとともに配布されます。このライブラリは、Android 固有のライブラリ（AAR など）または iOS CocoaPod にアクセスする必要がある Unity プラグインで使用するためのものです。これにより Unity プラグインは依存関係を宣言する機能を持つようになります。依存関係は自動的に解決され、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 for iOS は CocoaPods を使用して依存関係を特定して管理します。iOS の依存関係に関連する具体的な要件やトラブルシューティングの手順については、CocoaPods のドキュメントをご覧ください。

Google Mobile Ads Unity プラグインの依存関係は、Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml に記載されています。

Ad Manager アプリ ID を設定する

Unity Editor で、メニューから [Assets]（アセット）> [Google Mobile Ads]（Google モバイル広告）> [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 では、ユーザーエクスペリエンスに最適なものを選択できます。

バナー広告ユニットには、アプリのレイアウト内の一部分を使用する長方形の広告が表示されます。設定した時間が経過すると自動的に更新されます。そのため、アプリで同じ画面を表示していてもユーザーには定期的に新しい広告が表示されます。また、バナー広告ユニットは最も簡単に実装できる広告フォーマットでもあります。

バナー広告を実装する