Banner
简介
Banner 广告 (横幅广告) 位于 app 顶部、中部、底部任意一处，横向贯穿整个 app 页面；当用户与 app 互动时，Banner 广告会停留在屏幕上，并可在一段时间后自动刷新
适用场景：Banner 广告展现场景非常灵活，常见的展现场景为：文章页末尾，详情页面底部，信息流顶部等
分类：Banner 广告分为文字链，纯图片和图文描述
主要API
函数接口列表
- 用于加载展示 Banner 广告。
| 方法名 | 方法介绍 | 备注 |
|---|---|---|
| UnifiedBannerView(string placementId, AdSize adSize) | 构造函数 | |
| void LoadAndShowAd() | 加载并展示广告 | |
| void SetListener(IUnifiedBannerAdListener listener) | 设置回调 | |
| void CloseAd() | 关闭广告 | |
| void SetAutoSwitchInterval(int autoSwitchInterval) | 设置自动刷新间隔时间，单位：秒 | 所设置值的有效范围是[30,120]，低于 30 的会按 30 处理；高于 120 的会按 120 处理。默认值为 30 |
| AndroidJavaObject GetAndroidNativeView() | 获取 Android View 对象 | 只有 Android 有这个方法 |
| IntPtr GetIOSNativeView() | 获取 iOS View 对象 | 只有 iOS 有这个方法 |
| string GetECPMLevel() | 获取ecpmLevel值 | 当广告拉取成功后通过 GetECPMLevel() 方法查看当前广告对应的底价层级 |
| int GetECPM() | 获取ecpm值 | 当广告拉取成功后通过 GetECPM() 方法查看当前广告对应的底价 |
广告声明周期回调函数列表
- 接口名称
IUnifiedBannerAdListener
| 回调函数名 | 回调函数含义 | 备注 |
|---|---|---|
| OnAdLoaded() | 广告数据拉取成功 | |
| OnError(AdError error) | 广告加载失败 | |
| OnAdExposured() | 当广告曝光时发起的回调 | |
| OnAdClicked() | 当广告点击时发起的回调 | |
| OnAdLeaveApp() | 点击直达类型广告离开当前APP时回调 | |
| OnAdClosed() | 被用户关闭时调用 | |
| OnDetailPageShown() | 点击广告后已弹出广告详情页 | |
| OnDetailPageClosed() | 点击广告后弹出的广告详情页已被关闭 |
接入代码示例
- 完整的接入代码示例可在
Assets/UnionDemo/BannerExample中找到
加载并显示 Banner 广告
- 在您需要加载广告的文件中引入
Tencent.GDT命名空间public void LoadAndShowBanner() { // Android 不能设置 banner 宽高，故 ADSize 参数对 Android 无效，设置任意都行 ad = new UnifiedBannerAd(Constants.bannerPosId, new AdSize(400, 100)); // ExampleBannerListener 是实现 IUnifiedBannerAdListener 接口的类 ad.SetListener(new ExampleBannerListener()); ad.LoadAndShowAd(); #if UNITY_ANDROID // UnifiedBannerAd#GetAndroidNativeView 方法能拿到 banner view // 该 view 类型是 c# 的 AndroidJavaObject，是 Java(Android) 的 View AndroidDemoUtils.ShowView(ad.GetAndroidNativeView()); #elif UNITY_IOS // UnifiedBannerAd#GetIOSNativeView 方法能拿到 banner view // 该 view 类型是 c# 的 IntPtr，是 iOS 的 UIView IOSDemoUtils.ShowView(ad.GetIOSNativeView()); #endif } - bannerPosId - Banner 的广告位ID
- AdSize - Banner广告的尺寸，您可在插件的
Assets/UnionSDK/Scripts/common/AdSize目录下查找该类的实现
在不展示 Banner 广告时执行调试
在您加载广告的类中实现如下回调，处理 Banner 广告加载失败的问题：
public void OnError(AdError error)
{
}
- AdError - 您可在插件的
Assets/UnionSDK/Scripts/common/AdError目录下查找该类的实现
说明
- 在 Constants.cs 文件中替换您的 AppId 和 PlacementId