开屏广告
开屏广告
开屏广告在 App 启动时展现。用户可以点击广告跳转到广告落地页，或者点击右上角的跳过按钮，跳转到 App 内容首页。
此章节将演示如何请求在Unity环境下请求与展示开屏广告
插件的namespace为ZJSDK，下文默认cs文件已经声明了using ZJSDK;
请求开屏广告
调用ZJSDKUnity#LoadSplashAd(string posId, IAdLoadListener loadListener)方法请求广告
public class ZJSDKUnity
{
/// <summary>
/// 请求开屏广告
/// </summary>
/// <param name="posId">广告位ID，必传</param>
/// <param name="loadListener">加载回调</param>
public static void LoadSplashAd(string posId, IAdLoadListener loadListener);
}
IAdLoadListener 说明
| 方法 | 说明 |
|---|---|
| OnAdLoaded() | 广告加载成功 |
| OnAdLoadFailed(int code, string msg) | 广告加载出错 code: 错误码 msg: 错误信息 |
检查开屏广告有效性
如果开屏广告为预加载，需要在展示前调用ZJSDKUnity#IsSplashAdValid()方法判断当前缓存的广告对象是否有效，无效时需要重新请求广告
public class ZJSDKUnity
{
/// <summary>
/// 判断开屏广告是否有效
/// </summary>
/// <returns>当前是否有可用的开屏广告</returns>
public static bool IsSplashAdValid();
}
展示开屏广告
调用ZJSDKUnity#ShowSplashAd(SplashAdInteractionListener interactionListener )方法，展示广告
public class ZJSDKUnity
{
/// <summary>
/// 展示开屏广告
/// </summary>
public static void ShowSplashAd(ISplashAdInteractionListener interactionListener);
}
ISplashAdInteractionListener 说明
| 方法 | 说明 |
|---|---|
| OnSplashAdShow() | 广告展示 |
| OnSplashAdClick() | 广告点击 |
| OnSplashAdClose() | 广告关闭 |
| OnSplashAdShowError(int code, string msg) | 广告展示失败 code: 错误码 msg: 错误信息 |
开屏广告接入示例
Resources/ZJDemoRes/Scripts/SplashAdPopUI.cs
// 加载广告
public void LoadAndShowSplashAd()
{
// 请求开屏广告
ZJSDKUnity.LoadSplashAd("开屏广告位", new SplashAdLoadListener(this));
}
// IAdLoadListener 回调监听
class SplashAdLoadListener : ZJSDKUnity.IAdLoadListener
{
public void OnAdLoaded()
{
ShowToast("广告加载成功");
// 广告加载成功后展示广告
ZJSDKUnity.ShowSplashAd(new SplashAdInteractionListener(this));
}
public void OnAdLoadFailed(int code, string msg)
{
ShowToast($"广告加载失败:\n\t\t错误码:{code}\t\t错误信息:{msg}");
}
}
// ISplashAdInteractionListener回调监听
public class SplashAdInteractionListener : ZJSDKUnity.ISplashAdInteractionListener
{
public void OnSplashAdShowError(int code, string msg)
{
ShowToast($"开屏广告展示失败\n\t\t错误码:{code}\t\t错误信息:{msg}");
}
public void OnSplashAdShow()
{
ShowToast("开屏广告展示");
}
public void OnSplashAdClick()
{
ShowToast("开屏广告点击")
}
public void OnSplashAdClose()
{
ShowToast("开屏广告关闭")
}
}