広告のプレースメント

このガイドでは、Google Mobile Ads Unity プラグインの広告プレースメント機能を使用して、アプリの広告を作成して表示する方法について説明します。

前提条件

Google Mobile Ads Unity Plugin を初期化する

広告を読み込む前に、Action<InitializationStatus> コールバックを指定して MobileAds.Initialize() を呼び出し、Google Mobile Ads Unity Plugin を初期化します。この処理は 1 回だけ行います(アプリの起動時に行うのが理想的です)。

using GoogleMobileAds.Api;
using System.Collections.Generic;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    ...
    public void Start()
    {
        // Initialize Google Mobile Ads Unity Plugin.
        MobileAds.Initialize((initStatus) =>
        {
            // SDK initialization is complete
        });
        ...
    }
}

広告プレースメントの作成

Google モバイル広告でバナーを表示するには、まず広告プレースメントを作成して設定します。Unity エディタの [Assets] > [Google Mobile Ads] > [Ad Placements] で、バナー、インタースティシャル、リワードのいずれかのフォーマットの広告プレースメントを選択できます。3 つのデモ広告プレースメントが設定され、使用できるようになります。

新しい広告プレースメントを追加するには、リストの最後にある [Add New Placement] ボタンをクリックします。広告のプレースメントは、インスペクタ ビューから設定できます。

広告のプレースメントの設定

各プレースメントには次のプロパティがあります。

プレースメントの名前
プレースメントの名前。シーンで広告を設定する際にプレースメントを識別するために使用されます。
広告フォーマット
バナー、リワード、インタースティシャル。広告のタイプ。
広告ユニット ID
Android と iOS のバナー広告ユニット ID を指定します。少なくとも 1 つの広告ユニット ID を指定する必要があります。
シーンをまたいで存続
オンにすると、シーンの変更に関係なくバナーが画面に表示されたままになります(DontDestroyOnLoad と同じ動作)。
自動読み込みが有効
オンにすると、広告プレースメントに関連付けられたシーンが読み込まれたときに、広告が自動的に読み込まれます。

次のスクリーンショットは、My Awesome Banner という名前の広告プレースメントの例を示しています。

シーンに AdGameObject を追加する

Unity エディタで [GameObject] > [Google Mobile Ads] を使用して、バナー、インタースティシャル、リワードの各フォーマットの AdGameObject をシーンに追加できます。フォーマットを選択して、アクティブなシーンにプレースメントを追加します。

AdGameObject をシーンに追加すると、Unity エディタの階層ビューに広告を表す GameObject が表示されます。

プレースメントの名前を変更するには、GameObject 自体の名前を変更します。次のスクリーンショットは、バナー広告 という名前の AdGameObject の例を示しています。

AdGameObject の設定

シーン内の AdGameObject は、Ad Game Object(Script)コンポーネントの設定の Inspector ビューから設定できます。

広告であること

設定済みのプレースメントのプルダウン リストから広告プレースメントを選択します。リストには、適切なフォーマットの広告ユニットのみが表示されます。たとえば、バナー広告のゲーム オブジェクトの場合、プルダウンには設定済みのバナー広告プレースメントのみが表示されます。

BannerAdGameObject 構成(バナーのみ)

  • サイズ - 使用するバナーのサイズを選択します。
    • アンカー アダプティブ バナーには、他にもいくつかのオプションがあります。
      • 画面の向き - 広告の高さを計算するために使用するデバイスの画面の向きを選択します。
      • 全画面幅を使用する - オンにすると、バナーが全画面幅を占有します。[全画面幅を使用] オプションをオフにすると、画面の幅の割合(50 ~ 99%)を調整できます。
    • [カスタム] を選択すると、バナーの幅と高さを指定できます。
  • 広告の掲載順位 - バナーを配置する位置を選択します。

コールバック

広告コールバックに対応する関数を実装できます。たとえば、バナー広告の読み込みに失敗した場合の処理は、次のように記述します。

  1. 広告コールバックに対応する関数を作成します。

    public void OnBannerAdFailedToLoad(string reason) {
        Debug.Log("Banner ad failed to load: " + reason);
    }
    
  2. 上記の関数を含むスクリプトをシーン内の任意の GameObject にアタッチします。

  3. [+] ボタンをクリックし、スクリプトをアタッチした GameObject をドラッグ&ドロップします。

  4. 広告コールバックにリンクする関数を選択します。パラメータ化された広告コールバックの場合は、動的変数を受け入れる関数を選択して、SDK からパラメータ値を取得できるようにします。

