插页式广告属于全屏广告,会覆盖宿主应用的整个界面,通常展示在应用流程的自然过渡点,例如,游戏关卡之间的暂停时段。当应用展示插页式广告时,用户可以选择点按广告,访问其目标网址,也可以将其关闭,返回应用。案例研究。
本指南介绍了如何将插页式广告植入到 Unity 应用中。
前提条件
- 完成入门指南。
务必用测试广告进行测试
以下示例代码包含一个可用于请求测试广告的广告单元 ID。该测试广告单元 ID 已经过专门配置,可为每个请求返回测试广告(而不是实际投放的广告),因此能够安全地使用。
但是,在 AdMob 网页界面中注册应用并创建您自己的广告单元 ID 以便在应用中使用后,请在开发期间明确地将您的设备配置为测试设备。
Android
ca-app-pub-3940256099942544/1033173712
iOS
ca-app-pub-3940256099942544/4411468910
初始化移动广告 SDK
加载广告之前,请先调用 MobileAds.Initialize()
,让应用初始化移动广告 SDK。此操作仅需执行一次,最好是在应用启动时执行。
using GoogleMobileAds;
using GoogleMobileAds.Api;
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize((InitializationStatus initStatus) =>
{
// This callback is called once the MobileAds SDK is initialized.
});
}
}
如果您使用的是中介功能,请等到回调发生后再加载广告,因为这可确保初始化所有的中介适配器。
实现
植入插页式广告的主要步骤如下所示:
- 加载插页式广告
- 展示插页式广告
- 监听插页式广告事件
- 清理插页式广告
- 预加载下一个插页式广告
加载插页式广告
插页式广告的加载是通过对 InterstitialAd
类使用静态 Load()
方法完成的。该加载方法需要使用广告单元 ID、AdRequest
对象以及在广告加载成功或失败时调用的完成处理程序。已加载的 InterstitialAd
对象会以完成处理程序中的参数的形式提供。以下示例展示了如何加载 InterstitialAd
。
// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
private string _adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
private string _adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
private string _adUnitId = "unused";
#endif
private InterstitialAd _interstitialAd;
/// <summary>
/// Loads the interstitial ad.
/// </summary>
public void LoadInterstitialAd()
{
// Clean up the old ad before loading a new one.
if (_interstitialAd != null)
{
_interstitialAd.Destroy();
_interstitialAd = null;
}
Debug.Log("Loading the interstitial ad.");
// create our request used to load the ad.
var adRequest = new AdRequest();
// send the request to load the ad.
InterstitialAd.Load(_adUnitId, adRequest,
(InterstitialAd ad, LoadAdError error) =>
{
// if error is not null, the load request failed.
if (error != null || ad == null)
{
Debug.LogError("interstitial ad failed to load an ad " +
"with error : " + error);
return;
}
Debug.Log("Interstitial ad loaded with response : "
+ ad.GetResponseInfo());
_interstitialAd = ad;
});
}
展示插页式广告
要展示已加载的插页式广告,请对 InterstitialAd
实例调用 Show()
方法。广告可能会在每次加载时展示一次。您可以使用 CanShowAd()
方法验证广告是否已做好展示准备。
/// <summary>
/// Shows the interstitial ad.
/// </summary>
public void ShowInterstitialAd()
{
if (_interstitialAd != null && _interstitialAd.CanShowAd())
{
Debug.Log("Showing interstitial ad.");
_interstitialAd.Show();
}
else
{
Debug.LogError("Interstitial ad is not ready yet.");
}
}
监听插页式广告事件
若要进一步自定义您广告的行为,您可以在广告生命周期内加入许多事件。您可以通过注册代理来监听这些事件,如下所示。
private void RegisterEventHandlers(InterstitialAd interstitialAd)
{
// Raised when the ad is estimated to have earned money.
interstitialAd.OnAdPaid += (AdValue adValue) =>
{
Debug.Log(String.Format("Interstitial ad paid {0} {1}.",
adValue.Value,
adValue.CurrencyCode));
};
// Raised when an impression is recorded for an ad.
interstitialAd.OnAdImpressionRecorded += () =>
{
Debug.Log("Interstitial ad recorded an impression.");
};
// Raised when a click is recorded for an ad.
interstitialAd.OnAdClicked += () =>
{
Debug.Log("Interstitial ad was clicked.");
};
// Raised when an ad opened full screen content.
interstitialAd.OnAdFullScreenContentOpened += () =>
{
Debug.Log("Interstitial ad full screen content opened.");
};
// Raised when the ad closed full screen content.
interstitialAd.OnAdFullScreenContentClosed += () =>
{
Debug.Log("Interstitial ad full screen content closed.");
};
// Raised when the ad failed to open full screen content.
interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("Interstitial ad failed to open full screen content " +
"with error : " + error);
};
}
清理插页式广告
创建完 InterstitialAd
后,请确保在放弃对它的引用之前调用 Destroy()
方法:
_interstitialAd.Destroy();
这会通知插件已不再使用该对象,且可回收它占用的内存。此方法调用失败将导致内存泄露。
预加载下一个插页式广告
插页式广告是一次性对象。这意味着,在插页式广告展示后,该插页式广告对象就无法再使用了。如需再请求一个插页式广告,请创建一个新的 InterstitialAd
对象。
若要为下一次展示机会准备好插页式广告,请在 OnAdFullScreenContentClosed
或 OnAdFullScreenContentFailed
广告事件引发后预加载插页式广告。
private void RegisterReloadHandler(InterstitialAd interstitialAd)
{
// Raised when the ad closed full screen content.
interstitialAd.OnAdFullScreenContentClosed += ()
{
Debug.Log("Interstitial Ad full screen content closed.");
// Reload the ad so that we can show another as soon as possible.
LoadInterstitialAd();
};
// Raised when the ad failed to open full screen content.
interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("Interstitial ad failed to open full screen content " +
"with error : " + error);
// Reload the ad so that we can show another as soon as possible.
LoadInterstitialAd();
};
}
最佳做法
- 确定插页式广告是否适合您的应用。
- 在具有自然过渡点的应用中,插页式广告的效果最好。此类过渡点通常存在于应用内的任务结束时,例如分享完图片或完成一个游戏关卡时。请务必考虑在应用流程的哪些时间点展示插页式广告最合适,以及用户可能会以什么方式响应。
- 在展示插页式广告时暂停操作。
- 插页式广告类型多样,包括文字广告、图片广告或视频广告等。请务必确保应用在展示插页式广告时,也会暂停使用某些资源,以便广告能够利用这些资源。例如,当您发出展示插页式广告的调用后,请务必暂停应用产生的所有音频输出。您可以在
OnAdFullScreenContentClosed()
事件中恢复声音播放,当用户结束与广告的互动时,系统会调用这个事件。此外,还应考虑在广告展示时暂停所有会占用大量资源的计算任务,例如游戏循环。这样可以确保用户不会遇到图像无响应、响应慢或视频卡顿的现象。 - 不要向用户展示太多广告。
- 虽然提高插页式广告在应用中的展示频次似乎是实现增收的好方法,但这么做也会影响用户体验并降低点击率。应确保用户不会频繁受到广告打扰,使他们可以充分享受到使用应用的乐趣。
其他资源
- HelloWorld 示例:所有广告格式的极简实现方案。