横幅广告

集成步骤#

部分代码示范

    // 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	配置多个广告源，每个广告源加载成功后会都会回调一次。
~~OnLoadAdStart~~	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");