使ってみる

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

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

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

前提条件

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

Android API レベルは、[Project Settings] > [Player] > [Android] > [Other Settings] > [Other Settings] で設定します。

Unity 向け Mobile Ads プラグインをインポートする

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

  1. Unity のメニュー オプションで [Edit] > [Project Settings] > [Package Manager] を選択して、パッケージ マネージャーの設定を開きます。

  2. OpenUPM をスコープ付きレジストリとして [Package Manager] ウィンドウに追加します。

    Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google

  3. Unity のメニュー オプションで [Window] > [Package Manager] を選択して、パッケージ マネージャーのメニューを開きます。

  4. マネージャー スコープのプルダウンで [My Registries] を選択します。

  5. パッケージ リストから [Google Mobile Ads for Unity] パッケージを選択し、[Install] を押します。

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

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

外部依存関係を含める

Google Mobile Ads Unity プラグインは、Unity Play Services Resolver ライブラリとともに配布されます。このライブラリは、Android 固有のライブラリ（AAR など）または iOS CocoaPods にアクセスする必要がある 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] > [Resolve] を選択すると、Unity External Dependency Manager ライブラリにより、宣言された依存関係が Unity アプリの Assets/Plugins/Android ディレクトリにコピーされます。

iOS

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

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

アド マネージャー アプリ ID を設定する

Unity エディタのメニューで [Assets] > [Google Mobile Ads] > [Settings] を選択します。

Android と iOS の アド マネージャー アプリ 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 ではさまざまな広告フォーマットが用意されており、ユーザー エクスペリエンスに最適なものを選択できます。

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

バナー広告を実装する

インタースティシャル

インタースティシャル広告ユニットでは、アプリに全画面広告が表示されます。この広告ユニットは、アプリの流れが自然に途切れるタイミングや画面の切り替え時（ゲームアプリでレベルをクリアした後など）に配置します。

インタースティシャル広告を実装する

ネイティブ

ネイティブ広告では、広告見出しや行動を促すフレーズなどのアセットをアプリに表示する方法を自由にカスタマイズできます。広告のスタイルを自分で設定することで、コンテンツの邪魔にならないように広告を表示でき、ユーザー エクスペリエンスの向上につながります。

ネイティブ広告を実装する

リワード

リワード広告ユニットを使用すると、ゲームをプレイしたり、アンケートに答えたり、動画を視聴したりしたユーザーに報酬として、コイン、追加ライフ、ポイントなどのアプリ内アイテムを進呈できます。広告ユニットごとに異なる報酬を設定し、報酬の値やユーザーが受け取るアイテムを指定できます。

リワード広告を実装する