横幅广告
集成步骤
部分代码示范
// 1、初始化广告位,广告位ID在TradPlus后台创建
TradPlus.LoadBannerPluginsForAdUnits("AdUnitId");
// 2、加载广告 并设置弹出方式
TradPlus.CreateBanner("AdUnitId",TradPlus.AdPosition.BottomCenter);
//3、释放广告
TradPlus.DestroyBanner("AdUnitId");
设置自动刷新
TradPlus支持设置自动刷新功能,开发者仅需 在TP后台开启自动刷新即可使用。
创建好广告位——>点击广告位编辑按钮——>高级设置
API说明
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.DestroyBanner("AdUnitId"); | 释放资源。 |
2.监听回调API
- 监听回调中的参数说明
参数 | 说明 |
---|---|
TPAdInfo | 广告位ID、三方广告平台、ecpm等信息,具体请参考回调信息说明。 |
errorMsg | 广告请求失败、广告展示失败的错误信息,具体请参考错误码、错误信息说明。 |
- 广告位维度回调监听 V6.4.5新增API
- 开发者可通过TradPlusManager调用
方法 | 参数 | 说明 |
---|---|---|
OnAdLoaded | string tpAdInfo, string height | 请求广告后,加载成功只会回調一次,老版本API为TradPlusManager.OnAdLoadedEvent |
OnAdLoadFailed | string adUnitId, string errorMsg | 请求广告后,在所有广告源请求失败的情况下才会回調一次 (即设置多个广告源缓存,当所有广告源加载失败才会回调),老版本API为TradPlusManager.OnAdFailedEvent |
OnAdClicked | string tpAdInfo | 广告被点击,老版本API为TradPlusManager.OnAdClickedEvent |
OnAdImpression | string tpAdInfo | 广告展示,老版本API为TradPlusManager.OnAdExpandedEvent |
OnAdClosed | string tpAdInfo | 广告被关闭 |
OnAdShowFailed | string tpAdInfo, string errorMsg | V7.3.0新增API。广告展示失败。 |
- 广告源维度回调监听 (可选) V6.4.5新增API
方法 | 参数 | 说明 |
---|---|---|
OnAdAllLoaded | bool isSuccess, string adUnitId | 广告位的状态。loadAd() 完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。 |
OneLayerLoadFailed | string tpAdInfo ,string errorMsg | 配置多个广告源,每个广告源加载失败后会都会回调一次。 |
OneLayerLoaded | string tpAdInfo | 配置多个广告源,每个广告源加载成功后会都会回调一次。 |
string tpAdInfo | 请求广告后,广告开始加载。 V7.9.0 废弃。 | |
OneLayerStartLoad | string tpAdInfo | 每层waterfall 向三方广告源发起请求前,触发的回调。 V7.9.0 新增回调。 |
OnAdStartLoad | string adUnitId | 每次调用load方法时返回的回调。 V7.9.0 新增回调。 |
OnBiddingStart | string tpAdInfo | Bidding开始加载。 |
OnBiddingEnd | string tpAdInfo, string errorMsg | Bidding加载完成。 V7.3.0新增回调参数 errorMsg。 |
- 下载监听(可选) 仅快手、穿山甲、广点通支持(Android V8.1.0.1)
方法 | 参数 | 说明 |
---|---|---|
OnNativeDownloadStart | string tpAdInfo, string networkinfo | 开始下载回调。 TPAdInfo:广告的信息对象,具体请参考上文回调信息说明 开发者可通过解析 json“networkinfo”获得: totalBytes:文件总大 小(单位:字节) currBytes:当前已下载的大小(单位:字节) fileName:文件名 appName:文件对应的应用名称 |
OnNativeDownloadUpdate | string tpAdInfo, string networkinfo | 下载进度更新回调。 参数意义同上。 |
OnNativeDownloadPause | string tpAdInfo, string networkinfo | 暂停下载回调。 参数意义同上。 |
OnNativeDownloadFinish | string tpAdInfo, string networkinfo | 下载完成回调。 参数意义同上。 |
OnNativeDownloadFail | string tpAdInfo, string networkinfo | 下载失败回调。 参数意义同上。 |
OnNativeInstalled | string tpAdInfo, string networkinfo | Apk安装完成回调。 参数意义同上。 |
特殊需求需要导出到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.setLayoutParams(params);
relativeLayout.addView(mTpBanner);
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");