Skip to main content

4、横幅广告

一、简介#

本文档主要介绍在Unity3D中如何集成 TradPlus SDK的横幅广告:

  • 支持Android 16以上的应用;
  • 支持Unity 2018.4.0f1以上的版本;
  • 针对v6.x版本的集成;
  • 建议先注册TradPlus账户,并添加应用;
  • 初始化TradPlus SDK。

二、集成步骤#

部分代码示范

// 1、初始化广告位,广告位ID在TradPlus后台创建
TradPlus.LoadBannerPluginsForAdUnits("AdUnitId");
// 2、加载广告 并设置弹出方式
TradPlus.CreateBanner("AdUnitId",TradPlus.AdPosition.BottomCenter);
//3、释放广告
TradPlus.DestroyBanner("AdUnitId");

三、API说明#

3.1 加载类API#

方法说明
TradPlus.LoadBannerPluginsForAdUnits("AdUnitId");初始化广告位。AdUnitId广告位ID在TradPlus后台创建。仅初始化时调用一次。
TradPlus.CreateBanner("AdUnitId",TradPlus.AdPosition.BottomCenter);加载广告。设置广告弹出的地方。每次请求广告都需要调用。
TradPlus.CreateBanner("AdUnitId",TradPlus.AdPosition.BottomCenter,"sceneId");(可选)V6.8.0新增API。加载广告并设置广告场景ID。设置广告弹出的地方。每次请求广告都需要调用。需要和设置广告场景ID一起使用。
TradPlus.BannerEntryAdScenario("AdUnitId","sceneId");(可选)进入广告位所在界面时调用。了解更多,请看广告场景的调用时机和用途说明需要和设置广告场景ID一起使用。
TradPlus.ShowBanner("AdUnitId",false);(可选)隐藏对应的广告。
TradPlus.ShowBanner("AdUnitId",true);(可选)展示对应的广告(仅调用隐藏广告之后使用)。
TradPlus.DestroyNative("AdUnitId");释放资源。

2.3 监听回调API#

  • Old API
方法说明
TradPlusManager.OnAdExpandedEvent广告被展示。
TradPlusManager.OnAdClickedEvent广告被点击。
TradPlusManager.OnAdFailedEvent请求广告后,在所有广告源请求失败的情况下才会回調一次
TradPlusManager.OnAdLoadedEvent请求广告后,加载成功只会回調一次
  • V6.4.5 更新API
方法说明
TradPlusManager.OnAdLoaded请求广告后,加载成功只会回調一次,老版本API为TradPlusManager.OnAdLoadedEvent
TradPlusManager.OnAdLoadFailed请求广告后,在所有广告源请求失败的情况下才会回調一次 (即设置多个广告源缓存,当所有广告源加载失败才会回调),老版本API为TradPlusManager.OnAdFailedEvent
TradPlusManager.OnAdClicked广告被点击,老版本API为TradPlusManager.OnAdClickedEvent
TradPlusManager.OnAdImpression广告展示,老版本API为TradPlusManager.OnAdExpandedEvent
TradPlusManager.OnAdClosedV6.4.5新增API。广告被关闭
TradPlusManager.OnAdAllLoadedV6.4.5新增API。广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。
TradPlusManager.OneLayerLoadFailedV6.4.5新增API。配置多个广告源,每个广告源加载失败后会都会回调一次。
TradPlusManager.OneLayerLoadedV6.4.5新增API。配置多个广告源,每个广告源加载成功后会都会回调一次。
TradPlusManager.OnLoadAdStartV6.4.5新增API。请求广告后,广告开始加载。
TradPlusManager.OnBiddingStartV6.4.5新增API。Bidding开始加载。
TradPlusManager.OnBiddingEndV6.4.5新增API。Bidding加载完成。

四、特殊需求需要导出到AS集成Banner#

接入过程可以参考原生Android集成Banner,参考文档横幅广告

代码示范#

// 创建广告位
TPBanner mTpBanner = new TPBanner(this);
if (mTpBanner.getParent() != null) {
((ViewGroup) mTpBanner.getParent()).removeView(mTpBanner);
}
RelativeLayout.LayoutParams params = new RelativeLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT);
RelativeLayout relativeLayout = new RelativeLayout(mContext);
// 设置横幅广告弹出位置 底部居中
relativeLayout.setGravity(Gravity.CENTER_HORIZONTAL | Gravity.BOTTOM);
relativeLayout.addView(mTpBanner);
relativeLayout.setLayoutParams(params);
RelativeLayout.LayoutParams layoutParams = new RelativeLayout.LayoutParams(RelativeLayout.LayoutParams.MATCH_PARENT, RelativeLayout.LayoutParams.MATCH_PARENT);
// 设置距离底部间隔100 (可选)
layoutParams.bottomMargin = 100;
((Activity) mContext).addContentView(relativeLayout, layoutParams);
//设置监听
mTpBanner.setAdListener(new BannerAdListener() {
@Override
public void onAdLoaded(TPAdInfo tpAdInfo) {
Log.i(TAG, "onAdLoaded: ");
}
@Override
public void onAdClicked(TPAdInfo tpAdInfo) {
Log.i(TAG, "onAdClicked: ");
}
@Override
public void onAdImpression(TPAdInfo tpAdInfo) {
Log.i(TAG, "onAdImpression: ");
}
@Override
public void onAdShowFailed(TPAdError tpAdError, TPAdInfo tpAdInfo) {
Log.i(TAG, "onAdShowFailed: ");
}
@Override
public void onAdLoadFailed(TPAdError tpAdError) {
Log.i(TAG, "onAdLoadFailed: ");
}
@Override
public void onAdClosed(TPAdInfo tpAdInfo) {
Log.i(TAG, "onAdClosed: ");
}
});
// 请求广告。 AdUnitId是广告位Id,TradPlus 后台创建
mTpBanner.loadAd("AdUnitId");