Skip to main content

6、原生横幅

一、简介#

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

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

二、集成步骤#

1、代码示范#

部分代码示范

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

三、API说明#

3.1 加载类API#

方法说明
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文件中获取
TradPlus.HideNativeBanner("AdUnitId",false);(可选)隐藏对应的广告。
TradPlus.HideNativeBanner("AdUnitId",true);(可选)展示对应的广告(仅调用隐藏广告之后使用)。
TradPlus.DestroyNativeBanner("AdUnitId");释放资源。
TradPlus.NativeBannerEntryAdScenario("AdUnitId");(可选)进入广告位所在界面时调用。了解更多,请看广告场景的调用时机和用途说明
TradPlus.NativeBannerEntryAdScenario("AdUnitId",adSceneId);(可选)进入广告位所在界面时调用并传入场景ID。

3.2 监听回调API#

  • 广告位维度回调监听 V6.4.5新增API
方法参数说明
TradPlusManager.OnNativeBannerAdLoadedstring tpAdInfo , string height广告加载成功。
TradPlusManager.OnNativeBannerAdLoadFailedstring adUnitId ,string errorMsg广告加载失败。
TradPlusManager.OnNativeBannerAdClickedstring tpAdInfo广告被点击。
TradPlusManager.OnNativeBannerAdImpressionstring tpAdInfo广告展示。
TradPlusManager.OnNativeBannerAdClosedstring tpAdInfo广告被关闭。
TradPlusManager.OnNativeBannerAdShowFailedstring tpAdInfo ,string errorMsgV7.3.0新增API。广告展示失败。
  • 广告源维度回调监听 (可选) V6.4.5新增API
方法参数说明
TradPlusManager.OnNativeBannerAdAllLoadedbool isSuccess,string adUnitId广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。
TradPlusManager.OneNativeBannerLayerLoadFailedstring tpAdInfo ,string errorMsg配置多个广告源,每个广告源加载失败后会都会回调一次。
TradPlusManager.OneNativeBannerLayerLoadedstring tpAdInfo配置多个广告源,每个广告源加载成功后会都会回调一次。
TradPlusManager.OneNativeBannerLayerStartLoadstring tpAdInfo每层waterfall 向三方广告源发起请求前,触发的回调。
V7.9.0 新增回调
TradPlusManager.OnNativeBannerAdStartLoadstring adUnitId每次调用load方法时返回的回调,包含自动加载等触发时机。
V7.9.0 新增回调
TradPlusManager.OnNativeBannerBiddingStartstring tpAdInfoBidding开始加载。
TradPlusManager.OnNativeBannerBiddingEndstring tpAdInfo ,string errorMsgBidding加载完成。
V7.3.0新增回调参数 errorMsg