插全屏广告
插全屏广告
插屏广告是移动广告的一种常见形式，在应用开流程中弹出，当应用展示插页式广告时，用户可以选择点按广告，访问其目标网址，也可以将其关闭，返回应用。
此章节将演示如何请求在Unity环境下请求与展示插全屏广告
插件的namespace为ZJSDK，下文默认cs文件已经声明了using ZJSDK;
提示
插屏半屏和插屏全屏通过广告位来区分样式
请求插全屏广告
调用ZJSDKUnity#LoadInterstitialAd(string posId, IAdLoadListener loadListener, string userId = "", bool isVolumeOn = true)方法，展示广告
public class ZJSDKUnity
{
/// <summary>
/// 请求插屏广告
/// </summary>
/// <param name="posId">广告位ID，必传</param>
/// <param name="loadListener">加载回调</param>
/// <param name="userId">用户ID，必传</param>
/// <param name="isVolumeOn">是否开启声音，默认开启</param>
public static void LoadInterstitialAd(string posId, IAdLoadListener loadListener, string userId = "", bool isVolumeOn = true);
}
IAdLoadListener 说明
| 方法 | 说明 |
|---|---|
| OnAdLoaded() | 广告加载成功 |
| OnAdLoadFailed(int code, string msg) | 广告加载出错 code: 错误码 msg: 错误信息 |
检查插全屏广告有效性
如果激励广告为预加载，需要在展示前调用ZJSDKUnity#IsInterstitialAdValid()方法判断当前缓存的广告对象是否有效，无效时需要重新请求广告
public class ZJSDKUnity
{
/// <summary>
/// 判断插屏广告是否有效
/// </summary>
/// <returns>当前是否有可用的插屏广告</returns>
public static bool IsInterstitialAdValid();
}
展示插全屏广告
调用ZJSDKUnity#ShowInterstitialAd(InterstitialAdInteractionListener interactionListener)方法，展示广告
public class ZJSDKUnity
{
/// <summary>
/// 展示插屏广告
/// </summary>
public static void ShowInterstitialAd(IInterstitialAdInteractionListener interactionListener);
}
IInterstitialAdInteractionListener 说明
| 方法 | 说明 |
|---|---|
| OnInterstitialAdShow() | 广告展示 |
| OnInterstitialAdClick() | 广告点击 |
| OnInterstitialAdClose() | 广告关闭 |
| OnInterstitialAdShowError(int code, string msg) | 广告展示失败 code: 错误码 msg: 错误信息 |
插全屏广告接入示例
Resources/ZJDemoRes/Scripts/InterstitialAdPopUI.cs
// 加载广告
public void LoadAndShowInterstitialAd()
{
// 请求广告
ZJSDKUnity.LoadInterstitialAd("插屏广告位", new InterstitialAdLoadListener(this), "UserId")
}
// IAdLoadListener 回调监听
class InterstitialAdLoadListener : ZJSDKUnity.IAdLoadListener
{
public void OnAdLoaded()
{
ShowToast("广告加载成功");
// 广告加载成功后展示广告
ZJSDKUnity.ShowInterstitialAd(new InterstitialAdInteractionListener(this));
}
public void OnAdLoadFailed(int code, string msg)
{
ShowToast($"广告加载失败:\n\t\t错误码:{code}\t\t错误信息:{msg}");
}
}
// IInterstitialAdInteractionListener 回调监听
public class InterstitialAdInteractionListener : ZJSDKUnity.IInterstitialAdInteractionListener
{
public void OnInterstitialAdShowError(int code, string msg)
{
ShowToast($"广告展示失败\n\t\t错误码:{code}\t\t错误信息:{msg}");
}
public void OnInterstitialAdShow()
{
ShowToast("广告展示");
}
public void OnInterstitialAdClick()
{
ShowToast("广告点击")
}
public void OnInterstitialAdClose()
{
ShowToast("广告关闭")
}
}