Google Mobile Ads Unity Plugin の更新 Vol.2 (2023年11月版)前編

こんにちは。ちでソフトです。
本記事では、Google Mobile Ads Unity プラグイン の更新作業について紹介しています。
前回( vol.1 )の内容が一部古くなったこともあり、新たに記事を公開させていただきました。

なお、本記事は前編・後編に分かれています。

前回の記事をふり返って

繰り返しますが、今回のGoogle Mobile Ads Unityプラグイン（以下 Google Mobile Ads ) 更新作業は、前回の記事の続きとしてバージョン7.0.1 から 8.6.0 (記事執筆時の最新バージョン） へのものとなります。
バージョン7.0.1よりも古いバージョンをご利用されている方は、アンインストールに際しましては前回の更新作業（バージョン5.4.0を扱っています）が参考になる可能性もあります。

前回の記事で扱ったバージョン7系には、かなり苦しめられた経験があります。当時の最新版の導入は断念せざるを得なく、将来に期待をかけた記事内容になっていましたが、今のバージョン8系に至ってようやく改善の兆しが見えた感があります。
また、古いコードが載っていたままだった公式ガイドも、ここひと月で幾度も更新され、実装の参考になりやすくなっているようです。
もはや当方が記事にして紹介する必要もないかと一度はためらいましたが、注意点やつまづきポイントに遭遇しましたので、補足のつもりで記事にしてみました。

なお、当サイトに掲載された内容によって生じた損害等の一切の責任を負いかねますのでご了承ください。

事前準備

本記事は更新作業を目的としているため、すでに Google Mobile Adsを導入されたことがある方を主に対象としているのですが、はじめて Google Mobile Ads を導入するという方もいらっしゃるでしょうから、その方々は公式ガイド等の情報を確認して、以上の準備をしておいてくださいね。
また、アプリがまだGoogle AdMobにおいて承認されていない段階でも、テストIDを使用してテスト広告を表示してみることは可能となっています。

古いGoogle Mobile Ads Unity プラグインのアンインストール（Version 7.0.1のケース）

さっそく、落とし穴が・・・

まず、一番最初のつまづきポイントがここになるかと思います。
最新のGoogle Mobile Ads Unity プラグインを既存のを上書きする形でインポートした後に、このダイアログが表示されたのですが、「古いファイルを削除しますか？（ Would you like to delete the following obsolete files in your project ? ）」との文言を、まずは何も疑わずに試しに実行してみた結果、それまでテスト広告を表示できていた最新のプラグイン付属のサンプルデータが実行できなくなってしまったわけです（このダイアログの表示には若干タイムラグが発生するケースがあります）。

そもそも、上書きインポート自体も早急にやるのではなく、既存ファイルの調査が必要かもしれません。

1) 「Unityエディタ」を起動する。

2) 「Assets」フォルダに格納されている３つのフォルダ
①「Plugins」
②「ExternalDependencyManager」＆「GoogleMobileAds」（複数選択）を
この順番（①→②）で削除する。

新しいGoogle Mobile Adsのインストール

1 ) 以下のURL(GitHub)より GoogleMobileAds-v8.6.0.unitypackage をダウンロードします。
※この記事を執筆している時点での最新バージョンのURLです。
https://github.com/googleads/googleads-mobile-unity/releases/tag/v8.6.0

2) Unityエディターの上部メニューより【 Assets 】→【 Import Package 】→【 Custom Package 】の順にクリックして、ダウンロードしたプラグインを指定する。

3)  【 Import 】をクリックしてすべてのファイルをインポートする。
「ExternalDependencyManager」等が再度導入されます。

4) Androidのプロジェクトの場合は、Unityエディターの上部メニューより【Edit】→【Project Settings】→【Player】→【Publishing Settings】→「Build」より以下を選択します。

・「Custom Main Gradle Template」
・「Custom Gradle Properties Template」

5) Unityエディターの上部メニューより【 Assets 】→【 External Dependency Manager 】→【 Android Resolver 】→【 Resolve 】の順にクリック。

6 ) 【OK】をクリック

7 )   【 Assets 】→【 Google Mobile Ads 】→【 Settings 】の順にクリック。

8 )   各フィールドに Android と iOS の AdMob アプリ ID を再入力します。

