アプリ起動時広告は、収益化を目指すパブリッシャー様向けの特別な広告フォーマットです アプリの読み込み画面ですアプリ起動時広告はいつでも閉じることができます。 ユーザーがアプリをフォアグラウンドに戻したときに表示されます。
アプリ起動時広告では、小さなブランディング領域が自動的に表示されるため、ユーザーはそのエリアにいることがわかる 説明します。アプリ起動時広告の例を以下に示します。
前提条件
- スタートガイドを完了している。
- Unity プラグイン 7.1.0 以降。
必ずテスト広告でテストする
次のサンプルコードには、広告ユニット ID が含まれています。この ID を使用して、 テスト広告。このオブジェクトは、特定のリソースではなく、テスト広告を返すように 安全に使用できます。
ただし、 独自の広告ユニットを作成し アプリで使用する ID。デバイスをテスト用として明示的に設定します デバイス 必要があります。
Android
ca-app-pub-3940256099942544/9257395921
iOS
ca-app-pub-3940256099942544/5575463023
実装
アプリ起動時広告を統合する主な手順は次のとおりです。
- ユーティリティ クラスを作成する
- アプリ起動時広告を読み込む
- アプリ起動時広告イベントをリッスンする
- 広告の有効期限に関する考察
- アプリの状態イベントをリッスンする
- アプリ起動時広告を表示する
- アプリ起動時広告をクリーンアップする
- 次のアプリ起動時広告をプリロードする
ユーティリティ クラスを作成する
AppOpenAdController
という新しいクラスを作成して、広告を読み込みます。このクラス
読み込まれた広告と広告ユニット ID をトラッキングするためのインスタンス変数を制御します
1 つです
using System;
using UnityEngine;
using GoogleMobileAds.Api;
using GoogleMobileAds.Common;
/// <summary>
/// Demonstrates how to use the Google Mobile Ads app open ad format.
/// </summary>
[AddComponentMenu("GoogleMobileAds/Samples/AppOpenAdController")]
public class AppOpenAdController : MonoBehaviour
{
// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
private string _adUnitId = "ca-app-pub-3940256099942544/9257395921";
#elif UNITY_IPHONE
string _adUnitId = "ca-app-pub-3940256099942544/5575463023";
#else
private string _adUnitId = "unused";
#endif
public bool IsAdAvailable
{
get
{
return _appOpenAd != null;
}
}
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize((InitializationStatus initStatus) =>
{
// This callback is called once the MobileAds SDK is initialized.
});
}
/// <summary>
/// Loads the app open ad.
/// </summary>
public void LoadAppOpenAd()
{
}
/// <summary>
/// Shows the app open ad.
/// </summary>
public void ShowAppOpenAd()
{
}
}
アプリ起動時広告を読み込む
アプリ起動時広告の読み込みは、Load()
AppOpenAd
クラス。読み込みメソッドでは、広告ユニット ID、
AdRequest
オブジェクトと、次の読み込みを行う完了ハンドラ
は、広告の読み込みが成功または失敗したときに呼び出されます。読み込まれた AppOpenAd
オブジェクトは、
完了ハンドラのパラメータとして渡されます。以下の例は、
AppOpenAd
を読み込みます。
// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
private string _adUnitId = "ca-app-pub-3940256099942544/9257395921";
#elif UNITY_IPHONE
string _adUnitId = "ca-app-pub-3940256099942544/5575463023";
#else
private string _adUnitId = "unused";
#endif
private AppOpenAd appOpenAd;
/// <summary>
/// Loads the app open ad.
/// </summary>
public void LoadAppOpenAd()
{
// Clean up the old ad before loading a new one.
if (appOpenAd != null)
{
appOpenAd.Destroy();
appOpenAd = null;
}
Debug.Log("Loading the app open ad.");
// Create our request used to load the ad.
var adRequest = new AdRequest();
// send the request to load the ad.
AppOpenAd.Load(_adUnitId, adRequest,
(AppOpenAd ad, LoadAdError error) =>
{
// if error is not null, the load request failed.
if (error != null || ad == null)
{
Debug.LogError("app open ad failed to load an ad " +
"with error : " + error);
return;
}
Debug.Log("App open ad loaded with response : "
+ ad.GetResponseInfo());
appOpenAd = ad;
RegisterEventHandlers(ad);
});
}
アプリ起動時広告イベントをリッスンする
広告の動作をさらにカスタマイズするには、 広告のライフサイクルにおけるイベント(開始、終了など)です。聞き取る内容 これらのイベントを処理するには、次のようにデリゲートを登録します。
private void RegisterEventHandlers(AppOpenAd ad)
{
// Raised when the ad is estimated to have earned money.
ad.OnAdPaid += (AdValue adValue) =>
{
Debug.Log(String.Format("App open ad paid {0} {1}.",
adValue.Value,
adValue.CurrencyCode));
};
// Raised when an impression is recorded for an ad.
ad.OnAdImpressionRecorded += () =>
{
Debug.Log("App open ad recorded an impression.");
};
// Raised when a click is recorded for an ad.
ad.OnAdClicked += () =>
{
Debug.Log("App open ad was clicked.");
};
// Raised when an ad opened full screen content.
ad.OnAdFullScreenContentOpened += () =>
{
Debug.Log("App open ad full screen content opened.");
};
// Raised when the ad closed full screen content.
ad.OnAdFullScreenContentClosed += () =>
{
Debug.Log("App open ad full screen content closed.");
};
// Raised when the ad failed to open full screen content.
ad.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("App open ad failed to open full screen content " +
"with error : " + error);
};
}
広告の有効期限に関する考察
期限切れの広告を表示しないようにするには、
AppOpenAdController
: 広告が読み込まれてからの経過時間を確認します。
広告の有効性を確認できるようにします。
アプリ起動時広告は 4 時間でタイムアウトします。読み込み時間を _expireTime
のキャッシュに保存する
変数です。
// send the request to load the ad.
AppOpenAd.Load(_adUnitId, adRequest,
(AppOpenAd ad, LoadAdError error) =>
{
// If the operation failed, an error is returned.
if (error != null || ad == null)
{
Debug.LogError("App open ad failed to load an ad with error : " +
error);
return;
}
// If the operation completed successfully, no error is returned.
Debug.Log("App open ad loaded with response : " + ad.GetResponseInfo());
// App open ads can be preloaded for up to 4 hours.
_expireTime = DateTime.Now + TimeSpan.FromHours(4);
_appOpenAd = ad;
});
IsAdAvailable
プロパティを更新して _expireTime
をチェックし、読み込まれたことを確認する
広告が引き続き有効です。
public bool IsAdAvailable
{
get
{
return _appOpenAd != null
&& _appOpenAd.IsLoaded()
&& DateTime.Now < _expireTime;
}
}
アプリの状態イベントをリッスンする
AppStateEventNotifier
を使用してアプリのフォアグラウンドと
使用できます。このクラスは、いつでも AppStateChanged
イベントを発生させます。
アプリがフォアグラウンドとバックグラウンドのどちらにあってもかまいません。
private void Awake()
{
// Use the AppStateEventNotifier to listen to application open/close events.
// This is used to launch the loaded ad when we open the app.
AppStateEventNotifier.AppStateChanged += OnAppStateChanged;
}
private void OnDestroy()
{
// Always unlisten to events when complete.
AppStateEventNotifier.AppStateChanged -= OnAppStateChanged;
}
AppState.Foreground
状態と IsAdAvailable
を処理する場合
true
の場合、ShowAppOpenAd()
を呼び出して広告を表示します。
private void OnAppStateChanged(AppState state)
{
Debug.Log("App State changed to : "+ state);
// if the app is Foregrounded and the ad is available, show it.
if (state == AppState.Foreground)
{
if (IsAdAvailable)
{
ShowAppOpenAd();
}
}
}
アプリ起動時広告を表示する
読み込まれたアプリ起動時広告を表示するには、Show()
AppOpenAd
インスタンス。広告は読み込みごとに 1 回だけ表示できます。CanShowAd()
を使用する
メソッドを使って、広告を表示する準備ができているかどうかを確認します。
/// <summary>
/// Shows the app open ad.
/// </summary>
public void ShowAppOpenAd()
{
if (appOpenAd != null && appOpenAd.CanShowAd())
{
Debug.Log("Showing app open ad.");
appOpenAd.Show();
}
else
{
Debug.LogError("App open ad is not ready yet.");
}
}
アプリ起動時広告をクリーンアップする
AppOpenAd
が終了したら、必ず Destroy()
を呼び出します。
メソッドを参照してください。
appOpenAd.Destroy();
これにより、オブジェクトが使用されなくなったことがプラグインに通知されます。また、 解放されますこのメソッドを呼び出さないと、メモリリークが発生します。
次のアプリ起動時広告をプリロードする
AppOpenAd
は使い捨てオブジェクトです。つまりアプリ起動時広告が表示されると
そのオブジェクトを再度使用することはできません。別のアプリ起動時広告をリクエストするには、
新しい AppOpenAd
オブジェクトを作成する必要があります。
次のインプレッションの機会に備えてアプリ起動時広告を準備するには、
アプリ起動時広告がOnAdFullScreenContentClosed
または
OnAdFullScreenContentFailed
の広告イベントが発生します。
private void RegisterReloadHandler(AppOpenAd ad)
{
...
// Raised when the ad closed full screen content.
ad.OnAdFullScreenContentClosed += ()
{
Debug.Log("App open ad full screen content closed.");
// Reload the ad so that we can show another as soon as possible.
LoadAppOpenAd();
};
// Raised when the ad failed to open full screen content.
ad.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("App open ad failed to open full screen content " +
"with error : " + error);
// Reload the ad so that we can show another as soon as possible.
LoadAppOpenAd();
};
}
コールド スタートと読み込み画面
ドキュメントではここまでは、ユーザーが特定の操作をしているときにのみアプリ起動時広告を表示することを想定 アプリがフォアグラウンドで動作している必要があります。「コールド スタート」次の場合に発生: アプリが起動されたものの、以前にメモリ内で一時停止されていなかった場合。
コールド スタートの例として、ユーザーが初めてアプリを起動したときが挙げられます。 コールド スタートでは、読み込み済みのアプリ起動時広告を 表示されます。広告のリクエストから広告が届くまでの所要時間 ユーザーがそれまでにアプリを使用できなくなった場合も 背景情報のない広告を表示して驚かされました。エラーの原因となるため、この方法は ユーザーエクスペリエンスが低下します
コールド スタート時にアプリ起動時広告を使用する場合のおすすめの方法は、読み込み画面を使用することです ゲームアセットやアプリアセットを読み込むこと、 表示されます。アプリの読み込みが完了し、ユーザーをメイン 広告は表示されません。
ベスト プラクティス
アプリ起動時広告は、アプリが最初に起動したときにアプリの読み込み画面を収益化できる アプリの切り替え時に発生しますが、次の点を念頭に置いて ベスト プラクティスをいくつか紹介します。
- ユーザーがアプリを数回使用した後に、アプリ起動時広告を初めて表示する。
- ユーザーが待たされるはずの時間帯にアプリ起動時広告を表示 読み込む必要があるかもしれません。
- アプリ起動時広告と読み込み画面の下に読み込み画面がある場合
広告が閉じられる前に読み込みを完了した場合、
OnAdDidDismissFullScreenContent
イベント ハンドラ。 - iOS プラットフォームでは、
AppStateEventNotifier
がAppStateEventClient GameObject
。このGameObject
はイベントに必要です 破棄しないでください。GameObject
が次の場合、イベントは起動を停止します。 破棄します。
参考情報
- HelloWorld の例: すべての広告フォーマットの最小実装です。