スクリプトから AdGameObject を使用する

スクリプトから AdGameObject インスタンスを取得する

すべての AdGameObject オブジェクトには、便利なメソッド LoadAd() があります。これにより、ターゲット設定されていないプレーンな AdRequest を含む広告が読み込まれます。ターゲティングを適用するには、独自に構成した広告リクエストを使用して LoadAd(AdRequest adRequest) を使用する必要があります。

AdGameObject のインスタンスを取得するには、フォーマットごとに次のメソッドを使用します。

MobileAds.Instance.GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

返された BannerAdGameObject オブジェクトには、コンビニエンス メソッド Hide() と Show() もあります。

インタースティシャル

MobileAds.Instance.GetAd<InterstitialAdGameObject>("AD_GAMEOBJECT_NAME");

返された InterstitialAdGameObject オブジェクトには、便利なメソッド ShowIfLoaded() があります。

特典

MobileAds.Instance.GetAd<RewardedAdGameObject>("AD_GAMEOBJECT_NAME");

返された RewardedAdGameObject オブジェクトには、便利なメソッド ShowIfLoaded() があります。

たとえば、次のように BannerAdGameObject のインスタンスを取得して読み込むことができます。

using UnityEngine;

using GoogleMobileAds.Api;
using GoogleMobileAds.Placement;

public class BannerTestScript : MonoBehaviour
{
    BannerAdGameObject bannerAd;

    void Start()
    {
        bannerAd = MobileAds.Instance
            .GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

        bannerAd.LoadAd();
        ...
    }
    ...
}

BannerAd という名前の BannerAdGameObject がある場合は、次のようにインスタンスを取得できます。

MobileAds.Instance.GetAd<BannerAdGameObject>("BannerAd");

AdGameObject の基盤となる広告オブジェクトにアクセスする

以下のスニペットは、AdGameObject に関連付けられている基盤となる広告オブジェクトにアクセスする方法を示しています。

BannerAdGameObject bannerAd = MobileAds.Instance
    .GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

// Access BannerView object
BannerView bannerView = bannerAd.BannerView;

インタースティシャル

InterstitialAdGameObject interstitialAdGameObject = MobileAds.Instance
    .GetAd<InterstitialAdGameObject>("AD_GAMEOBJECT_NAME");

// Access InterstitialAd object
InterstitialAd interstitialAd = interstitialAdGameObject.InterstitialAd;

特典

RewardedAdGameObject rewardedAdGameObject = MobileAds.Instance
    .Get<RewardedAdGameObject>("AD_GAMEOBJECT_NAME");

// Access RewardedAd object
RewardedAd rewardedAd = rewardedAdGameObject.RewardedAd;

例

インタースティシャル広告を表示する

AdGameObject を使用してインタースティシャル広告を読み込んで表示するようにゲームを構成する方法の例を次に示します。

シーンに InterstitialAdGameObject を追加し、[Auto Load Enabled] 機能をオンにして、シーンの読み込み時に広告が自動的に読み込まれるようにします。

次に、次のように SDK を初期化していることを確認します。SDK の初期化を忘れると、AdGameObject の自動読み込み機能が動作しないのでご注意ください。

次に、InterstitialAdGameObject.ShowIfLoaded() 関数を呼び出して、画面の切り替え時にインタースティシャル広告を表示します。次のコードは、シーンの切り替え時にインタースティシャル広告を表示する例を示しています。

using UnityEngine;
using UnityEngine.SceneManagement;

using GoogleMobileAds.Api;
using GoogleMobileAds.Placement;

public class MainScene : MonoBehaviour
{
    InterstitialAdGameObject interstitialAd;

    void Start()
    {
        interstitialAd = MobileAds.Instance
            .GetAd<InterstitialAdGameObject>("interstitial");

        MobileAds.Initialize((initStatus) => {
            Debug.Log("Initialized MobileAds");
        });
    }

    public void OnClickShowGameSceneButton()
    {
        // Display an interstitial ad
        interstitialAd.ShowIfLoaded();

        // Load a scene named "GameScene"
        SceneManager.LoadScene("GameScene");
    }
}

広告プレースメントで自動読み込み機能を有効にしているため、広告を明示的にリクエストする必要はありません。シーンが切り替わると、インタースティシャル広告の準備ができていれば、広告が表示されます。

広告を手動でリクエストする場合は、広告プレースメント インスペクタで [Auto Load] 機能を無効にし、代わりに InterstitialAdGameObject.LoadAd() 関数を呼び出します。次のコード スニペットは、広告を手動でリクエストする方法を示しています。