以上

スクリプトの編集

一部濁した表現をしている箇所があるはずですが、できる限りの情報は共有させていただくつもりなので、ご勘弁くださいませ。

SDKを初期化する

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => {
        	// 初期化が済んでから行われる処理をここに記述します。
         });
    }
}

バナー広告

...
using GoogleMobileAds.Api;
...

public class Banner : MonoBehaviour
{
    #if UNITY_ANDROID
        private const string _adUnitId = "ca-app-pub-3940256099942544/6300978111";//テスト用のユニットID
    #elif UNITY_IPHONE
        private const string _adUnitId = "ca-app-pub-3940256099942544/2934735716";//テスト用のユニットID
    #else
        private const string _adUnitId = "unused";
    #endif

    private BannerView _bannerView;

    // Start is called before the first frame update
    void Start()
    {

    }

    // Update is called once per frame
    void Update()
    {
        
    }

    /// <summary>
    /// Creates a 320x50 banner at top of the screen.
    /// </summary>
    public void CreateBannerView()
    {
        Debug.Log("Creating banner view.");

        // If we already have a banner, destroy the old one.
        if (_bannerView != null)
        {
            DestroyAd();
        }

        // Create a 320x50 banner at top of the screen. -------※①
        _bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Top);

        // Listen to events the banner may raise.
        // バナービューイベントをリッスンします。-------※②
        ListenToAdEvents();

        Debug.Log("Banner view created.");
    }

    /// <summary>
    /// Creates the banner view and loads a banner ad.
    /// </summary>
    public void LoadAd()
    {
        // Create an instance of a banner view first.
        if (_bannerView == null)
        {
            CreateBannerView();
        }

        // Create our request used to load the ad.
        var adRequest = new AdRequest();

        // Send the request to load the ad.
        Debug.Log("Loading banner ad.");
        _bannerView.LoadAd(adRequest);
    }

    /// <summary>
    /// Destroys the ad.
    /// When you are finished with a BannerView, make sure to call
    /// the Destroy() method before dropping your reference to it.
    /// </summary>
    public void DestroyAd()
    {
        if (_bannerView != null)
        {
            Debug.Log("Destroying banner view.");
            _bannerView.Destroy();
            _bannerView = null;
        }

    }
    /// <summary>
    /// Listen to events the banner may raise.
    /// </summary>
    private void ListenToAdEvents()
    {
        // Raised when an ad is loaded into the banner view.
        // 広告がバナービューに読み込まれるときに発生します。
        _bannerView.OnBannerAdLoaded += () =>
        {
            Debug.Log("Banner view loaded an ad with response : "
                + _bannerView.GetResponseInfo());

            // Inform the UI that the ad is ready.
           // AdLoadedStatus?.SetActive(true);
        };
        // Raised when an ad fails to load into the banner view.
        // 広告がバナービューに読み込まれない場合に発生します。
        _bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
        {
            Debug.LogError("Banner view failed to load an ad with error : " + error);
        };
        // Raised when the ad is estimated to have earned money.
        // 広告が収益を上げたと推定される場合に発生します。
        _bannerView.OnAdPaid += (AdValue adValue) =>
        {
            Debug.Log(String.Format("Banner view paid {0} {1}.",
                adValue.Value,
                adValue.CurrencyCode));
        };
        // Raised when an impression is recorded for an ad.
        // 広告のインプレッションが記録されるときに発生します。
        _bannerView.OnAdImpressionRecorded += () =>
        {
            Debug.Log("Banner view recorded an impression.");
        };
        // Raised when a click is recorded for an ad.
        // 広告のクリックが記録されたときに発生します。
        _bannerView.OnAdClicked += () =>
        {
            Debug.Log("Banner view was clicked.");
        };
        // Raised when an ad opened full screen content.
        // 広告が全画面コンテンツを開いたときに発生します。
        _bannerView.OnAdFullScreenContentOpened += () =>
        {
            Debug.Log("Banner view full screen content opened.");
        };
        // Raised when the ad closed full screen content.
        // 広告が全画面コンテンツを閉じたときに発生します。
        _bannerView.OnAdFullScreenContentClosed += () =>
        {
            Debug.Log("Banner view full screen content closed.");
        };
    }
}

後編へ続きます