原生横幅
集成步骤
代码示范
部分代码示范
// 1、初始化广告位,广告位ID在TradPlus后台创建
TradPlus.LoadNativeBannerPluginsForAdUnits("AdUnitId");
// 2、加载广告 并设置弹出位置
TradPlus.CreateNativeBanner("AdUnitId",TradPlus.AdPosition.BottomCenter);
//3、释放广告
TradPlus.DestroyNativeBanner("AdUnitId");
设置自动刷新
TradPlus支持设置自动刷新功能,开发者仅需在TP后台开启自动刷新即可使用。
创建好广告位——>点击广告位编辑按钮——>高级设置
API说明
1.加载类API
Android
- 注意事项 原生横幅类型使用默认模版不支持拉伸布局。
方法 | 说明 |
---|---|
TradPlus.LoadNativeBannerPluginsForAdUnits("AdUnitId"); | 初始化广告位。AdUnitId广告位ID在TradPlus后台创建。仅初始化时调用一次。 |
TradPlus.SetNativeBannerSize("AdUnitId", width, height); | ( 可选)。设置广告源宽高,单位dp,默认宽320,高50。宽传-1为match_parent 宽全屏显示。必须在加载广告前调用。 |
TradPlus.CreateNativeBanner("AdUnitId",TradPlus.AdPosition.BottomCenter); | 加载广告。设置广告弹出的地方。每次请求广告都需要调用。 |
TradPlus.CreateNativeBanner("AdUnitId",TradPlus.AdPosition.BottomCenter, sceneId) | (可选)请求广告并传入广告场景ID。sceneId需和NativeBannerEntryAdScenario() 配套使用。 |
TradPlus.CreateNativeBanner("AdUnitId",TradPlus.AdPosition.BottomCenter, sceneId, LayoutIdByName); | (可选)加载广告并自定义布局文件。LayoutIdByName,布局文件从Download的SDK文件中获取 |
(可选)展示对应的广告(仅调用隐藏广告之后使用)。V8.0.30废弃。 | |
(可选)隐藏对应的广告。V8.0.30废弃。 | |
TradPlus.HideNativeBanner(“AdUnitId”); | (可选)隐藏对应的广告。 V8.0.30开始支持。 |
TradPlus.DisplayNativeBanner(“AdUnitId”); | (可选)展示对应的广告(仅调用隐藏广告之后使用)。 V8.0.30开始支持。 |
TradPlus.DestroyNativeBanner("AdUnitId"); | 释放资源。 |
TradPlus.NativeBannerEntryAdScenario("AdUnitId"); | (可选)进入广告位所在界面时调用。了解更多,请看广告场景的调用时机和用途说明。 |
TradPlus.NativeBannerEntryAdScenario("AdUnitId",adSceneId); | (可选)进入广告位所在界面时调用并传入场景ID。 |
iOS
方法 | 说明 |
---|---|
TradPlus.LoadNativeBannerPluginsForAdUnits("AdUnitId"); | 初始化广告位。AdUnitId广告位ID在TradPlus后台创建。仅初始化时调用一次。 |
TradPlus.CreateNativeBanner("AdUnitId",TradPlus.AdPosition.BottomCenter, sceneId, className); | (可选)加载广告并自定义布局类className,默认的布局文件可从demo中获取 |
(可选)展示对应的广告(仅调用隐藏广告之后使用)。V7.8.0废弃。 | |
(可选)隐藏对应的广告。V7.8.0废弃。 | |
TradPlus.HideNativeBanner("AdUnitId"); | (可选)隐藏对应的广告。 |
TradPlus.DisplayNativeBanner("AdUnitId"); | (可选)展示对应的广告(仅调用隐藏广告之后使用)。 |
TradPlus.DestroyNativeBanner("AdUnitId"); | 释放资源。 |
TradPlus.NativeBannerEntryAdScenario("AdUnitId"); | (可选)进入广告位所在界面时调用。了解更多,请看广告场景的调用时机和用途说明。 |
TradPlus.NativeBannerEntryAdScenario("AdUnitId",adSceneId); | (可选)进入广告位所在界面时调用并传入场景ID。 |
2.监听回调API
- 广告位维度回调监听 V6.4.5新增API
- 开发者可通过TradPlusManager调用
方法 | 参数 | 说明 |
---|---|---|
OnNativeBannerAdLoaded | string tpAdInfo , string height | 广告加载成功。 |
OnNativeBannerAdLoadFailed | string adUnitId ,string errorMsg | 广告加载失败。 |
OnNativeBannerAdClicked | string tpAdInfo | 广告被点击。 |
OnNativeBannerAdImpression | string tpAdInfo | 广告展示。 |
OnNativeBannerAdClosed | string tpAdInfo | 广告被关闭。 |
OnNativeBannerAdShowFailed | string tpAdInfo ,string errorMsg | V7.3.0新增API。广告展示失败。 |
- 广告源维度回调监听 (可选) V6.4.5新增API
方法 | 参数 | 说明 |
---|---|---|
OnNativeBannerAdAllLoaded | bool isSuccess,string adUnitId | 广告位的状态。loadAd() 完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。 |
OneNativeBannerLayerLoadFailed | string tpAdInfo ,string errorMsg | 配置多个广告源,每个广告源加载失败后会都会回调一次。 |
string tpAdInfo | 配置多个广告源,每个广告源加载成功后会都会回调一次。 | |
OneNativeBannerLayerStartLoad | string tpAdInfo | 每层waterfall 向三方广告源发起请求前,触发的回调。 V7.9.0 新增回调。 |
OnNativeBannerAdStartLoad | string adUnitId | 每次调用load方法时返回的回调。 V7.9.0 新增回调。 |
OnNativeBannerBiddingStart | string tpAdInfo | Bidding开始加载。 |
OnNativeBannerBiddingEnd | string tpAdInfo ,string errorMsg | Bidding加载完成。 V7.3.0新增回调参数 errorMsg。 |
- 监听回调中的参数说明
参数 | 说明 |
---|---|
TPAdInfo | 广告位ID、三方广告平台、ecpm等信息,具体请参考回调信息说明。 |
errorMsg | 广告请求失败、广告展示失败的错误信息,具体请参考错误码、错误信息说明。 |