public class MainScene : MonoBehaviour
{
    InterstitialAdGameObject interstitialAd;

    void Start()
    {
        interstitialAd = MobileAds.Instance
            .GetAdGameObject<InterstitialAdGameObject>("interstitial");

        MobileAds.Initialize((initStatus) => {
            Debug.Log("MobileAds initialized");

            // Load an interstitial ad after the SDK initialization is complete
            interstitialAd.LoadAd();
        });
    }
    ...
}

「リワード広告を視聴する」ボタンの状態を処理する

広告プレースメントを使用して「リワード広告を視聴する」ボタンを有効にする方法の例を次に示します。

リワード広告を表示するために使用する Button GameObject(この例では Button という名前)をシーンに追加します。このボタンは、リワード広告が利用可能な場合にのみ表示されます。

Start() メソッドで、Button のアクティブな状態を false に変更します。これにより、ボタンがシーンから消えます。

public class MainScene : MonoBehaviour
{
    ...
    void Start()
    {
        GameObject.Find("Button").SetActive(false);
        ...
    }
}

シーンに RewardedAdGameObject を追加し、プルダウンから [AdMob Demo Rewarded Ad] 広告プレースメントを選択します。

RewardedAdGameObject インスペクタの [Callbacks] セクションで、[On Ad Loaded()] の + ボタンをクリックして、リワード広告が読み込まれたときに呼び出される関数を有効にします。

前の手順で追加したボタンの GameObject を [None (Object)] フィールドにドラッグ&ドロップします。プルダウンから呼び出す関数を選択します。[No Function] > [GameObject] > [SetActive(bool)] をクリックし、チェックボックスをオンにして、true をパラメータとして送信(SetActive(true) を呼び出し)します。

この [Callbacks] セクションでは、RewardedAd.OnUserEarnedReward イベントが呼び出されたときに呼び出されるイベントをリンクすることもできます。詳しくは、こちらのセクションをご覧ください。

次に、クリックするとリワード広告が表示されるボタンを作成します。ボタン インスペクタの [On Click() Callbacks] セクションで、[+] ボタンをクリックし、リワード広告プレースメントの GameObject(この例では Rewarded Ad という名前)を [None (Object)] フィールドにドラッグ&ドロップします。

次に、RewardedAdGameObject.ShowIfLoaded() 関数をボタンの On Click() コールバックにアタッチします。

最後に、SDK を初期化することを忘れないでください。次のコード スニペットは、この例で使用されているシーンの完全なコードです。

using UnityEngine;

using GoogleMobileAds.Api;

public class MainScene : MonoBehaviour
{
    void Start()
    {
        GameObject.Find("Button").SetActive(false);

        MobileAds.Initialize((initStatus) => {
            Debug.Log("Initialized MobileAds");
        });
    }
}

プロジェクトを実行すると、リワード広告が読み込まれて表示可能になったときに、シーンにボタンが表示されます。

RewardedAdGameObject の報酬コールバックを設定する

以下は、リワード広告プレースメントにリワード コールバックを設定する方法の例です。コールバック関数が呼び出されたときに、ユーザーに報酬を付与できます。

新しいスクリプトを作成し、次のように Reward をパラメータとして受け取る関数を定義します。

using UnityEngine;
using GoogleMobileAds.Api;

class RewardedTestScript : MonoBehaviour {
    ...
    public void OnUserEarnedReward(Reward reward) {
        Debug.Log("OnUserEarnedReward: reward=" +
            reward.Type + ", amount=" + reward.Amount);
    }
    ...
}

RewardedTestScript スクリプトをシーン内の任意の GameObject(広告プレースメント GameObject を除く)にアタッチします。この例では、Main Camera GameObject にアタッチされています。

シーンに RewardedAdGameObject を追加します。次に、RewardedAdGameObject インスペクタの [Callbacks] セクションで、[On User Earned Reward (Reward)] の + ボタンをクリックして、ユーザーに報酬が付与されたときに呼び出される関数を有効にします。

前の手順で追加したメインカメラの GameObject を、[None (Object)] フィールドにドラッグ&ドロップします。プルダウンから呼び出す関数を選択します。[No Function] > [RewardedTestScript] > [OnUserEarnedReward] をクリックします。

プロジェクトを実行してリワード広告を視聴すると、広告を操作して報酬を受け取る際に RewardedTestScript.OnUserEarnedReward() が呼び出されます。