AdMob のプロダクトに関して意見交換やフィードバックを行うには、広告と測定に関する Google コミュニティサーバーの公式 AdMob Discord チャネルにご参加ください。

使ってみる

プラットフォームを選択: Android iOS Unity Flutter

Google Mobile Ads Unity プラグインを使うと、Unity デベロッパーは、Java や Objective-C コードを記述することなく、Android と iOS アプリで Google モバイル広告を配信できます。このプラグインにより、Unity プロジェクトの C# スクリプトで使用される、広告をリクエストするための C# インターフェースが利用可能になります。

このガイドは、Unity アプリの収益化をお望みのパブリッシャー様を対象にしています。

前提条件

Unity Editor 2019.4 以降を使用していること
iOS にデプロイする場合
- Xcode 16.0 以降
- iOS 12.0 以降をターゲットとしていること
- CocoaPods
Android にデプロイする場合:
- 最小 Android API レベル 23 以上
- Android API レベル 34 以上をターゲットとしていること

推奨: AdMob アカウントを作成し、Android または iOS アプリを登録していること

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] を選択して、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]（ビルド）に移動し、以下を選択します。

Custom Main Gradle Template
Custom Gradle Properties Template

Unity エディタで、[Assets]（アセット）> [External Dependency Manager] > [Android Resolver]（Android リゾルバ）> [Resolve]（解決）を選択すると、Unity External Dependency Manager ライブラリにより、宣言された依存関係が Unity アプリの Assets/Plugins/Android ディレクトリにコピーされます。

iOS

iOS 用 Unity は、CocoaPods を使用して依存関係を特定し、管理します。iOS の依存関係に関する特定の要件やトラブルシューティングの手順については、CocoaPods のドキュメントをご覧ください。

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

AdMob アプリケーション ID を設定する

Unity エディタで、メニューから [Assets]（アセット）> [Google Mobile Ads] > [Settings]（設定）を選択します。

各フィールドに Android と iOS の AdMob アプリケーション ID を入力します。

SDK を初期化する

広告を読み込む前に MobileAds.Initialize() を呼び出して、アプリで Google Mobile Ads SDK を初期化します。この処理は 1 回だけ行います（アプリの起動時に行うのが理想的です）。

MobileAds.Initialize() を呼び出す方法の例を次に示します。

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});GoogleMobileAdsController.cs

メディエーションを使用している場合は、すべてのメディエーションアダプターを確実に初期化できるよう、広告の読み込みはコールバックが発生してから行います。

広告フォーマットを選択する

これで、Android または iOS プラットフォームへの Unity アプリのデプロイ時に Google Mobile Ads SDK が含まれるようになり、広告を実装する準備が整いました。AdMob ではさまざまな広告フォーマットが用意されており、ユーザーエクスペリエンスに最適なものを選択できます。